Checkpoint fin de session avec 2b3

Contexte

2b3 est une routine de fin de session légère et non-interactive. Elle enchaîne 5 étapes sur les fichiers modifiés uniquement : vérification du code (typecheck, lint, tests), mise à jour documentaire incrémentale, mise à jour de la todo, simplification légère, puis commit propre. À lancer avant de fermer l’IDE.

Prérequis

• Fichiers modifiés depuis le dernier commit
• Git configuré avec user name/email (git config user.name et git config user.email)
• Test suite fonctionnelle (optionnel mais recommandé)

Étapes

1. Lancer le checkpoint

/ulk:2b3

Ou via alias :

/ulk:checkpoint

2. Phase 1 - Reconnaissance

2b3 affiche l’état du working tree et l’inventaire des fichiers modifiés.

git status --short
git diff HEAD --stat

Si le working tree est propre → STOP ici.

3. Phase 2 - Vérification du code

Sur les fichiers modifiés uniquement :

• TypeScript typecheck : npx tsc --noEmit
• Lint : ESLint sur les fichiers changés
• Tests impactés seulement
• Détection console.log et secrets

npx tsc --noEmit 2>&1 | head -30
npx eslint <fichiers> --fix

4. Phase 3 - Mise à jour documentation

• Scanne les TODOs (// TODO, ) dans les fichiers changés
• Met à jour docs/todo.md si pertinent
• Ajoute une entrée docs/changelog.md (optionnel)

grep -r "TODO\|FIXME" --include="*.ts" --include="*.tsx" <fichiers>

5. Phase 4 - Commit propre

2b3 génère un message de commit adapté au style du repo (utilise le plugin commit-commands).

/commit "votre message"

Exemple de sortie

🔍 2b3 — Fin de session
Fichiers dans le scope : 5 fichiers
  • src/api/auth.ts
  • src/components/LoginForm.tsx
  • docs/todo.md
  • package.json

Démarrage des 5 étapes...

✅ Phase 1 (Reconnaissance) — DONE
  5 fichiers modifiés, 2 fichiers non-tracked

✅ Phase 2 (Vérification) — DONE
  0 erreurs TypeScript
  2 warnings ESLint (auto-fixed)
  Test suite: ✓ 12 passed

✅ Phase 3 (Docs) — DONE
  TODOs trouvés: 1 (ajouté à todo.md)

✅ Phase 4 (Commit) — DONE
  Commit: feat: auth flow + login form

Session propre ✓

Variantes

• Checkpoint léger : Juste la vérification du code, skip la documentation
• Checkpoint avec PR : Ajoute --push pour créer une PR automatique après commit
• Checkpoint planifié : Via /schedule pour automatiser chaque fin de journée

Agents enchaînés

Flux typique :

• 2b3 (08) checkpoint → Task Runner (04) prochaine tâche
• 2b3 (08) détecte erreur → Robocop (11) fix
• 2b3 (08) commit → Blackemperor (18) mode=release pour PR

Scheduling automatique

Pour automatiser le checkpoint en fin de journée :

/schedule "2b3 — Checkpoint fin de session" --cron "0 18 * * *"

Troubleshooting

Symptôme	Cause probable	Résolution
Vérification bloquée	Tests qui échouent	Lancer d’abord Robocop (11) pour fix
Commit impossible	Git staging vide	Ensure git add sur les fichiers
Docs non mises à jour	docs/todo.md mal formé	Valider la structure kanban/legacy

Voir aussi

• 27-robocop-errorfix.md — Fix des erreurs avant commit
• 25-godspeed-diagnostic.md — État initial du projet
• 29-gandalf-hygiene.md — Monitoring de session