Auditer et dégraisser le CLAUDE.md d'un projet
Un CLAUDE.md grossit à chaque session et finit par coûter plus de contexte qu'il n'en fait gagner. Cette skill l'audite ligne par ligne, sépare ce qui oriente vraiment l'agent de ce qui duplique le code, et propose une version dégraissée — ou en crée un depuis zéro.
INSTALLER
mkdir -p ~/.claude/skills/audit-contexte && curl -fsSL https://reversed.ch/ressources/audit-contexte.md -o ~/.claude/skills/audit-contexte/SKILL.md
LANCER
/audit-contexte
CE QUE ÇA PRODUIT
Un rapport de ce qui est solide, ce qui doit être corrigé, et les lignes à supprimer
Le CLAUDE.md est le fichier le plus lu de votre projet : il est chargé au début de chaque session, avant toute autre chose. C'est aussi celui qu'on écrit une fois et qu'on n'ouvre plus jamais.
Le résultat est prévisible. Il grossit, accumule des instructions périmées, duplique ce que le code dit déjà, et finit par coûter plus de contexte qu'il n'en fait gagner. Pire : quand il contient une information fausse, l'agent la suit.
Le principe : la carte, pas l'entrepôt
Un bon CLAUDE.md ne raconte pas ce que le code peut dire lui-même. Il dit où regarder, ce qui est décidé, et ce qu'il ne faut surtout pas faire. Tout le reste est du poids mort — l'agent lit le code de toute façon.
- Garder : navigation, conventions non déductibles, décisions gravées, commandes de déploiement, pièges connus
- Supprimer : descriptions de fonctions, arborescences que `ls` donne, historique des changements, tout ce que git sait
- Corriger : les instructions devenues fausses — les plus coûteuses, parce qu'elles sont suivies
La méthode derrière
L'audit passe chaque section au même test : « si je supprime ces lignes, l'agent fait-il une erreur qu'il n'aurait pas faite sinon ? » Si la réponse est non, les lignes partent. Ce test est plus sévère qu'il n'y paraît — il élimine généralement entre un tiers et la moitié d'un fichier mature.
La skill fonctionne aussi en création : à partir d'un dépôt existant, elle produit un premier CLAUDE.md qui tient sur une page et couvre ce qui compte.
- Ça marche avec AGENTS.md ou d'autres formats ?
- Oui. Le format change, le principe non : un fichier de contexte chargé à chaque session doit être une carte. La skill traite les équivalents de la même manière.
- Quelle longueur viser ?
- Il n'y a pas de chiffre magique, mais un bon indicateur : si vous ne pouvez pas le relire en entier en deux minutes, il contient probablement des choses que le code dit déjà.
- Et si mon projet est vraiment complexe ?
- Alors le CLAUDE.md racine pointe vers des fichiers par sous-projet, plutôt que de tout absorber. La complexité se répartit, elle ne se concentre pas dans le fichier le plus lu.
MIS À JOUR LE 2026-07-26
On peut le faire tourner sur votre contexte.
L'outil est gratuit et il fonctionne seul. Si vous voulez qu'on regarde votre situation avec vous, on prend trente minutes.
Parler à un humain