Scribe System — Cartographie officielle du Scribe Pattern

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/` futur)	Universel	✅ structure	Stable quand todo en régime
`toolkit-scribe`	`toolkit/`	`toolkit/`	Universel	✅	Actif tant que nouveaux patterns
`git-analyst`	Commits git (narration sémantique)	Tous repos	Universel	✅	Ponctuel — invoqué sur demande
`coach-scribe`	`journal/`, `skills/`, `milestones/`	`progression/`	Personnel	❌	Suit le coach — retraité ensemble
`capital-scribe`	`profil/capital.md`	`brain/`	Personnel	❌ strippé	Suit objectifs — veille quand CV stabilisé

helloWorld et coach ne sont pas des scribes — ils observent et rapportent, jamais n'écrivent.

Ordre canonique de fin de session

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

1. todo-scribe    → commit brain/  "todo(<domaine>): <intention>"
2. capital-scribe → commit brain/  "feat(capital): <milestone>"     si signal reçu
3. scribe         → commit brain/  "feat(brain): <bilan session>"    toujours en dernier sur brain/
4. toolkit-scribe → commit toolkit/ "feat(toolkit): <pattern>"       si signal reçu
5. coach-scribe   → commit progression/ "feat(progression): <bilan>" si session coach
6. 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

4.2 KiB Raw Blame History