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.
📖 Lire la source complète : r/ClaudeAI
👀 See Also
Claude Code Mode sans interface avec l'indicateur --print
Claude Code peut fonctionner en mode sans interface graphique en utilisant l'option --print, permettant d'envoyer des instructions via des pipelines pour obtenir des résultats automatisés sans sessions interactives. Cela permet une intégration dans des pipelines CI/CD, des hooks Git et des scripts bash.
Gérer la fenêtre de contexte de code de Claude pour optimiser les coûts et les performances
Un développeur explique que chaque appel API envoie l'intégralité de l'historique de la conversation, ce qui rend l'historique accumulé la partie coûteuse, et partage une méthode de travail consistant à démarrer de nouvelles sessions avec des notes de relais pour réduire les coûts et améliorer la qualité des réponses.
Claude Prompt pour Visualiser la Structure de la Pensée : Intention, Réalité, Écart
Un utilisateur de Reddit partage une invite de 100 mots pour Claude qui demande à l'IA de remarquer et de refléter les schémas structurels de la conversation — catégorisés en Intention (ce que vous VOULEZ), Réalité (ce qui EST) et Écart (ce qui est NON RÉSOLU) — plutôt que le contenu lui-même.
Quatre fichiers locaux pour maintenir le contexte de Claude dans les projets longs
Un utilisateur de Reddit recommande de maintenir quatre fichiers Markdown—claude.md, memory.md, restart.md et backlog.md—comme mémoire externe pour Claude afin de contrer la compression de la fenêtre de contexte dans les conversations prolongées.