Scribe System — Cartographie officielle du Scribe Pattern

Type : Référence Décision architecturale — session 2026-03-13 Complémentaire de memory-integrity.md (règles d'écriture) et context-hygiene.md (chargement)

Le Scribe Pattern

Règle dure — un agent métier n'écrit jamais directement dans le brain.

Agent métier (vps, ci-cd, debug...)
  → observe, produit, détecte
  → signale au scribe compétent
  → le scribe écrit, commite, maintient

Jamais : agent métier → write directement
Toujours : agent métier → signal → scribe compétent → write

Pourquoi : un agent qui écrit directement = scope indéfini = dérive mémoire garantie. Le scribe est le seul responsable de la cohérence de son repo.

Carte des 6 scribes

Scribe	Écrit où	Repo	Couche	Exportable	Cycle de vie
`scribe`	`focus.md`, `projets/`, `infrastructure/`, `agents/AGENTS.md`, `profil/objectifs.md`	`brain/`	Universel	✅	Permanent
`todo-scribe`	`todo/`	`brain-todo/`	Universel	✅ structure	Stable quand todo en régime
`toolkit-scribe`	`toolkit/`	`brain-toolkit/`	Universel	✅	Actif tant que nouveaux patterns
`orchestrator-scribe`	`BRAIN-INDEX.md ## Signals` uniquement	`brain/`	Universel	✅ protocole	Permanent — multi-instance actif
`config-scribe`	`PATHS.md`, `infrastructure/` d'une instance	instance locale	Universel	✅ structure	Invoqué sur `brain-compose new`
`git-analyst`	Commits git (narration sémantique)	Tous repos	Universel	✅	Ponctuel — invoqué sur demande
`coach-scribe`	`journal/`, `skills/`, `milestones/`	`brain-progression/`	Personnel	❌	Suit le coach — retraité ensemble
`capital-scribe`	`profil/capital.md`	`brain-profil/`	Personnel	❌ strippé	Suit objectifs — veille quand CV stabilisé

helloWorld et coach ne sont pas des scribes — ils observent et rapportent, jamais n'écrivent. orchestrator-scribe n'écrit QUE dans ## Signals — jamais dans ## Claims (→ scribe).

Ordre canonique de fin de session

Quand plusieurs scribes écrivent dans la même session :

1. todo-scribe         → commit brain-todo/       "todo(<domaine>): <intention>"
2. toolkit-scribe      → commit brain-toolkit/    "feat(toolkit): <pattern>"        si signal reçu
3. coach-scribe        → commit brain-progression/ "feat(progression): <bilan>"     si session coach
4. capital-scribe      → commit brain-profil/     "feat(capital): <milestone>"      si signal reçu
5. scribe              → commit brain/            "feat(brain): <bilan session>"    toujours en dernier sur brain/
6. orchestrator-scribe → commit brain/            "feat(signals): <signal posé>"    si inter-sessions actives
7. git-analyst         → valide cohérence sémantique des commits                    optionnel

Règle : scribe est toujours le dernier à commiter sur brain/ — il a la vue complète de ce que les autres ont écrit.

Un commit = un scribe = un repo. Voir memory-integrity.md.

Comment un agent métier signale

Format standard de signal en fin d'action :

→ Signal scribe : <ce qui a changé> dans <fichier cible>
  Ex: "Signal scribe : nouveau container openclaw ajouté — mettre à jour brain/infrastructure/vps.md"

→ Signal todo-scribe : <intention de session future>
  Ex: "Signal todo-scribe : ⬜ configurer monitoring pour openclaw"

→ Signal toolkit-scribe : <pattern validé en prod>
  Ex: "Signal toolkit-scribe : pattern vhost reverse proxy validé — candidat toolkit/apache/"

Le scribe reçoit le signal en fin de session et écrit. Il ne demande pas — il déduit du signal.

Chargement conditionnel

Ce fichier est chargé sur trigger — jamais au démarrage.

Agent	Trigger	Pourquoi
`scribe`	Au démarrage	Connaître ses pairs scribes et l'ordre de commit
`recruiter`	Quand il forge un agent qui écrit	Vérifier la déclaration `## Écrit où`
`agent-review`	Review d'un scribe	Grille : scope déclaré ? ordre respecté ?
Tout agent métier	Avant de signaler	Savoir à quel scribe déléguer

Séparation universel / personnel — export

Template public (claude-brain-template) :
  ✅ scribe, todo-scribe, toolkit-scribe, git-analyst

Couche personnelle (strippée à l'export) :
  ❌ coach-scribe, capital-scribe
  ❌ progression/, profil/capital.md

Quelqu'un qui fork récupère le moteur d'écriture. Pas le cerveau, pas la progression, pas le CV.

Changelog

Date	Changement
2026-03-13	Création — émergé de la session agent-review + architecture multi-repos + Scribe Pattern
2026-03-14	Ajout orchestrator-scribe (## Signals) + config-scribe — 8 scribes, repos satellites mis à jour, ordre de commit v2

4.9 KiB Raw Blame History