Context Hygiene — Règle fondamentale du brain

Décision architecturale — session 2026-03-13 Voir aussi brain/profil/memory-architecture.md — les trois pilliers (TTL, Sectionnarisation, Stratification)

Règle dure

Jamais charger tout le système au démarrage. Jamais.

Le brain est conçu pour un chargement sélectif et progressif. Charger tous les agents en début de session = dilution de l'attention + tokens gaspillés + réponses moins précises.

Ce qui est chargé au démarrage — toujours

Fichier	Taille cible	Pourquoi universel
`CLAUDE.md`	< 100 lignes	Bootstrap — instructions globales
`focus.md`	< 120 lignes	État actuel des projets
`profil/collaboration.md`	< 100 lignes	Comment travailler ensemble
`agents/coach.md`	< 220 lignes	Présence permanente — observation en arrière-plan

Total cible démarrage : < 500 lignes (~8-10k tokens). Jamais dépasser.

Ce qui est chargé sur détection — jamais au démarrage

Déclencheur	Ce qui est chargé
Domaine technique détecté	Agent métier correspondant (1-2 max)
Session prod / infra	`profil/objectifs.md` + agent vps ou ci-cd
Fin de session avec patterns	`agents/toolkit-scribe.md`
Fin de session avec bilan	`agents/coach-scribe.md`
Ambiguïté de scope	`agents/interprete.md`
Multi-domaines	`agents/orchestrator.md` → il délègue

Libération de contexte

Quand un domaine de travail est terminé dans la session, ses agents peuvent être libérés :

→ "on passe à autre chose" = l'agent précédent n'est plus actif
→ Charger le nouvel agent, ne pas cumuler sans raison

Le modèle n'oublie pas ce qui a été dit — mais moins de "présence permanente" d'agents inutiles = meilleure précision sur le domaine actif.

Cycle de vie d'un agent — 3 états

État	Condition	Comportement
Actif	Domaine en cours d'acquisition	Chargé sur détection, intervient
Stable	Domaine maîtrisé — peu ou pas d'interventions en session	Disponible sur demande, plus chargé automatiquement
Retraité / Collègue	Domaine acquis — signal de graduation explicite	Référence ponctuelle, ne coache plus, ne persiste plus

Signal de graduation : plusieurs sessions consécutives sans intervention de l'agent = domaine acquis. Le documenter dans progression/milestones/.

Règle de taille des fichiers

Pour que le système reste viable sur la durée :

Fichier	Taille max recommandée
Agent standard	200 lignes
Fichiers profil (collaboration, objectifs)	100 lignes
focus.md	120 lignes
CLAUDE.md	100 lignes (bootstrap only)
Fichier toolkit pattern	60 lignes

Si un fichier dépasse → le scribe compétent le compresse à la prochaine session dédiée.

Application au coach — exemple concret

Phase	État coach	État coach-scribe
Junior actif (maintenant)	Actif — observe, intervient, rapporte	Actif — écrit journal/skills/milestones
Système stable	Stable — chargé sur demande uniquement	En veille — plus de journal actif
Senior / Collègue	Retraité → pair technique, référence	Archivé — `progression/` en lecture seule

Le coach devient collègue quand il n'a plus rien à corriger. C'est le meilleur signal de progression possible.

Changelog

Date	Changement
2026-03-13	Création — cycle de vie agents, règle démarrage minimal, libération contexte

3.7 KiB Raw Blame History