Skip to content
Floskool

Chapter 4 · Chapitre 4 · Optimiser ses instructions

4.4 Limiter les informations inutiles et améliorer progressivement

Free lesson 5 minGroup Claude Code & IA

Follow this course in your space: your progress is saved, and the community answers your questions.

Follow for free

Un 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/ avec paths.
  • 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

Le cycle d'amélioration d'un CLAUDE.md

  1. Écris une règle précise.
  2. Vérifie qu'elle est chargée (/context, /memory).
  3. Teste avec une vraie demande, dans une nouvelle session.
  4. 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 :

  • /clear entre deux tâches sans rapport (la vidéo 12 est finie, tu passes au site) ;
  • /compact avec une consigne avant une longue tâche, pour garder l'essentiel ;
  • /context de 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.
  • /clear entre deux tâches, /compact avant une longue tâche.
  • Un ménage par mois, sous 200 lignes.