CLAUDE.md : 33 critères pour un fichier qui marche (checklist marketer IA 2026)

La documentation officielle d’Anthropic le dit clairement : les performances de Claude Code baissent à mesure que le contexte se remplit. Un CLAUDE.md de 3 000 mots sur votre marque, vos valeurs et votre histoire ne produit pas de meilleures sorties. Il en produit de moins bonnes. En 2026, les marketers IA qui obtiennent des résultats constants convergent vers le même constat : un fichier CLAUDE.md utile tient sous 80 lignes et chaque ligne modifie le comportement de l’IA de façon observable. Ce guide couvre les 33 critères qui séparent un CLAUDE.md opérationnel d’un document de présentation que Claude lit une fois et ignore.

Ce qu’est réellement un CLAUDE.md (et ce que la plupart des marketers font mal)

Un CLAUDE.md est un fichier Markdown que Claude Code lit automatiquement au démarrage de chaque session. Ce n’est pas un brief créatif. Ce n’est pas une charte de marque. C’est un système d’instructions persistantes qui modifient le comportement de l’IA sans avoir à répéter les mêmes consignes à chaque conversation.

L’erreur la plus courante : remplir le fichier de philosophie de marque (« notre mission est de connecter les gens »), de biographies d’équipe et d’historiques d’entreprise. Ces éléments n’instruisent pas Claude. Ils consomment du contexte. La documentation Claude Code (Anthropic, 2026) précise que la plupart des bonnes pratiques découlent d’une contrainte unique : la fenêtre de contexte se remplit vite et les performances chutent avec elle.

Claude Code lit les instructions depuis plusieurs emplacements : ~/.claude/CLAUDE.md pour les règles globales applicables à tous vos projets, ./CLAUDE.md ou ./.claude/CLAUDE.md à la racine du projet pour le contexte partagé avec l’équipe et ./CLAUDE.local.md pour vos préférences personnelles non versionnées (à ajouter au .gitignore). Pour les marketers qui travaillent sur plusieurs marques, cette architecture permet d’isoler les contextes sans alourdir chaque session.

Les 7 critères du bloc identité

Le bloc identité répond à une question précise : qui est Claude dans ce projet ? Pas « notre marque croit en l’innovation » mais « tu es le rédacteur SEO de [Entreprise], tu écris en français, tu t’adresses à des directeurs marketing de PME de 50 à 500 personnes. »

• Critère 1, rôle explicite : une phrase. « Tu es rédacteur SEO B2B spécialisé SaaS, audience = directeurs marketing France. »
• Critère 2, langue de travail : préciser la langue principale et les règles de bascule si vous travaillez en multilingue.
• Critère 3, niveau d’expertise cible : « l’audience connaît le marketing digital mais pas le code » ou « l’audience est technique, évite les définitions de base. »
• Critère 4, persona ou nom de code : si plusieurs projets coexistent, nommer le projet évite les confusions entre sessions (« Projet : Refonte SEO Marque X »).
• Critère 5, périmètre des missions : lister les 3 à 5 types de tâches que Claude fait dans ce projet. Ce que vous ne listez pas, il improvise.
• Critère 6, format de réponse par défaut : Markdown, HTML, texte brut ? Longueur par défaut ? Ces deux paramètres évitent 80% des reformulations.
• Critère 7, fuseaux horaires et unités : si vous travaillez avec des équipes internationales, préciser la référence temporelle et les unités monétaires évite des erreurs silencieuses dans les tableaux et les rapports.

Les 8 critères du bloc voix et ton

Le bloc voix est souvent raté. « Direct, humain et professionnel » ne change pas le comportement de Claude. « Utilise ‘vous’, une idée par phrase, jamais plus de 18 mots, zéro adverbe en -ment » le change. La différence tient dans le niveau de précision : des attributs observables plutôt que des adjectifs d’ambiance.

• Critère 8, attributs de voix actionnables : pas des adjectifs vagues mais des règles mesurables. « Concis » ne veut rien dire. « Phrases de 12 à 18 mots maximum » veut dire quelque chose.
• Critère 9, liste de mots bannis : les termes que votre marque n’utilise jamais. Pour un éditeur SaaS B2B : « révolutionnaire », « game-changer », « synergie ». Listez-en 10 à 20 maximum.
• Critère 10, liste de formulations préférées : 5 à 10 tournures qui sonnent comme votre marque. Claude les utilisera en priorité.
• Critère 11, règle du tutoyement ou vouvoiement : préciser le pronom utilisé avec le lecteur. Par défaut, Claude oscille selon le contexte.
• Critère 12, règle sur les listes à puces : à quel moment les utiliser, à quel moment préférer un paragraphe narratif. Sans règle explicite, Claude transforme tout en bullet points.
• Critère 13, règle sur les emojis : autoriser ou interdire et dans quels formats (réseaux sociaux oui, emails non).
• Critère 14, exemples de bon et mauvais texte : un extrait de 2 à 3 phrases représentatif de votre ton. Un exemple concret vaut 10 descriptions abstraites.
• Critère 15, règle sur les titres et accroches : style question ou affirmation, longueur maximale, majuscule ou minuscule.

Les 6 critères du bloc contexte marché

Ce bloc est absent de la plupart des CLAUDE.md marketers. C’est là que se joue la différence entre une sortie générique et une sortie utilisable. Claude ne connaît pas votre marché. Si vous ne lui donnez pas le contexte, il invente.

