scribe: propagation sess-20260315-0200-quick-wins — +coach, architecture-scribe, ADRs 001-007, commit/todo-context

profil/commit-context.md

@@ -0,0 +1,89 @@
+# commit-context.md — Règles commits sémantiques
+
+> **Type :** Invariant — règles d'écriture git du brain
+> Rédigé : 2026-03-15
+> Propriétaire : scribe (brain/), scribes satellites pour leurs repos
+> Source de vérité pour : tous les agents qui commitent
+
+---
+
+## Problème résolu
+
+Sans règle formalisée, les messages de commit dérivent. En 10 sessions : `update`, `fix`, `misc`, `wip`. L'historique devient illisible. Les ADRs ne peuvent pas être détectés automatiquement. L'architecture-scribe n'a pas de matière.
+
+---
+
+## Types de commits — convention
+
+Voir aussi `KERNEL.md ## Commit types` pour le mapping zone → scribe → type.
+
+| Type | Zone | Usage | Exemple |
+|------|------|-------|---------|
+| `kernel:` | KERNEL | Modification contrat fondateur | `kernel: KERNEL.md — zones typées` |
+| `feat:` | KERNEL agents/ | Nouvelle capacité, nouvel agent | `feat: architecture-scribe — pipeline ADR` |
+| `fix:` | KERNEL agents/ | Correction comportement ou bug | `fix: brain-bot — filter open claims only` |
+| `bsi:` | BRAIN-INDEX | Open/close claim, signal | `bsi: open claim sess-XXX` |
+| `scribe:` | INSTANCE + profil/ | brain update (focus, projets, profil) | `scribe: focus.md — Sprint 2 ✅` |
+| `metabolism:` | progression/ | Métriques session | `metabolism: sess-XXX — health 1.07` |
+| `todo:` | todo/ | Intentions fermées/ouvertes | `todo: VITAL contexts/ ✅, preAlpha todos` |
+| `toolkit:` | toolkit/ | Pattern validé en prod | `toolkit: api-error — status typed` |
+| `config:` | INSTANCE | PATHS, compose, machine config | `config: PATHS.md — machine laptop` |
+
+---
+
+## Règles
+
+**1. Un commit = une intention**
+Ne jamais mélanger types dans un commit. `feat:` + `fix:` = deux commits.
+
+**2. Message : action concrète, pas description**
+```
+✅  feat: session-orchestrator — lifecycle boot 4 couches + close séquencé
+❌  feat: update session orchestrator file
+```
+
+**3. Scope optionnel entre parenthèses**
+```
+feat(agents): architecture-scribe — pipeline git-analyst → ADR
+fix(bot): filter claims by open status — was showing 11 instead of 2
+```
+
+**4. `bsi:` est non négociable**
+Tout open/close claim = commit `bsi:` immédiat + push. Sans push, VPS aveugle.
+
+**5. Satellites commitent dans leur repo**
+`scribe:` sur brain/ ne commit pas dans profil/. Chaque scribe = son repo.
+
+**6. Preuve d'écriture = git blame**
+Le commit message doit permettre à `architecture-scribe` de détecter si une décision architecturale a été prise. Être explicite sur le "pourquoi" dans le message.
+
+---
+
+## Ordre de commit canonique (fin de session)
+
+```
+1. bsi: close claim <sess-id>        ← toujours en dernier sur brain/
+2. metabolism: <sess-id>              ← progression/ satellite
+3. todo: <résumé>                     ← todo/ satellite
+4. scribe: focus.md + projets/        ← brain/ (avant bsi close)
+```
+
+Voir `profil/scribe-system.md` pour l'ordre complet multi-satellites.
+
+---
+
+## Trigger de chargement
+
+```
+Propriétaire : tous les scribes
+Trigger      : invocation d'un scribe → charger avant d'écrire
+Section      : Sources au démarrage (scribes) — conditionnel (agents métier si commit requis)
+```
+
+---
+
+## Changelog
+
+| Date | Changement |
+|------|------------|
+| 2026-03-15 | Création — types, règles, ordre canonique, mapping KERNEL.md zones |