Un mauvais CLAUDE.md vous fait perdre 80% de la valeur de Claude. Un bon CLAUDE.md vous fait gagner 5-10h par semaine. Voici la structure exacte qui marche, avec exemples du bien et du mal.
Les 7 sections obligatoires
- Contexte : qui vous êtes, votre entreprise, votre rôle
- Priorités 12 mois : 3-5 sujets sur lesquels vous bossez
- Style attendu : ton, longueur, formats
- Anti-patterns explicites : ce que vous ne voulez SURTOUT pas
- Vocabulaire métier : termes spécifiques à votre business
- Équipe (si applicable) : qui fait quoi autour de vous
- Règles techniques (si applicable) : formats, outils utilisés
Section Contexte : exemples bien et mal
Mal : "Je suis dirigeant."
Bien : "Je suis Maxence, fondateur de MS4D, agence marketing digital e-commerce 15 personnes, basée en France. Je dirige depuis 2011. Je travaille avec des e-commerçants 1-30M€. Mon objectif perso 2026 : développer une branche IA de l'agence (Make Sense IO)."
Section Priorités : exemples
Mal : "Croître l'entreprise."
Bien : "3 priorités 2026 : 1) lancer Make Sense IO et signer 5 clients Sprint, 2) recruter un VP Sales pour MS4D, 3) sortir 2 vidéos YouTube par mois sur l'IA pour dirigeants. Tout le reste est secondaire."
Section Style : exemples
Mal : "Sois professionnel."
Bien : "Style attendu : direct, structuré, orienté action. Pas de blabla, pas de \"j'espère que ce message vous trouve bien\". Réponses courtes par défaut, longues si je le demande explicitement. Toujours en français avec accents corrects. Pas de tirets cadratins ni demi-cadratins (—, –). Remplacer par : ou , ou parenthèses."
Section Anti-patterns : la plus négligée
Lister les 5-10 choses que vous voulez éviter explicitement. C'est ce qui rend le CLAUDE.md vraiment puissant.
Exemples : "Ne propose JAMAIS plusieurs options sans recommandation. Ne dis JAMAIS \"il dépend\". Ne réponds JAMAIS par \"très bonne question\". Si je te demande un email, tu écris l'email, pas un brief de l'email."
La règle d'or : longueur
Un CLAUDE.md doit tenir en 1 page (300-600 mots). Plus long = Claude oublie le début. Plus court = pas assez de contexte.
Si vous sentez qu'il vous en faut plus : créez un Skill spécialisé pour le sujet long, gardez le CLAUDE.md global.
Les 5 erreurs classiques
- Trop générique ("sois professionnel") : sans exemple concret, inutile
- Trop long (5 pages) : Claude perd le fil
- Pas mis à jour : votre business évolue, le CLAUDE.md doit suivre
- Pas d'anti-patterns : Claude tombe dans des défauts évitables
- Mélangeur de niveaux : business, technique, personnel mélangés
Comment générer le vôtre
Le questionnaire Make Sense est dispo gratuitement : 10 questions ciblées, output prêt à coller. Lien : /3skills.
Compter 30 minutes pour le compléter sérieusement. Compter 1 semaine d'utilisation pour ajuster les anti-patterns avec ce que vous voyez en pratique.
Tu veux qu'on identifie ta contrainte IA n°1 ?
Audit offert 25 min avec Maxence. Plan d'action écrit livré sous 48h.
Réserver mon audit