CLAUDE.md : le briefing permanent
Un fichier texte qui donne à Claude Code le contexte de ton projet, tes conventions et tes interdits. Pour ne plus jamais réexpliquer les mêmes choses.
Le problème
Tu demandes à Claude de rédiger un post LinkedIn pour ton lancement produit. Il écrit "Nous sommes ravis de vous annoncer..." alors que ta marque tutoie tout le monde. Tu corriges. Session suivante, il recommence.
Tu lui demandes un brief créatif. Il oublie que ta cible c'est des PME de 10-50 personnes, pas des grands comptes. Tu réexpliques. Il oublie que ton positionnement c'est "simple et direct", pas "solution holistique". Tu réexpliques encore.
Chaque session, Claude repart de zéro. Il ne connaît pas ton produit, pas ton audience, pas ton ton éditorial, pas tes interdits. Il est compétent mais amnésique. Et le temps que tu passes à réexpliquer le contexte, c'est du temps que tu ne passes pas à produire.
CLAUDE.md résout ça. C'est un fichier texte que Claude charge automatiquement à chaque session. Tu y mets tes règles une fois. Il les applique à chaque fois.
Un fichier texte, rien de plus
Un CLAUDE.md, c'est un fichier markdown à la racine de ton projet. Pas de logiciel spécial, pas de syntaxe à apprendre. Du texte structuré avec des # et des -.
mon-projet/
CLAUDE.md ← Claude le lit au début de chaque session
src/
...
Claude le charge en silence. Tu ne le mentionnes pas. Il applique ce qui est écrit comme un collègue qui a lu le brief du projet avant de commencer.
Avant / après
Pour comprendre ce que ça change, voilà le même travail avec et sans CLAUDE.md.
"Rédige un post LinkedIn pour notre nouveau produit."
Nous sommes ravis d'annoncer le lancement de notre solution innovante...
"Non, on tutoie. Et c'est pas une solution innovante, c'est un outil de facturation pour les freelances."
Tu vas adorer notre nouvel outil révolutionnaire...
"Pas 'révolutionnaire' non plus. Ton direct, factuel."
5 minutes pour arriver au bon registre. Demain, on recommence.
"Rédige un post LinkedIn pour notre nouveau produit."
Claude sait déjà :
- Le produit (facturation pour freelances)
- La cible (indépendants, TPE)
- Le ton (direct, tutoiement, pas de jargon)
- Les interdits ("innovant", "révolutionnaire", "solution")
Premier jet utilisable en 30 secondes.
Le gain n'est pas spectaculaire sur une seule session. Il est énorme sur 50.
Anatomie d'un CLAUDE.md
Pas de format imposé. Mais une structure en quatre blocs couvre l'essentiel.
1. Le contexte
Ce que Claude doit savoir avant de produire quoi que ce soit. Le produit, l'audience, le positionnement.
Claude n'a pas besoin de tout savoir. Il a besoin de ce qui influence ses réponses : si tu lui demandes un argument de vente, il doit connaître le prix. Si tu lui demandes un post LinkedIn, il doit connaître le positionnement.
2. Le ton et l'éditorial
Comment tu parles à ton audience. C'est la section qui élimine le plus de corrections.
3. Les interdits
Ce que Claude ne doit jamais faire. Souvent plus utile que ce qu'il doit faire, parce que les erreurs par défaut sont prévisibles.
"JAMAIS" en majuscules n'est pas un caprice de mise en forme. Claude accorde un poids plus élevé aux mots en capitales. C'est comme écrire en gras dans un brief : ça signale la priorité.
4. Les formats et conventions
Les règles qui s'appliquent à tout ce que Claude produit pour ce projet.
24 lignes au total. Chaque ligne élimine une catégorie d'erreurs.
Un vrai exemple
Le CLAUDE.md d'une agence de contenu qui produit des newsletters et des posts LinkedIn pour ses clients.
19 lignes. Pas un roman. "TOUJOURS lire la charte client" suffit pour que Claude aille chercher le bon fichier avant de commencer. "Ne JAMAIS publier directement" est le genre de garde-fou qui évite la catastrophe.
Comment le construire
Ne commence pas par un CLAUDE.md parfait. Commence par un fichier presque vide.
1. Le minimum viable
Produit, audience, ton en 5 lignes. C'est suffisant pour que Claude arrête de deviner.
2. Travaille, corrige, note
Chaque fois que tu corriges Claude ("pas de vouvoiement", "on dit 'utilisateurs' pas 'clients'"), note-le mentalement. Deux corrections identiques = une règle à écrire.
3. 2 semaines plus tard
Ton CLAUDE.md fait 20-30 lignes et couvre 90% des cas. Tu ouvres une session, tu travailles directement. Pas de contexte à redonner.
Le test : si ta première demande dans une nouvelle session donne un résultat utilisable du premier coup, le CLAUDE.md fait son job.
Et tu n'as même pas besoin de l'écrire toi-même. Claude peut le générer :
Claude est bon pour déduire le ton et les conventions de ce qui existe. Ce qu'il ne peut pas deviner : les interdits, les nuances de positionnement, les règles métier. Ces lignes-là, c'est toi qui les ajoutes.
Trois niveaux qui se cumulent
Claude charge les instructions de trois endroits. Les trois se superposent.
Le projet ne remplace pas le global, il s'y ajoute. En cas de conflit, le plus spécifique gagne. Si ton global dit "tutoiement" mais que le projet dit "vouvoiement pour cette marque", le projet l'emporte.
Par métier : 3 exemples concrets
Le CLAUDE.md n'est pas réservé aux développeurs. Tout projet qui vit dans un dossier peut en avoir un.
Pour un lancement produit :
## Produit
- App mobile de suivi budgétaire pour les 25-35 ans
- Freemium : gratuit avec pub, 4,99€/mois sans pub + export
- Différenciation : interface minimale, pas de courbes, juste des chiffres
## Audience
- Jeunes actifs, premier salaire ou premiers investissements
- Ils ont essayé Bankin/Linxo et trouvé ça trop complexe
## Ton
- Familier mais pas relou. Comme un pote qui gère bien ses finances.
- Pas de jargon bancaire ("flux", "solde agrégé", "catégorisation")
- JAMAIS : "prenez le contrôle de vos finances"
Pour une équipe contenu :
## Charte éditoriale
- Tutoiement partout sauf les pages légales
- Guillemets français (« ») pas anglais (" ")
- Titres : informatifs, pas clickbait
- Articles : 800-1500 mots. Si c'est plus long, découper.
- Chaque article a une date de publication ET de mise à jour
- Sources : toujours citer, toujours lier
- JAMAIS de superlatifs non chiffrés
Pour une veille concurrentielle :
## Contexte
- Marché : outils de gestion de projet pour agences (10-50 personnes)
- Nos concurrents directs : Monday, Asana, Notion (usage détourné)
- Notre angle : fait pour les agences, pas adapté depuis l'enterprise
## Veille
- Quand tu analyses un concurrent, regarde : pricing, fonctionnalités
différenciantes, dernières annonces, avis Capterra/G2 récents
- Format de sortie : tableau comparatif, pas de prose
Le contenu change. Le principe reste le même : des règles que Claude applique sans qu'on les réexplique.
Ce qu'il ne faut PAS y mettre
| Ne pas mettre | Pourquoi |
|---|---|
| La documentation d'un outil | Claude la connaît ou peut la chercher |
| Un brief de campagne spécifique | C'est un Skill, pas du CLAUDE.md |
| L'historique des décisions | Trop long, pas actionnable |
| Des paragraphes explicatifs | Des règles, pas des dissertations |
| "Ce client est difficile" | Pas actionnable. Dire ce qu'il faut faire concrètement. |
La frontière avec les Skills : si c'est une convention permanente en une ligne ("tutoiement"), c'est du CLAUDE.md. Si c'est un workflow en plusieurs étapes avec un format de sortie ("génère un brief créatif avec cette structure"), c'est un Skill.
Le CLAUDE.md en équipe
Quand le CLAUDE.md est dans le repo, toute l'équipe bénéficie des mêmes règles.
Scénario classique : un nouveau content manager arrive. Sans CLAUDE.md, il passe deux semaines à absorber la charte éditoriale par essai-erreur (ou par relecture de ses textes). Avec un CLAUDE.md, Claude applique les conventions dès la première session. Le nouveau produit du contenu conforme au premier jet.
Autre scénario : l'équipe décide de passer au tutoiement sur le blog. Au lieu de prévenir tout le monde et espérer que chacun s'y tienne, une ligne dans le CLAUDE.md suffit. Chaque membre de l'équipe qui utilise Claude Code applique la nouvelle convention automatiquement.
CLAUDE.md et Skills : comment ils cohabitent
Chargé automatiquement, tout le temps.
- Qui est l'audience
- Quel ton utiliser
- Ce qu'on ne fait jamais
- Les conventions du projet
"Comment on travaille ici."
Chargé à la demande, quand tu l'invoques.
- Les étapes à suivre
- Les critères d'évaluation
- Le format de sortie
- Les sources à consulter
"Comment on fait cette tâche précise."
Les deux se cumulent. Quand tu lances un Skill de rédaction, Claude applique les instructions du Skill (structure, étapes) ET les conventions du CLAUDE.md (ton, interdits, audience). Le résultat respecte la méthode et le cadre.
Les erreurs classiques
Trois patterns qu'on retrouve dans la majorité des CLAUDE.md qui ne marchent pas.
Nous avons décidé lors du séminaire de janvier de passer au tutoiement car nos tests utilisateurs ont montré que le vouvoiement créait une distance perçue qui réduisait le taux de conversion de 12% sur la landing page B. Cette décision a été validée par le comité éditorial le 3 février.
Tutoiement partout sauf pages légales.
Adopter un ton professionnel mais accessible.
Écrire du contenu de qualité.
Être créatif dans les accroches.
Tutoiement, phrases courtes, pas de jargon sauf si expliqué.
800-1200 mots par article, titre informatif.
Première phrase = fait ou chiffre, jamais une question rhétorique.
Ton direct, tutoiement.
Pour les audits de landing page, évalue : clarté du message en 5 secondes, hiérarchie visuelle, parcours de l'arrivée au CTA, ton éditorial. Pour chaque critère, produis un constat, un verdict et une suggestion...
CLAUDE.md : Ton direct, tutoiement.
Skill /audit-landing : les 30 lignes d'instructions pour l'audit de landing page.
Et après
Tu as le cadre (CLAUDE.md) et les méthodes (Skills). L'article suivant montre comment construire une vraie bibliothèque de Skills : organisation, nommage, patterns qui marchent, exemples tirés d'un usage quotidien.