L'architecture CLAUDE.md · pour ceux qui pilotent, pas pour les développeurs

Un agent ne devient puissant
que le jour où vous lui donnez un cerveau.

En bref : le CLAUDE.md est le fichier que Claude Code lit à chaque session pour savoir qui vous êtes et comment travailler. On vous vend une architecture en « 7 fichiers magiques ». En production, la bonne réponse tient en 4 couches : le socle, la mémoire, les garde-fous, les compétences. Voici chacune, avec le bloc exact à coller — et notre parti pris, sans détour.

Le piège du tuto viral

Sept fichiers séparés — Soul, Brain, Intuition, Creative, Security, Token, Agent — ça fait joli sur un carrousel LinkedIn. En vrai, ça se retourne contre vous. Trois raisons, concrètes :

Notre parti pris, chez Parrit : on déploie des agents en production tous les jours, chez de vraies PME, sur de vrais workflows. Ce qui survit à la production, ce n'est pas le fichier le plus impressionnant. C'est le cadre le plus simple qu'on ne peut pas casser. Et on n'écrit pas nos règles pour plaire aux commentaires : on les écrit pour tenir le lundi matin, quand l'agent touche votre vraie boîte mail.

La méthode qui tient tient en 4 couches : un socle unique, une mémoire atomique, des garde-fous, des compétences chargées à la demande. Les voici.

Vous avez la thèse. Entrez votre email pour débloquer les 4 blocs à coller dans Claude Code et les 4 templates .md.
Vous débloquez : les blocs à coller dans Claude Code · les 4 templates .md prêts à l'emploi
Débloqué. Les 4 modules sont ouverts ci-dessous. Une question pour démarrer ? Répondez à l'email, c'est Paul.

Les 4 couches, une par une

LE SOCLE CLAUDE.md

Qui vous êtes, ce que fait votre boîte, vos règles, votre voix. Claude Code lit ce fichier tout seul au début de chaque session — c'est la seule chose qui sépare un assistant amnésique d'un collaborateur qui vous connaît. Un dirigeant y met son secteur, ses clients types, sa manière d'écrire un mail et ses interdits. Concrètement : sans lui, vous réexpliquez le contexte dix fois par jour ; avec lui, vous le dites une fois.

Colle-moi ça dans Claude Code : Template .md ↓ 
Crée un fichier CLAUDE.md à la racine. Interviewe-moi une question à la fois pour le remplir : mon nom et mon rôle, ce que fait mon entreprise, mes clients types, ma façon d'écrire, mes règles absolues (ex : ne jamais envoyer un mail sans mon accord). Puis écris le fichier et relis-le avec moi.

LA MÉMOIRE memoire/

Un fait appris = un petit fichier, plus un index qui liste les fichiers. C'est l'inverse du gros « Brain.md » que vendent les tutos : ce pavé, l'agent le relit en entier à chaque tour, il finit par se contredire, et vous payez du contexte pour rien. Avec une mémoire atomique, l'agent ne charge que la fiche pertinente, et elle grandit avec vous — « ajoute ça à ma mémoire » suffit.

Colle-moi ça dans Claude Code : Template .md ↓ 
Crée un dossier memoire/ et un fichier MEMOIRE.md qui sert d'index. Règle : chaque fait que j'apprends devient un petit fichier de 5 lignes dans memoire/, et MEMOIRE.md garde une ligne par fait. Quand je dis « ajoute ça à ma mémoire », tu écris le petit fichier et tu mets l'index à jour.

LES GARDE-FOUS dans CLAUDE.md

L'humain à la gâchette. C'est le module que les tutos « agent 100% autonome » zappent, et c'est précisément là que ça casse en vrai. Rien ne part, rien ne se dépense, rien ne se supprime sans votre feu vert. Un agent qui envoie un mail à votre place sans validation, ce n'est pas un gain de temps : c'est un incident qui attend son heure. Le pouvoir sans garde-fou n'est pas de la puissance, c'est du risque.

Colle-moi ça dans Claude Code : Template .md ↓ 
Ajoute à mon CLAUDE.md une section « Garde-fous » : n'envoie jamais un mail/message/invitation sans mon accord ; ne fixe aucun prix et ne prends aucun engagement en mon nom ; ne supprime rien sans demander ; les secrets ne sortent jamais nulle part ; dans le doute tu t'arrêtes et tu me poses la question.

LES COMPÉTENCES competences/

