Aller au contenu

Exemples

Page générée — ne pas éditer

Rendue au build par scripts/gen_doc_reference.py, depuis registry/blueprints/*.blueprint.json. Une modification manuelle serait perdue au build suivant.

Ce sont les blueprints réellement publiés avec le kit, pas des extraits écrits pour la documentation. Les diagrammes sont dérivés des fichiers : ils ne peuvent pas montrer autre chose que ce qui s'y trouve.

Chacun est vérifié par la suite de tests comme n'importe quel blueprint — un exemple qui cesserait de valider casserait le build.

Minimal blueprint

The smallest valid v1 blueprint: one catalogue pattern node, no edges, no extension dependency. blueprintVersion must be the integer 1; id must be lowercase-with-hyphens; nodes must be non-empty; edges must be present (an empty list is fine). Every node carries a pins key, even empty: without it the file is treated as a Studio draft and re-projected.

minimal — 1 node(s), 0 edge(s).

flowchart LR
    n_orchestrate["Orchestrator<br/><small>ORC-01</small>"]
kind présents pattern
Contrats échangés —

L'essayer. Repartez d'un squelette équivalent, puis divergez :

grimoire blueprint new minimal-essai --template minimal

Ou ouvrez l'atelier — il faut avoir lancé grimoire serve : http://127.0.0.1:4173/blueprints.html

Project upgrade

Mettre à jour un projet Grimoire est un flow, pas un up nu (issue #490) : sauvegarde -> aperçu -> orphelins -> application -> deux nœuds de jugement qui ne font que proposer (overrides en dérive, mémoire non raccordée) -> besoins/hôtes non déclarés -> vérification -> point de passage humain forcé pour tout ce qui retirerait quelque chose. orphans avant apply, jamais l'inverse : la migration réelle du 2026-09-11 a montré que grimoire up/host sync refusent (garde de distinction) tant qu'un agent orphelin partage encore le faisceau d'un agent courant — les orphelins doivent être archivés avant que up tourne, pas après. Chaque nœud V0 porte une acceptance structurée exécutée par grimoire upgrade-flow check <node> ; les nœuds V1 (overrides, memory, needs-hosts) écrivent des propositions via le mécanisme proposals existant et n'appliquent jamais rien eux-mêmes.

project-upgrade — 9 node(s), 8 edge(s).

flowchart LR
    n_backup["Sauvegarde<br/><small>RUN-14</small>"]
    n_preview["Aperçu<br/><small>GOV-02</small>"]
    n_orphans["Orphelins<br/><small>KNO-01</small>"]
    n_apply["Application<br/><small>RUN-13</small>"]
    n_overrides["Overrides en dérive (proposition)<br/><small>QUA-15</small>"]
    n_memory["Mémoire non raccordée (proposition)<br/><small>KNO-04</small>"]
    n_needs_hosts["Besoins et hôtes<br/><small>RUN-08</small>"]
    n_verify["Vérification<br/><small>QUA-04</small>"]
    n_destructive["Retrait — toujours un refus tracé"]
    n_backup -->|upgrade-backed-up| n_preview
    n_preview -->|upgrade-previewed| n_orphans
    n_orphans -->|upgrade-orphans-archived| n_apply
    n_apply -->|upgrade-applied| n_overrides
    n_overrides -->|upgrade-overrides-proposed| n_memory
    n_memory -->|upgrade-memory-proposed| n_needs_hosts
    n_needs_hosts -->|upgrade-needs-hosts-proposed| n_verify
    n_verify -->|upgrade-verified| n_destructive
kind présents checkpoint, pattern
Contrats échangés upgrade-applied, upgrade-backed-up, upgrade-complete, upgrade-memory-proposed, upgrade-needs-hosts-proposed, upgrade-orphans-archived, upgrade-overrides-proposed, upgrade-previewed, upgrade-verified

L'essayer. Repartez d'un squelette équivalent, puis divergez :

grimoire blueprint new project-upgrade-essai --template pipeline

Ou ouvrez l'atelier — il faut avoir lancé grimoire serve : http://127.0.0.1:4173/blueprints.html

Web pipeline

A realistic multi-node flow: an orchestrator pattern plans the mission, a CrewAI crew executes it, a LangGraph state graph refines the result, and an evidence-pack pattern closes the loop. It references extension nodes published in this registry (crewai, langgraph): compiling requires those extensions to be installed in the target project — grimoire blueprint compile lists the exact install command for each missing one.

web-pipeline — 7 node(s), 6 edge(s).

flowchart LR
    n_plan["Plan the mission<br/><small>ORC-01</small>"]
    n_trust["Qualifier les services externes<br/><small>GOV-01</small>"]
    n_crew["CrewAI crew<br/><small>crewai/crewai-crew</small>"]
    n_refine["LangGraph refinement<br/><small>langgraph/langgraph-graph</small>"]
    n_guard["Filtrer le retour externe<br/><small>GOV-01</small>"]
    n_verify["Evidence pack<br/><small>QUA-04</small>"]
    n_guard_out["Filtrer la sortie<br/><small>GOV-01</small>"]
    n_plan -->|task-envelope| n_trust
    n_trust -->|task-envelope| n_crew
    n_crew -->|handoff-packet| n_refine
    n_refine -->|handoff-packet| n_guard
    n_guard -->|handoff-packet| n_verify
    n_verify -->|evidence-pack| n_guard_out
kind présents extension-node, pattern
Contrats échangés evidence-pack, handoff-packet, task-envelope

Extensions requises

Ce flow ne compile pas tant que ces extensions ne sont pas installées : crewai, langgraph.

L'essayer. Repartez d'un squelette équivalent, puis divergez :

grimoire blueprint new web-pipeline-essai --template pipeline

Ou ouvrez l'atelier — il faut avoir lancé grimoire serve : http://127.0.0.1:4173/blueprints.html