• Critère 16, concurrents directs : nommer 3 à 5 concurrents avec leur positionnement en une phrase. Claude évite les angles trop proches des leurs et adapte les comparaisons.
• Critère 17, objections récurrentes : les 3 à 5 raisons pour lesquelles vos prospects n’achètent pas. Claude les anticipe dans les textes commerciaux.
• Critère 18, arguments différenciateurs : 3 à 5 points forts vérifiables. Pas « qualité supérieure » mais « seul outil à proposer X fonctionnalité » ou « NPS de 72 mesuré en janvier 2026 ».
• Critère 19, références de prix : la fourchette tarifaire de vos offres. Sans ça, Claude invente ou reste vague sur les niveaux de prix dans les textes commerciaux.
• Critère 20, personas acheteurs : 1 à 3 personas concis (titre de poste, problème principal, canal préféré). Un persona de 500 mots pèse trop lourd sur le contexte.
• Critère 21, contexte sectoriel actuel : les 2 à 3 tendances de fond qui influencent vos acheteurs en 2026. Claude produit un contenu ancré dans le présent plutôt que dans les données de son entraînement.

Les 6 critères du bloc contraintes opérationnelles

Les contraintes opérationnelles sont les instructions les plus rentables à inclure. Un seul critère bien posé ici évite des dizaines de retours en arrière par mois. La plupart des guides s’arrêtent au ton et à la voix. C’est une erreur.

• Critère 22, format de sortie par type de tâche : « Pour un article SEO : HTML WordPress sans tags wrapper. Pour une newsletter : texte brut. Pour un ad copy : 3 variantes séparées par —. » Être exhaustif sur chaque format livrable récurrent.
• Critère 23, sources autorisées et interdites : si vous travaillez dans un secteur réglementé, préciser quelles sources Claude peut citer et lesquelles sont hors périmètre.
• Critère 24, règle de vérification des chiffres : « Ne jamais inventer un chiffre. Si aucune donnée fiable n’est disponible, écrire sans chiffre plutôt que d’approximer. » Cette ligne seule réduit les hallucinations de données dans la grande majorité des cas.
• Critère 25, règle du conditionnel : pour les informations non confirmées (rumeurs, bêtas privées, annonces anticipées), préciser le niveau de certitude requis avant d’employer l’indicatif.
• Critère 26, liens et attributions : règle sur nofollow/dofollow, ouverture dans un nouvel onglet, format des citations dans le texte.
• Critère 27, longueurs cibles par format : article SEO 1 200 mots, email 250 mots, post LinkedIn 150 mots. Sans cible, Claude oscille entre 400 et 2 000 mots.

Les 4 critères de maintenance

Un CLAUDE.md non maintenu devient un passif. Les instructions obsolètes créent des incohérences entre ce que vous attendez et ce que vous obtenez. La documentation Claude Code recommande de traiter le fichier comme un document vivant.

• Critère 28, journal des modifications : une section courte avec les 3 dernières mises à jour et leur date. Format : « 2026-04-15 : ajout règle emojis LinkedIn. 2026-03-01 : mise à jour personas. » Cela permet de retrouver pourquoi une règle existe.
• Critère 29, limite de longueur explicite : écrire dans le fichier lui-même « Ce fichier ne doit pas dépasser 80 lignes. Supprimer une ligne avant d’en ajouter une nouvelle. » La contrainte inscrite dans le fichier est la seule qui résiste au temps.
• Critère 30, imports modulaires : utiliser la syntaxe @path/to/rules.md pour déléguer les sections volumineuses (liste de mots bannis, personas détaillés) vers des fichiers séparés. Le fichier principal reste court.
• Critère 31, revue trimestrielle planifiée : noter dans le fichier la date de la prochaine revue. Un CLAUDE.md non révisé depuis 6 mois contient généralement des instructions contredites par l’évolution du produit ou du marché.

Les 2 critères anti-patterns les plus critiques

Deux patterns détruisent l’efficacité d’un CLAUDE.md, quelle que soit la qualité du reste.

Critère 32, zéro redondance avec le prompt. N’écrivez pas dans le CLAUDE.md ce que vous allez préciser dans chaque prompt. La règle de partage : ce qui change d’une tâche à l’autre va dans le prompt ; ce qui est constant va dans le CLAUDE.md. Quand une instruction figure aux deux endroits, elle crée des conflits que Claude résout de façon imprévisible.

Critère 33, aucune instruction sans test. Chaque ligne que vous ajoutez doit passer ce test : lancez une tâche représentative avec et sans cette instruction. Si le résultat est identique, la ligne est du bruit. Le blog d’ingénierie d’Anthropic (2025) formalise ce principe sous le nom de context rot : un contexte trop chargé dégrade la capacité du modèle à rappeler et appliquer fidèlement les instructions, même les valides. Chaque ligne inutile augmente le risque que les lignes utiles soient ignorées.

Le CLAUDE.md de base pour marketer IA : template à 80 lignes

Voici la structure minimale qui couvre les 33 critères. À adapter selon votre contexte. Les imports @path permettent de déléguer les sections détaillées sans alourdir le fichier principal.

La commande /init dans Claude Code analyse votre structure de fichiers et génère une base à affiner. Le fichier produit n’est jamais complet : il manque le contexte marché et les contraintes de voix. Mais il couvre les bases techniques en 5 minutes et vous évite de partir d’une page blanche.

Un CLAUDE.md sous 80 lignes qui respecte ces critères ne garantit pas des sorties parfaites. Il garantit que chaque prompt reçoit le bon contexte sans saturer la fenêtre qui conditionne la qualité de tout le reste.