franalgaba/grimoire

Installez et utilisez Grimoire, rédigez des fichiers .spell avec une couverture syntaxique complète (y compris la logique de décision consultative), et exécutez en toute sécurité les commandes compile/validate/simulate/cast. Utilisez cette compétence lorsque les utilisateurs demandent à créer, modifier, déboguer, valider, simuler, exécuter ou expliquer des stratégies Grimoire.

Qu'est-ce que grimoire ?

La compétence franalgaba/grimoire permet aux agents IA d'installer, de configurer et d'utiliser Grimoire, un outil en ligne de commande conçu pour gérer des stratégies décisionnelles complexes via des fichiers `.spell`. Elle couvre l'intégralité de la syntaxe de ces fichiers, y compris la logique de décision consultative (advisory decision logic). Cette compétence est utile pour les développeurs et les utilisateurs d'agents IA travaillant sur des processus décisionnels automatisés ou des stratégies programmables. Elle prend en charge les systèmes Unix (Linux, macOS) et nécessite Node.js pour l'installation. Le fonctionnement inclut les commandes principales : `compile` (compilation des fichiers .spell), `validate` (validation syntaxique et logique), `simulate` (simulation de l'exécution) et `cast` (exécution en production). En automatisant ces étapes, la compétence réduit les erreurs humaines et accélère le cycle de développement des stratégies. Elle est particulièrement adaptée aux agents comme Claude Code ou Cursor, qui peuvent orchestrer ces actions de manière sécurisée et reproductible.

Compatible avec~Claude Code~Codex CLI~Cursor

npx skills add https://github.com/franalgaba/grimoire/tree/main/skills/grimoire

Documentation

Que fait grimoire ?

Installez et utilisez Grimoire, rédigez des fichiers .spell avec une couverture syntaxique complète (y compris la logique de décision consultative), et exécutez en toute sécurité les commandes compile/validate/simulate/cast. Utilisez cette compétence lorsque les utilisateurs demandent à créer, modifier, déboguer, valider, simuler, exécuter ou expliquer des stratégies Grimoire.

Installation

Assurez-vous d'avoir Node.js installé (version 16 ou ultérieure). Installez Grimoire globalement via npm :

npm install -g @franalgaba/grimoire

Vérifiez l'installation :

grimoire --version

Utilisation

Créer un fichier `.spell`

Les fichiers .spell définissent une stratégie. Voici un exemple simple avec la logique de décision consultative :

# strategy.spell
name: "Stratégie d'approbation"
version: 1.0
advisory: true
decisions:
  - if: user.role == 'admin'
    then: approve
  - if: user.risk_score < 50
    then: approve_with_review
  - else: reject

Valider un fichier `.spell`

grimoire validate strategy.spell

Compiler un fichier `.spell`

grimoire compile strategy.spell

Simuler l'exécution

grimoire simulate strategy.spell --input "data.json"

Exécuter (caster) en production

grimoire cast strategy.spell --input "data.json" --mode production

Syntaxe complète du fichier `.spell`

Élément	Description
`name`	Nom de la stratégie (chaîne)
`version`	Numéro de version (flottant)
`advisory`	Booléen (true/false) activant la logique consultative
`decisions`	Tableau de règles conditionnelles (`if ... then ... else ...`)
`variables`	Définitions de variables réutilisables (optionnel)
`meta`	Métadonnées personnalisées (optionnel)

Logique de décision consultative

Lorsque advisory: true, la stratégie ne s'exécute pas en mode bloquant ; elle retourne des recommandations. Chaque décision peut être marquée avec un niveau d'importance :

decisions:
  - if: transaction.amount > 10000
    then: flag_for_review
    advisory_priority: high
  - if: transaction.amount < 100
    then: auto_approve
    advisory_priority: low

Dépannage

Erreur de syntaxe : Vérifiez l'indentation YAML et les guillemets autour des chaînes.
Dépendances manquantes : Réexécutez npm install -g @franalgaba/grimoire.
Version obsolète : Mettez à jour avec npm update -g @franalgaba/grimoire.

Sécurité

Ne castez jamais une stratégie non validée.
Utilisez validate et simulate avant cast.
Les variables d'environnement dans les fichiers .spell (par exemple ${API_KEY}) doivent être définies en toute sécurité.