brain-template/wiki/session-lifecycle.md

Brain — Cycle de vie d'une session

Ce qui se passe du premier message au dernier commit.

---

Boot (automatique)

Message utilisateur
    ↓
CLAUDE.md charge :
  0. PATHS.md              — chemins machine
  1. collaboration.md      — règles de travail
  2. coach.md              — présence permanente
  3. secrets-guardian.md   — écoute passive MYSECRETS
  4. helloWorld.md         — briefing + CHECKPOINT + détection session

helloWorld → ouvre claim BSI + push immédiat
    ↓
session-orchestrator reçoit le handoff :
  → détecte session_type + scope
  → détermine handoff_level (NO / SEMI / SEMI+ / FULL)
  → charge les couches correspondantes
  → active la position (rôle contextuel)

Handoff levels :

Level	Contexte chargé
NO	Layer 0 seulement (kernel + constitution + paths + collaboration)
SEMI	Layer 0 + position
SEMI+	SEMI + focus.md + projets/ + todo/
FULL	SEMI+ + Layer 2 : workspace actif + handoffs

---

Work

• Agents invoqués sur domaine détecté (auto) ou sur demande explicite
• /btw disponible à tout moment pour aparté sans casser le fil
• /checkpoint recommandé avant compactage ou si sprint > 2h

---

Close — séquence obligatoire

Déclenchée par : fin | on wrappe | je ferme | c'est bon Source de vérité close sequences par type : wiki/session-matrix.md Decision tree runtime : agents/session-orchestrator.md ## boot-summary

Étape 0 — Checkpoint (si sprint actif)
  → Écrire workspace/<sprint>/checkpoint.md
  → Permet warm restart à la prochaine session

Étape 1 — metabolism-scribe  ← TOUJOURS (15 types)
  → tokens_used, context_peak, duration, agents_loaded
  → commits, todos_closed, health_score (formule par profil), handoff_level
  → type : use-brain | build-brain | explore-brain | auto

Étape 2 — todo-scribe  ← RÈGLE INVIOLABLE
  → Tout item complété pendant la session → [x] dans backlog.md
  → Mettre à jour la table métriques (✅ Done +N, ⬜ Open -N)
  → Si aucun item fermé → écrire pourquoi dans changelog backlog
  → Commit : "backlog: close <item-id> — <titre court>"

Étape 3 — todo-scribe  [si work | sprint | debug | brainstorm]
  → ✅ todos fermés
  → ⬜ todos émergés capturés

Étape 4 — wiki-scribe  [si nouveau pattern/commande/agent forgé]
  → Ajouter terme dans vocabulary.md
  → Créer/mettre à jour la page wiki concernée
  → Commit : "wiki: vocabulary +N terms — <domaine>"

Étape 5 — scribe  [si session significative]
  → brain/ : focus, projets/, AGENTS si nouvel agent

Étape 6 — coach  [rapport de session — si coach actif]
  ⚡ Rapport de session — <sess-id>
     Ce qui a été produit : <liste concrète>
     Pattern observé      : <observation — 1 ligne>
     Point à ancrer       : <concept ou réflexe>
     Objectif suivant     : <1 action concrète mesurable>
  → BLOCKING — attend réponse ou /exit

Étape 7 — BSI close claim  ← NON NÉGOCIABLE
  → status: open → closed dans claims/<sess-id>.yml
  → git commit + push brain/
  → rm session-role + pid

Close sequences par type de session

Type	Sequence (etapes actives)
audit	1 (metabolism) → rapport audit → 7 (BSI close)
brain	1 → 5 (scribe) → 6 (coach) → 7
brainstorm	1 → 3 (todo si todos emerges) → 7
capital	1 → capital-scribe → 6 (coach) → 7
coach	1 → coach-scribe → 7
debug	1 → 2 + 3 (todo) → 6 (coach) → 7
deploy	1 → 5 (scribe infra) → 7
edit-brain	1 → 5 (scribe) → 6 (coach) → 7
handoff	1 → 7
infra	1 → 5 (scribe si changement config) → 7
kernel	1 → 7
navigate	1 → 7
pilote	1 → 4 (wiki) → 5 (scribe) → 6 (coach) → 7
urgence	1 → post-mortem scribe → 7
work	1 → 2 + 3 (todo) → 5 (scribe si commit) → 6 (coach) → 7

---

Règle inviolable backlog (étape 2)

Sans cette règle, le backlog devient un cimetière de todos. La métrique de vélocité reste à zéro.

Ce qui est obligatoire :

• Chaque item touché pendant la session → [x] si terminé, note si partiel
• Table métriques recalculée avant le commit
• Un commit backlog: close ... par item fermé (ou un commit groupé si plusieurs)

Ce qui est interdit :

• Fermer la session sans avoir vérifié le backlog
• Marquer [x] un item non terminé (intégrité des métriques)

---

Warm restart (Pattern 8)

Si la session se poursuit après compactage ou reprise :

Lis brain/workspace/<sprint>/checkpoint.md et reprends — pas de bootstrap complet.

Cold bootstrap : 2-3 min — Warm restart : < 30 sec.