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

## ⬜ <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

3.2 KiB Raw Blame History