Hygiène de session avec Gandalf

Contexte

Gandalf est le gardien du contexte. Il monitore l’utilisation du contexte, applique la règle 50%, rappelle les bonnes pratiques LLM et prévient le context rot. À invoquer régulièrement pour maintenir la discipline de session et éviter les oublis soudains.

Prérequis

Session Claude Code active
Conscience basique du pourcentage de contexte utilisé
Au moins une tâche définie dans docs/todo.md

Étapes

1. Lancer le health check

/ulk:gandalf

Gandalf pose des questions de contexte :

🧙 GANDALF - Health Check

Comment se passe cette session ?

1. Contexte : Tu as une idée du % utilisé ?
   - < 30% : Zone verte
   - 30-50% : Zone orange (attention)
   - > 50% : Zone rouge (action requise)

2. Focus : C'est quoi la tâche en cours ?
   - Une seule tâche bien définie
   - Plusieurs tâches mélangées
   - Je sais plus trop...

3. État externe : Où est persiste ton avancement ?
   - Issue tracker (GitHub/Linear)
   - Fichier markdown (docs/todo.md)
   - Nulle part (tout dans le contexte)

4. Symptômes : Tu observes des problèmes ?
   - Claude oublie des choses déjà discutées
   - Les réponses deviennent génériques
   - Répétitions inutiles
   - Tout va bien

2. Interpréter les recommendations

Gandalf retourne :

🧙 Diagnostic: Zone orange (45% contexte)

✅ Ce qui va bien:
  - Tâche bien définie (#15)
  - Avancement persisté dans docs/todo.md
  - Pas d'oublis détectés

⚠️ Attention:
  - Contexte à 45% (approche limite)
  - 1-2 fichiers explorés non pertinents en mémoire

🚨 Recommandations:
  1. Avant d'ajouter de la complexité → /clear
  2. Persiste tes notes dans docs/notes.md
  3. Utilise subagents pour exploration future

3. Appliquer les recommandations

Si contexte > 50% :

/clear

Puis rappelle ton contexte au début de la nouvelle session :

Travailler sur #15. Contexte: docs/todo.md, docs/spec.md, CLAUDE.md.

Si contexte 30-50% (orange) :

# Persiste l'état courant
echo "## Session Notes
En cours: #15 - Dashboard
Prochaine: #16 - Analytics
Bloquants: aucun
" > docs/notes.md

4. Pratiques Gandalf recommandées

La 50% Rule :

Jamais dépasser 50% de contexte et s’attendre à des bons résultats
À 50% : context rot commence (oublis soudains)
À 40% : zone d’alerte, préparer un /clear

One Session = One Task :

Ne pas chaîner tâches non-reliées
Si tu switches de tâche → /clear d’abord

Persister avant /clear :

- [ ] Changes committed
- [ ] Issue/todo updated
- [ ] Next steps documented

Subagents pour exploration : Utilise des subagents (Godspeed, Robocop) pour explorer sans polluer le contexte principal.

Exemple de rapport complet

🧙 GANDALF - Session Health Report

📊 Métrique contexte: 38% (VERT)
🎯 Focus: 1 tâche (#15 - Dashboard)
💾 État persisté: docs/todo.md, docs/spec.md
🔄 Dernière synchro: 2 min

✅ Symptômes positifs:
  - Cohérence des réponses
  - Pas de répétitions
  - Mémorisation des décisions

⚠️ Zones d'attention:
  - 3 fichiers explorés (keep only 1-2 clés)

💡 Next checkpoint: 50% contexte ou après #15 complétée

Variantes

Quick status : gandalf status pour juste avoir le % et l’alerte
Save protocol : gandalf save pour guide de persistence
Rules reminder : gandalf rules pour relire les bonnes pratiques

Commandes rapides Gandalf

Commande	Résultat
`gandalf`	Health check complet
`gandalf status`	% contexte + alerte simple
`gandalf save`	Guide persistence avant /clear
`gandalf rules`	Affiche session-practices.md

Troubleshooting

Symptôme	Cause probable	Résolution
Oublis soudains	Contexte > 50%	Lancer `/clear` immédiatement
Réponses génériques	Context rot avancé	Persister state, /clear, revenir
Ne sais pas où en est-tu	Pas de persistence	Créer docs/todo.md, docs/notes.md

Voir aussi

.claude/rules/session-practices.md — Bonnes pratiques détaillées
26-2b3-checkpoint.md — Fin de session propre
25-godspeed-diagnostic.md — Diagnostic initial