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

This commit is contained in:
2026-03-14 21:46:06 +01:00
parent 709fb2cce8
commit 0de25ef3e2
12 changed files with 830 additions and 2 deletions

115
profil/todo-context.md Normal file
View File

@@ -0,0 +1,115 @@
# todo-context.md — Workflow et lifecycle des todos
> **Type :** Invariant — règles du système todo du brain
> Rédigé : 2026-03-15
> Propriétaire : todo-scribe
> Source de vérité pour : tout agent qui lit ou écrit dans todo/
---
## Problème résolu
Sans règle formalisée, les todos s'accumulent, ne se ferment jamais, ou se ferment silencieusement sans trace. En 20 sessions : liste ingérable, perte de contexte sur pourquoi un todo existe.
---
## Convention todo
### Statuts
| Symbole | Sens | Qui peut changer |
|---------|------|-----------------|
| `⬜` | Ouvert — à faire | todo-scribe sur signal |
| `✅` | Fermé — livré | todo-scribe sur confirmation humaine |
| `🔄` | En cours — session active dessus | session-orchestrator au boot |
| `⏸` | Suspendu — bloqué ou déprioritisé | Décision humaine |
| `❌` | Annulé — ne sera pas fait | Décision humaine + raison documentée |
### Format d'un todo
```markdown
## ⬜ <Titre court — verbe + sujet>
> Capturé : YYYY-MM-DD — <contexte de capture>
> Priorité : haute | moyenne | basse
> Dépend de : <autre todo ou prérequis si applicable>
**L'intention :**
<Pourquoi ce todo existe. Le problème qu'il résout.>
**Implémentation :**
1. <étape concrète>
2. <étape concrète>
```
---
## Lifecycle d'un todo
```
Émergé en session → capturé par todo-scribe (⬜)
→ Session dédiée → todo passe 🔄
→ Livré → todo-scribe ferme ✅ + commit todo:
→ Bloqué → ⏸ + raison documentée
→ Décision de ne pas faire → ❌ + raison
```
**Règle d'or :** un todo fermé n'est jamais supprimé — il passe ✅. L'historique est une mémoire.
---
## Règles
**1. Capture immédiate**
Un todo émergé en session = capturé avant la fin de session. Pas "je me souviendrai".
**2. Un todo = une intention atomique**
Si un todo nécessite 5 sessions → le décomposer en sous-todos liés.
**3. Titre = verbe d'action**
```
✅ ## ⬜ Forger agent architecture-scribe
❌ ## ⬜ architecture-scribe
```
**4. Priorité explicite**
Haute = bloque autre chose ou fort impact immédiat.
Moyenne = important mais pas urgent.
Basse = nice-to-have, ne pas planifier.
**5. Ne pas fermer sans livrable**
`✅` = quelque chose a été produit, commité, poussé. Pas juste "on en a parlé".
**6. Débat interdit dans todo/**
Les todos capturent des intentions, pas des discussions. Le débat va dans une session brainstorm ou un ADR.
---
## Todos et KERNEL.md zones
| Todo concerne | Zone | Commit type à la fermeture |
|--------------|------|---------------------------|
| Nouvel agent | KERNEL agents/ | `feat:` |
| Patch agent | KERNEL agents/ | `fix:` |
| Profil/spec | KERNEL profil/ | `scribe:` ou `kernel:` |
| Focus/projet | INSTANCE | `scribe:` |
| Pattern toolkit | SATELLITES | `toolkit:` |
| Vision produit | ADR → decisions/ | `kernel:` |
---
## Trigger de chargement
```
Propriétaire : todo-scribe
Trigger : invocation todo-scribe → charger avant lecture/écriture
Section : Sources au démarrage (todo-scribe)
```
---
## Changelog
| Date | Changement |
|------|------------|
| 2026-03-15 | Création — statuts, lifecycle, règles, mapping zones |