1. Pourquoi c'est le meilleur investissement
Sans CLAUDE.md, tu re-briefes Claude à chaque conversation : « réponds en français, va droit au but, voici mon métier… ». Avec, c'est cadré une fois pour toutes. Le retour sur le temps passé est immédiat — c'est le premier truc que je conseille à quiconque démarre.
2. Ce qu'on y met
Quatre familles de choses :
- Ton & format : tutoiement ou vouvoiement, prose ou listes, court ou détaillé.
- Tes conventions : ton métier, tes outils, ton vocabulaire maison.
- Ce que tu ne veux PAS : le jargon vide, les plans en 14 étapes non demandés, la flagornerie…
- Tes pièges : les erreurs déjà rencontrées, transformées en règles. C'est la partie qui a le plus de valeur.
Ton & formatTutoiement, prose ou listes, longueur des réponses.
ConventionsMétier, outils, vocabulaire maison.
InterditsJargon vide, plans non demandés, flagornerie.
Pièges → règlesLes erreurs rencontrées, gravées en règles. La partie la plus précieuse.
3. Les bonnes pratiques
- Court bat exhaustif. Un fichier qu'on ne lit pas ne sert à rien.
- Concret bat abstrait. « Donne les commandes prêtes à coller » plutôt que « sois utile ».
- Une règle = une vraie erreur. N'ajoute pas de règles spéculatives « au cas où ».
- Découpe par contexte. Plutôt qu'un pavé unique, un socle commun + des extensions (par ex. une pour la stratégie, une pour la technique).
4. Comment le faire grandir
Quand Claude se plante sur un truc récurrent, tu ne râles pas : tu ajoutes la règle. Le fichier s'améliore avec l'usage. C'est exactement le principe du Compound Engineering appliqué à ton contexte.
Avant
Re-briefer à chaque fois
- « Réponds en français »
- « Voici mon métier… »
- Mêmes erreurs qui reviennent
Après
Un CLAUDE.md unique
- Cadré une fois pour toutes
- Colle à ton style d'entrée
- Grandit à chaque piège corrigé