Comment prévenir la dégradation de CLAUDE.md : Traiter les règles comme du code

Après 18 mois à utiliser Claude Code sur des projets en production, u/mm_cm_m_km a identifié le point de défaillance le plus courant : le fichier CLAUDE.md se dégrade. Non pas parce que Claude l'ignore, mais parce que les développeurs ne cessent d'ajouter des règles sans jamais les nettoyer. Le résultat est un fichier boursouflé de 500 lignes qui coûte des tokens à chaque tour et se désynchronise de la base de code réelle.

1. CLAUDE.md comme un index, pas un manuel

Gardez CLAUDE.md entre 30 et 50 lignes. Il doit servir de table des matières pointant vers des fichiers spécifiques pour des préoccupations spécifiques — pas un mur de toutes les préférences que vous avez jamais définies. Claude relit le fichier à chaque tour ; les fichiers courts sont économiques, les longs gaspillent des tokens et de l'attention.

2. Chaque section répond à l'une des deux questions

• Quel comportement voulez-vous ? (la règle) — est dans CLAUDE.md.
• Où trouvez-vous la vérité actuelle ? (la source) — est une URL accessible ou un chemin de fichier que Claude peut relire au moment de la tâche.

Mélanger règles et sources est la raison pour laquelle les fichiers grossissent sans limite. Gardez la règle courte, la source externe.

3. Auditer avant la fusion, pas après

Les règles dérivent silencieusement lorsque vous renommez des éléments, refactorisez des hooks ou abandonnez des fonctionnalités. La solution n'est pas « être plus prudent » — c'est une étape CI. L'auteur a créé une application GitHub appelée agentlint (agentlint.net) qui audite la surface des règles à chaque PR : contradictions entre fichiers, références à des chemins supprimés, règles décrivant des fonctionnalités de harnais que votre version ne supporte pas.

4. Supprimez plus que vous n'ajoutez

Presque tous les CLAUDE.md gagnent une nouvelle règle par semaine et n'en suppriment aucune. Après six mois, vous avez un Frankenstein. La discipline : pour chaque nouvelle règle, trouvez-en une à supprimer. Cela a permis à l'auteur de garder son fichier sous 100 lignes.

Le schéma de base : traitez votre surface de règles comme du code. Le code a des tests, des revues et une détection de dérive. Les règles ont besoin de la même chose.