Version francaise de awesome-claude-code
Configurations CLAUDE.md eprouvees en production pour les professionnels qui utilisent les agents IA serieusement.
La plupart des gens redigent un CLAUDE.md comme un prompt systeme : un paragraphe de souhaits. Ce depot le traite pour ce qu'il est reellement : un contrat operationnel entre vous et un agent qui le charge a chaque session, l'applique a chaque sortie, et derive des que vous cessez de l'imposer.
Les configurations presentees ici sont issues de centaines d'heures d'utilisation en production dans les domaines de la coordination de programmes, du travail editorial, des campagnes de candidature, du contact institutionnel et de l'analyse strategique. Elles ne sont pas theoriques. Elles ont ete auditees, corrigees et re-corrigees face a des modes de defaillance reels qui ont coute du temps reel.
- Qu'est-ce que CLAUDE.md
- Pourquoi la plupart des gens le configurent mal
- Anatomie d'un CLAUDE.md de production
- Demarrage rapide
- Modeles
- Les quatre mecanismes de correction universels
- Guides
- Galerie des anti-patrons
- Modele de maturite
- Questions frequentes
- Contribuer
- Auteur
- Licence
CLAUDE.md est la couche identitaire de Claude Code. Placez-le a la racine de votre repertoire de projet, et Claude Code le charge au debut de chaque session, avant meme de lire votre premier message.
Ce n'est pas une boite a suggestions. Ce n'est pas une description de personnalite. C'est le seul etat persistant qui survit entre les sessions. Tout ce que vous voulez que l'agent retienne, applique et ne viole jamais va ici. Tout le reste est oublie des que la session se ferme.
Trois emplacements, trois portees :
| Fichier | Portee | Chargement |
|---|---|---|
~/.claude/CLAUDE.md |
Tous les projets, tous les depots | Chaque session |
./CLAUDE.md (racine du projet) |
Ce projet uniquement | Chaque session dans ce projet |
./.claude/rules/*.md |
Regles specifiques a ce projet | Chaque session dans ce projet |
Le fichier global porte votre identite, votre voix et vos contraintes universelles. Le fichier projet porte les outils specifiques au domaine, les sequences d'amorcage et les mecanismes de correction. Le dossier de regles porte les contraintes granulaires qui encombreraient le fichier principal.
Global (~/.claude/CLAUDE.md) :
- Votre identite et la definition de votre role
- La discipline de voix universelle (les patrons que vous ne voulez jamais, quel que soit le projet)
- Les competences ou capacites que vous importez dans tout votre travail
- Les contraintes personnelles (pas de therapie, pas de verbes prescriptifs sur le territoire personnel, etc.)
Projet (./CLAUDE.md) :
- Le routage d'outils specifique au projet
- La sequence d'amorcage pour les fichiers de ce projet
- Le catalogue de modes de defaillance specifiques au domaine
- Les chemins vers les fichiers de reference vocale pour les registres de ce projet
- Les regles de gestion d'etat de session
Regles (./.claude/rules/*.md) :
- Contraintes granulaires trop specifiques pour le fichier principal
- Regles de codage par langage ou par framework
- Contraintes temporaires pour une phase specifique du travail
Le reflexe par defaut est d'ecrire quelque chose comme :
Tu es un assistant de code serviable. Sois concis. Utilise TypeScript.C'est un souhait, pas un contrat. Il ne contient aucun mecanisme d'application, aucun protocole de correction, aucune discipline de voix, aucun routage d'outils, aucune regle de recuperation, et aucun catalogue de modes de defaillance. L'agent se conformera pendant environ trois tours, puis derivera vers la mediane de sa distribution d'entrainement : verbeux, hesitant, performant l'utilite au lieu de faire avancer votre objectif reel.
Un CLAUDE.md de production est un contrat operationnel. Il specifie :
- Qui est l'agent (pas "assistant serviable" mais "mon operateur, mon directeur de cabinet, mon partenaire editorial")
- Ce qu'il ne doit jamais faire (un catalogue de patrons interdits, pas un vague "sois concis")
- Comment il se verifie (des mecanismes de correction qui se declenchent avant chaque sortie)
- Dans quelle voix il ecrit (la votre, pas sa mediane d'entrainement)
- Par quels outils il transite (des recettes nommees, pas des sorties en roue libre)
- Ce qu'il lit avant d'ecrire (des regles de recuperation qui empechent la derive)
- Comment vous l'auditez (chaque correction est verifiable par vous contre la sortie)
La difference entre un souhait et un contrat, c'est l'auditabilite. Si vous ne pouvez pas pointer la sortie et dire "ceci viole la regle X", la regle n'est pas une regle.
Un contrat operationnel complet comporte sept sections. Chacune remplit une fonction distincte. En retirer une cree un vecteur de derive que l'agent exploitera, non par malveillance, mais parce que sa distribution d'entrainement tire vers la mediane des que la contrainte est absente.
| Section | Fonction | Ce qui casse sans elle |
|---|---|---|
| Contrat d'identite | Definit le role, la relation, les limites | L'agent revient au registre "assistant serviable" |
| Mecanismes de correction | Intercepte les quatre modes de defaillance universels | L'agent optimise pour les tours impressionnants, pas pour les resultats |
| Discipline de voix | Impose votre voix, pas celle de l'IA | Chaque sortie ressemble a du ChatGPT |
| Routage d'outils | Chaque sortie transite par une recette nommee | Les sorties non structurees derivent en format et en qualite |
| Sequence d'amorcage | Quoi charger et dans quel ordre | L'agent traite chaque session comme un debut, demande un contexte qu'il a deja |
| Recuperation pre-redaction | Lire le materiel de reference avant d'ecrire | L'agent ecrit a partir de sa distribution d'entrainement, pas de votre corpus |
| Catalogue de modes de defaillance | Patrons interdits, formules proscrites, anti-patrons | L'agent produit les memes tics que vous lui avez dit d'arreter |
Guide complet : Anatomie d'un CLAUDE.md de production
-
Choisissez le modele le plus proche de votre activite :
-
Copiez-le a la racine de votre projet sous le nom
CLAUDE.md. -
Remplacez les sections a completer :
[VOTRE NOM]par votre nom[VOTRE DOMAINE]par votre champ d'activite- Les recettes d'outils par vos flux de travail reels
- Les echantillons de voix par vos propres ecrits
- Les modes de defaillance par vos irritants reels concernant les sorties IA
-
Creez les fichiers d'appui :
STATE.mdpour suivre le travail en cours et les echeancesvoice_reference/dossier avec des echantillons de votre ecriture reelledecisions.mdpour journaliser les decisions substantielles- Tout fichier specifique au domaine reference dans le modele
-
Lancez une session Claude Code. L'agent charge le fichier automatiquement.
-
Quand l'agent viole une regle, nommez la violation. Puis ajoutez-la au catalogue de modes de defaillance pour qu'elle ne se reproduise pas.
-
Apres dix sessions, votre CLAUDE.md sera eprouve. Apres cinquante, ce sera un systeme d'exploitation.
| Modele | Pour qui | Caracteristique cle |
|---|---|---|
| Consultant | Consultants independants, conseillers, strateges | Discipline de sortie orientee client, pipeline de propositions, cartographie des parties prenantes |
| Chercheur | Chercheurs academiques, analystes de politiques publiques | Discipline de citation, veille bibliographique, pipeline de redaction de subventions |
| Dirigeant | Managers, directeurs, direction generale | Notes de decision, architecture de reunions, cadrage de delegation |
| Ecrivain | Auteurs, journalistes, essayistes | Preservation de la voix avant tout, suppression des empreintes LLM, pipeline editorial |
| Demandeur d'emploi | Personnes en reconversion, chercheurs d'emploi actifs | Suivi des candidatures, registre des resultats de reponse, qualification des opportunites |
Chaque modele est un CLAUDE.md complet, pret a l'emploi. Copiez-le, adaptez-le, imposez-le.
Tout agent IA echoue de la meme facon selon quatre axes. Ce ne sont pas des bugs. Ce sont des proprietes structurelles du fonctionnement des modeles de langage. La seule defense est de les nommer, de construire une correction pour chacun, et d'auditer la correction contre chaque sortie.
Il produit des reponses polies, des cadres supplementaires, de nouveaux systemes. Chacun performe la competence a ce tour au lieu de faire avancer le seul resultat qui compte d'un tour a l'autre.
Correction : Chaque reponse nomme le resultat unique qu'elle fait avancer. Si elle ne fait rien avancer, elle le dit au lieu de produire un livrable.
Audit : Vous detectez l'agent en train de generer un artefact qui ne fait pas avancer l'action en cours, et vous le qualifiez d'echafaudage.
Il demande des faits deja en memoire, dans vos fichiers, ou sur le disque. C'est une defaillance de recuperation, pas de connaissance. Chaque tour est traite comme un debut.
Correction : L'agent fouille son contexte disponible avant de vous demander quoi que ce soit ou d'affirmer une position. Aucune question a laquelle vous pouvez repondre "tu as deja ca".
Audit : Vous detectez toute question redondante instantanement.
Il verifie vos donnees a la decimale pres tout en laissant passer des inflations dans ses propres brouillons. Le controle de "defensabilite" se declenche vers l'exterieur, jamais vers l'interieur.
Correction : Tout ce que l'agent marque comme pret a envoyer porte ses affirmations non verifiables signalees a l'interieur, et l'agent declare ce qui n'a pas ete verifie. Pas de "pret a envoyer" sans cette ligne.
Audit : Vous detectez tout brouillon transmis qui affirme un fait que l'agent n'a pas confirme.
La recherche sur l'analyse de registre pour le transfert de style documente que les modeles appliquent systematiquement leur propre style entraine aux voix sources, sauf si des contraintes explicites de preservation de registre sont inserees. Cela se manifeste par une derive du vocabulaire, des tics structurels et des patrons formulaires qui appartiennent au modele, pas a vous.
Correction : Pour tout artefact ou la fidelite vocale importe, l'agent genere l'artefact, puis effectue une passe d'autocritique interne contre vos echantillons de reference vocale, puis ne livre que la version qui passe. La preuve de l'autocritique apparait dans la reponse avant l'artefact.
Audit : Vous detectez tout artefact qui apparait sans l'etape d'autocritique visible, et vous nommez les empreintes des qu'elles emergent.
Guide complet : Les quatre mecanismes de correction
| Guide | Contenu |
|---|---|
| Anatomie d'un CLAUDE.md de production | Reference complete de chaque section d'un contrat operationnel |
| Les quatre mecanismes de correction | Analyse approfondie des quatre modes de defaillance universels et de leurs corrections |
| Discipline de voix | Comment faire ecrire l'IA dans votre voix, avec detection et suppression des empreintes |
| Routage d'outils | Chaque sortie par une recette nommee ; exemples d'etageres d'outils par metier |
Ce sont de vrais patrons CLAUDE.md qui semblent utiles mais produisent des sorties inferieures au fil du temps. Chacun a ete teste et trouve deficient.
Tu es un assistant amical, creatif et attentionne qui adore
aider avec le code. Sois enthousiaste mais professionnel.Pourquoi ca echoue : Les adjectifs de personnalite ne contraignent pas le comportement. "Amical" produit du remplissage ("Excellente question !"). "Creatif" produit des alternatives non sollicitees. "Attentionne" produit des hedges verbeux. "Enthousiaste" produit des points d'exclamation et de l'energie performative. Rien de tout cela n'est ce que vous vouliez. Vous vouliez que le travail soit fait.
Regles :
1. Sois concis
2. Utilise la voix active
3. Evite le jargon
4. Inclus des exemples
5. Verifie les faits
... (trente regles de plus)Pourquoi ca echoue : Des regles sans mecanisme d'application sont des suggestions. L'agent se conforme a celles qui correspondent a sa distribution d'entrainement (il est deja assez concis) et ignore silencieusement celles qui n'y correspondent pas (il verifie rarement ses propres faits). Apres trois tours, les regles sont enfouies dans le contexte et fonctionnellement inertes.
Fais comme si tu etais un associe senior de McKinsey examinant mon travail.
Sois critique et exigeant. Conteste les arguments faibles.Pourquoi ca echoue : Le jeu de role produit une performance du role, pas la fonction du role. L'agent performe le "senior dur" en utilisant un langage confrontationnel et en ajoutant des reserves, pas en identifiant reellement les arguments faibles. La performance satisfait le prompt ; la fonction n'est pas remplie.
[5 000 mots d'instructions couvrant chaque scenario possible,
avec des conditionnelles imbriquees, des exceptions aux exceptions,
et des references croisees vers d'autres sections qui peuvent
ou non exister]Pourquoi ca echoue : L'attention de l'agent se distribue sur toute la fenetre de contexte. Un CLAUDE.md de 5 000 mots signifie que chaque instruction recoit a peu pres la meme attention (et donc une attention insuffisante). Un CLAUDE.md de 500 mots avec les cinq contraintes les plus importantes recoit une attention concentree sur chacune. La concision est une fonctionnalite, pas un compromis.
Ecris dans un ton professionnel mais accessible, formel
mais pas guinde, concis mais approfondi, et confiant mais humble.Pourquoi ca echoue : Chaque paire d'adjectifs s'annule mutuellement. "Professionnel mais accessible" decrit la mediane de la distribution d'entrainement ; l'agent allait faire ca de toute facon. L'instruction ne contraint rien. Ce qui fonctionne : des interdictions specifiques ("pas de tirets cadratins"), des exigences specifiques ("ouvre avec la conclusion"), et des echantillons reels de votre ecriture.
Les configurations CLAUDE.md murissent avec l'usage. Voici a quoi ressemble chaque stade :
Quelques phrases decrivant ce que vous voulez. Pas d'application, pas d'outils, pas de discipline de voix. L'agent performe bien au tour 1 et derive au tour 5. Vous passez plus de temps a corriger l'agent que l'agent ne vous en fait gagner.
Vous avez ajoute des regles basees sur des irritations specifiques. "Pas de tirets cadratins." "Ne reformule pas ma question avant de repondre." Les regles fonctionnent pour les patrons que vous avez detectes. De nouveaux patrons emergent que les regles ne couvrent pas. L'agent s'ameliore mais derive encore dans les zones non contraintes.
Vous avez ajoute les quatre corrections, le routage d'outils, les fichiers de reference vocale et une sequence d'amorcage. Les sorties de l'agent sont coherentes d'une session a l'autre. Vous passez moins de temps a corriger et plus a travailler. Les nouveaux modes de defaillance sont rares et rapidement ajoutes au catalogue.
Votre CLAUDE.md reference une constellation de fichiers : suivis d'etat, references vocales, registres de contacts, registres de resultats, recettes d'outils. L'agent opere comme un sous-modele de vous, avec une connaissance du domaine, un contexte relationnel et une fidelite vocale qui s'ameliorent a chaque session. Les corrections sont rares. Le systeme compose.
Votre configuration est suffisamment documentee pour qu'un collegue puisse la dupliquer, remplacer les echantillons de voix et les references de domaine, et disposer d'un operateur fonctionnel en un apres-midi. Les modeles de ce depot sont des artefacts de stade 5.
La plupart des professionnels plafonnent au stade 2 parce qu'ils ne savent pas que les stades 3 a 5 existent. Ce depot existe pour combler cet ecart.
Aussi court que possible tout en couvrant les sept sections. Un bon CLAUDE.md de production fait 300 a 800 mots de contraintes directes plus des references @ vers des fichiers externes qui portent le detail (echantillons de voix, recettes d'outils, fichiers d'etat). Le CLAUDE.md lui-meme doit etre epure ; les fichiers references portent le poids.
Les deux. Le fichier global (~/.claude/CLAUDE.md) porte votre identite, vos contraintes vocales universelles et vos limites personnelles. Cela s'applique a tous les projets. Le fichier projet (./CLAUDE.md) porte les outils specifiques au projet, les sequences d'amorcage, le vocabulaire du domaine et les references vocales. Ensemble, ils forment votre contrat operationnel complet.
Collectez cinq a dix echantillons de votre ecriture reelle. Pas votre meilleure ecriture ; votre ecriture la plus caracteristique. Collez-les dans un fichier sous voice_reference/ avec des etiquettes de registre (par exemple, "email client", "rapport analytique", "correspondance personnelle"). L'agent lit ce fichier avant de rediger quoi que ce soit. Voir le guide Discipline de voix pour les details.
Les principes sont universels : les contrats d'identite, les mecanismes de correction, la discipline de voix et le routage d'outils fonctionnent avec tout agent IA qui accepte un prompt systeme ou un fichier de configuration. Le format de fichier specifique (CLAUDE.md, syntaxe de directive @) est propre a Claude Code, mais les patrons s'adaptent a Cursor, Copilot ou tout agent qui charge des instructions persistantes.
Utilisez le CLAUDE.md global pour les contraintes universelles et un CLAUDE.md specifique au projet pour chaque projet. Le fichier global porte votre identite ; chaque fichier projet porte son domaine, ses outils et sa voix. Ils se composent automatiquement : Claude Code charge les deux au demarrage de la session.
Nommez la violation specifique. "Ceci viole l'element 7 du catalogue de modes de defaillance : tu as propose d'affiner apres avoir livre. Je n'ai pas demande d'affinement." Puis ajoutez la violation a votre journal de decisions. Plus vous nommez les violations avec precision, plus l'agent les respecte dans les tours et sessions suivants.
Quand une nouvelle correction devrait sinon etre repetee dans une session future. Ne mettez pas a jour de facon reactive apres chaque session ; mettez a jour quand un patron s'est reproduit au moins deux fois et que vous voulez le traiter de facon permanente. Relisez le fichier complet trimestriellement pour supprimer les regles obsoletes et resserrer les regles actives.
Oui. Chaque fichier charge via la directive @ coute des tokens a chaque session. Gardez le CLAUDE.md lui-meme epure et utilisez les fichiers references pour le detail. Elaguez les fichiers d'etat mensuellement. Archivez le travail termine. Utilisez l'anglais pour les fichiers operateur (nombre de tokens plus court par concept que la plupart des autres langues). Voir la section Discipline de budget de tokens.
Ce depot s'ameliore par des patrons eprouves en production, pas par des ajouts theoriques.
Ce qui a sa place ici :
- Un patron CLAUDE.md que vous avez utilise en production pendant au moins dix sessions
- Un mode de defaillance que vous avez decouvert et corrige avec un mecanisme specifique
- Un modele pour un metier non encore couvert
- Une correction a un modele existant fondee sur votre experience
Ce qui n'a pas sa place ici :
- Des cadres theoriques qui n'ont pas ete testes contre des sorties reelles
- Des descriptions de personnalite ("sois amical, sois creatif")
- Des patrons qui fonctionnent un tour mais derivent sur une session
- Quoi que ce soit qui ne puisse pas etre audite contre la sortie reelle de l'agent
Comment contribuer :
- Dupliquez le depot.
- Ajoutez votre patron ou modele.
- Incluez une breve note sur le nombre de sessions pendant lesquelles vous l'avez teste et quels modes de defaillance il corrige.
- Soumettez une pull request.
Le critere est l'usage en production, pas le prompting astucieux.
David Dabert
Franco-Senegalais. Base a Bordeaux. Parcours en coordination de programmes UE et FCDO entre l'Europe et l'Afrique de l'Ouest, avec douze ans de mise en oeuvre Erasmus+ sur six juridictions et la direction d'un consortium DFID-UKAID de quinze partenaires.
Editeur de The Practitioner's Read, une serie d'essais courts sur la pratique institutionnelle lue par environ 1 100 professionnels concentres au Quai d'Orsay, a l'OIM, a la Commission europeenne, a la Fondation europeenne pour la formation et a la Banque europeenne d'investissement.
Les configurations de ce depot ont ete developpees durant une periode intensive de construction operateur en 2026, ou chaque configuration a ete testee contre des livrables reels (memorandums strategiques, dossiers de candidature, series editoriales, contact institutionnel) et corrigee contre des modes de defaillance auditables sur des centaines de sessions.
Les quatre mecanismes de correction s'appuient sur des cadres intellectuels de plusieurs domaines : la theorie des contraintes de Goldratt (se concentrer sur le goulot d'etranglement), le satisficing de Simon (verifier ce qu'on a avant d'optimiser), la discipline du baton de glace de Catmull chez Pixar (rendre les arbitrages visibles), et la litterature sur l'analyse de registre pour le transfert de style dans les modeles de langage (arXiv 2505.00679, 2025 ; arXiv 2602.22145, 2026). L'application a la configuration d'agents IA est empirique, pas theorique : chaque mecanisme a ete decouvert en observant une defaillance specifique, en la nommant, et en construisant une correction auditable contre la sortie.