Chapter 4 · Chapitre 4 · Optimiser ses instructions
4.4 Limiter les informations inutiles et améliorer progressivement
Follow this course in your space: your progress is saved, and the community answers your questions.
Follow for freeUn bon CLAUDE.md n'est pas écrit en une fois. Il se construit par petites corrections, et il s'entretient par un ménage régulier.
Ce qui n'a rien à faire dans CLAUDE.md
- Ce que Claude peut découvrir seul en lisant le projet (la liste complète de tes fichiers, par exemple).
- Les longues procédures en plusieurs étapes → un skill.
- Ce qui ne concerne qu'une partie du projet → un CLAUDE.md de sous-dossier ou une règle
.claude/rules/avecpaths. - L'historique (« le 12 mars, on a changé la couleur ») → inutile, garde seulement la règle actuelle.
- Les secrets (clés, mots de passe) → jamais.
Ce qui y a sa place, en revanche : les pièges à éviter, le pourquoi de tes choix, et les conventions qui ne sont pas évidentes.
Améliorer petit à petit

- Écris une règle précise.
- Vérifie qu'elle est chargée (
/context,/memory). - Teste avec une vraie demande, dans une nouvelle session.
- Corrige : précise, retire le flou, supprime les doublons.
Le réflexe qui change tout
Chaque fois que tu corriges Claude sur un point qui reviendra (« la musique est trop forte », « pas de titre sur trois lignes »), demande :
Ajoute cette règle à CLAUDE.md, dans la bonne section, en une ligne précise et vérifiable. Vérifie d'abord qu'il n'existe pas déjà une règle sur ce sujet.
Au bout de quelques semaines, ton fichier devient ton vrai guide de style. La documentation donne les mêmes signaux pour ajouter une règle : Claude refait la même erreur une deuxième fois, ou tu tapes la même correction qu'à la session précédente.
Garder le contexte léger pendant le travail
Un CLAUDE.md court, c'est la moitié du travail. L'autre moitié, c'est la façon dont tu mènes tes sessions :
/clearentre deux tâches sans rapport (la vidéo 12 est finie, tu passes au site) ;/compactavec une consigne avant une longue tâche, pour garder l'essentiel ;/contextde temps en temps pour voir ce qui occupe la place.
Exemple :
/compact garde les règles de style validées aujourd'hui et la liste des vidéos à finir
Et rappelle-toi : après une compaction, le CLAUDE.md à la racine est relu depuis le disque. Une règle découverte en cours de session doit donc être ajoutée au fichier pour survivre.
Le ménage régulier
Une fois par mois, relis ton fichier : supprime ce qui n'est plus vrai, regroupe ce qui se répète, vérifie que tu restes sous 200 lignes. Tu peux t'aider de ce prompt :
Relis CLAUDE.md. Propose : 1) les lignes à supprimer car découvrables en lisant le projet ou plus vraies, 2) les règles à fusionner, 3) les procédures à déplacer dans un skill. Indique le nombre de lignes avant et après. Ne modifie rien sans mon accord.
Si ça coince
- Ton fichier gonfle à chaque correction : tu ajoutes au lieu de remplacer. Demande toujours de vérifier qu'une règle similaire n'existe pas.
- Claude décrit ta liste de fichiers dans CLAUDE.md : supprime-la, il peut la lire lui-même. Garde seulement les dossiers importants et leur rôle.
- Une règle a disparu après un
/compact: elle n'était que dans la conversation. Ajoute-la à CLAUDE.md.
À retenir
- Pas de liste de fichiers, pas d'historique, pas de procédures, pas de secrets.
- Le cycle : écrire, vérifier, tester, corriger.
- Chaque correction qui reviendra devient une règle.
/clearentre deux tâches,/compactavant une longue tâche.- Un ménage par mois, sous 200 lignes.