Vos playbooks, écrits une fois, rejoués d'un mot. Au lieu de re-dicter la même consigne chaque lundi, vous la figez dans une compétence — un fichier que l'agent ne charge que quand vous le déclenchez. « Fais ma revue de boîte mail », « prépare mes relances », « monte le dossier avant mon rendez-vous » : chacune devient une routine fiable, identique à chaque exécution. C'est ce qui transforme des prompts jetables en un vrai système.

Colle-moi ça dans Claude Code : Template .md ↓ 
Crée un dossier competences/ avec un fichier revue-boite-mail.md : quand je dis « fais ma revue de boîte mail », tu passes en revue mes 7 derniers jours, tu repères les mails qui attendent une réponse de moi, tu prépares un brouillon dans ma voix pour chacun, plus les relances, et tu me rends une liste courte. Tu n'envoies rien.
L'honnêteté, pas la hype

Ça ne remplace pas un cabinet. Ça remplace votre répétition.

Un CLAUDE.md ne fait pas le travail d'un McKinsey, et on ne vous le vendra pas comme ça. Il fait mieux pour votre quotidien : il arrête de vous faire réexpliquer le contexte dix fois par jour. L'agent lit votre boîte, prépare vos relances, tient votre agenda — et rien ne part sans votre feu vert. Vous restez à la gâchette. Ce n'est pas une option de configuration : c'est le principe.

Envie qu'on déploie ça chez vous ?

On ne livre pas un deck. On branche l'agent sur vos vrais outils et on le laisse agir, sous votre contrôle. Commencez petit : une seule tâche, cette semaine.

Découvrir Parrit.ai ↗ Le guide « Démarrer avec Claude Code » ↗
Questions fréquentes

CLAUDE.md : les questions qu'on nous pose vraiment

À quoi sert le fichier CLAUDE.md dans Claude Code ?

CLAUDE.md est un simple fichier texte, posé à la racine de votre dossier de travail, que Claude Code lit automatiquement au début de chaque session. Il contient votre contexte : qui vous êtes, ce que fait votre entreprise, vos règles, votre voix. Sans lui, l'agent repart de zéro à chaque fois ; avec lui, il travaille comme quelqu'un qui vous connaît déjà. C'est le socle sur lequel tout le reste se branche.

Faut-il vraiment 7 fichiers (Soul, Brain, Intuition…) pour un bon agent ?

Non. Sept fichiers séparés, c'est vendeur sur un carrousel, mais en production ça se retourne contre vous : plus de contexte à charger à chaque tour, des règles qui finissent par se contredire d'un fichier à l'autre, et un entretien pénible. La structure qui tient tient en 4 couches : le socle (CLAUDE.md), une mémoire atomique, des garde-fous, des compétences chargées à la demande. Plus simple à maintenir, plus dur à casser.

Comment donner de la mémoire à un agent IA sans exploser le contexte ?

En rangeant un fait par petit fichier plutôt que dans un gros document unique, avec un index qui liste ces fichiers. L'agent ne charge alors que la fiche pertinente au moment où il en a besoin, au lieu de relire tout un pavé qui coûte du contexte et se contredit. C'est le principe de la mémoire atomique : elle grandit avec vous sans jamais devenir un poids mort.

Est-ce risqué de laisser un agent agir sur ma boîte mail ?

Seulement si vous retirez l'humain de la boucle. La bonne pratique, et notre parti pris chez Parrit, c'est que l'agent prépare mais n'envoie jamais sans votre feu vert : rien ne part, rien ne se dépense, rien ne se supprime sans validation. Vous inscrivez ces garde-fous noir sur blanc dans le CLAUDE.md. Bien cadré, un agent sur votre boîte fait gagner des heures sans jamais prendre une décision à votre place.

Faut-il savoir coder pour écrire un CLAUDE.md ?

Non. Un CLAUDE.md, ce sont des phrases en français : votre rôle, vos clients, vos règles. Vous pouvez même demander à Claude Code de vous interviewer pour le remplir, puis de l'écrire à votre place. C'est de la mise par écrit de votre contexte métier, pas de la programmation.

CLAUDE.md, AGENTS.md, .cursorrules : c'est la même idée ?

Oui, c'est la même famille : un fichier de contexte que l'agent lit avant d'agir. Le nom change selon l'outil (CLAUDE.md pour Claude Code, AGENTS.md ou .cursorrules ailleurs), mais le principe est identique — et l'architecture en 4 couches décrite ici s'y transpose telle quelle. Ce qui compte n'est pas le nom du fichier, c'est ce que vous y mettez.

Écrit par , fondateur de Parrit.ai — boutique franco-chinoise qui construit et opère des agents IA sur mesure pour les dirigeants de PME et ETI. On déploie, on ne fait pas que conseiller.