Hygiène de contexte

Un modèle qui déborde de contexte dérive : réponses génériques, oublis, mauvaises pistes qui polluent tout ce qui suit (context rot). Ulk applique 5 règles pour garder chaque session nette.

1. /rewind au lieu de corriger

Quand le modèle part dans la mauvaise direction, ne le corrigez pas avec un message de plus : la tentative ratée reste dans le contexte. Reculez au dernier point propre et reformulez.

2. /clear en changeant de tâche

Nouvelle tâche = nouvelle session. Le contexte d’un debug frontend n’a rien à faire dans l’implémentation d’une fonctionnalité. Persistez l’état externe (todo, issues) avant de nettoyer.

Le hook --with-session-persist en écrit la part mécanique tout seul — branche, HEAD, fichiers touchés, derniers commits — à la vraie fin de session et avant chaque compactage, et la relit au démarrage suivant. Il ne remplace pas le /handoff qui porte l’intention : il garantit que les faits, eux, ne partent pas avec la session.

3. Les sous-agents ont leur propre contexte

Un sous-agent démarre propre et ne rend que sa synthèse. Le contexte principal reste intact. Déléguez les explorations lourdes dès le départ.

4. /compact proactif à 50–60 %

Le compactage automatique se déclenche vers 80 % — trop tard, la dérive a déjà commencé. Forcez /compact vous-même, avec une instruction claire sur ce qui doit être préservé (décision d’archi, fichiers en cours, bug courant) et ce qui peut être oublié.

Encore faut-il savoir où l’on en est. Le hook --with-compact-threshold mesure l’occupation réelle du contexte — il lit le décompte de tokens de la dernière réponse dans le transcript, ce n’est pas une estimation — et rappelle la règle au franchissement du seuil (55 % par défaut), une fois par palier de 10 %. Au-delà de 80 %, il oriente vers /clear : à ce stade le compactage ne rattrape plus une dérive installée.

5. Verrouiller le préfixe

Ne changez ni de modèle ni de serveur MCP en cours de session : cela invalide le préfixe de cache et force une relecture complète (un cache miss coûte ~10× un hit). Gelez outils et modèle avant la première requête.

La routine mensuelle : /checkup

Aux 5 règles de session s’ajoute une maintenance mensuelle de l’installation : la commande native /checkup (alias de /doctor depuis Claude Code 2.1.202) nettoie les skills, MCP et plugins inutilisés, dédoublonne le CLAUDE.md local du versionné, repère les hooks lents et met Claude Code à jour — en confirmant chaque changement avant de l’appliquer.

À lancer en début de session dédiée, jamais en cours de travail (règle 5 : toute modification de config invalide le préfixe de cache). Le hook update-check d’ulk, installé par défaut, émet le rappel une fois par mois.

L’agent eclusiere surveille ces règles et la skill /context-audit produit un score de santé de 0 à 100.