Ç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.

← ALL TOOLSTOOL · audit-contexte

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.

INSTALL

mkdir -p ~/.claude/skills/audit-contexte && curl -fsSL https://reversed.ch/ressources/audit-contexte.md -o ~/.claude/skills/audit-contexte/SKILL.md

RUN

/audit-contexte

WHAT IT PRODUCES

Un rapport de ce qui est solide, ce qui doit être corrigé, et les lignes à supprimer

VIEW SOURCE FILE →

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.

FREQUENTLY ASKED

Ç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.

UPDATED 2026-07-26

We can run it on your own context.

The tool is free and works on its own. If you'd rather have us look at your situation with you, we'll take thirty minutes.

Talk to a human