Votre CLAUDE.md
ne suffit pas
Vous avez écrit un CLAUDE.md. Pendant deux semaines, l'assistant a enfin su qui vous étiez. Puis il a recommencé à ignorer des consignes qui sont pourtant écrites noir sur blanc dedans. Le problème n'est pas dans le fichier. Il est dans ce que personne ne vous a dit de ranger autour.
Le seul fichier dont vous êtes sûr qu'il sera lu
Un CLAUDE.md est un fichier texte posé à la racine de votre dossier de travail. Claude le charge en entier, tout seul, avant votre premier mot, à chaque conversation. C'est sa force et c'est toute sa fragilité, parce que ce privilège a un plafond, et que le plafond ne prévient pas quand il est atteint. Le mécanisme exact est le sujet de la page mémoire Claude Code, et le principe général celui du context engineering. Cette page-ci traite d'autre chose, de la seule question qui reste une fois le principe compris : concrètement, on écrit quoi, dans quels fichiers, rangés comment.
Le test qui tranche tient en une question. Est-ce que votre fichier grandit quand vous apprenez un fait ordinaire ? Si oui, il finira par déborder, et ce sont vos règles les plus anciennes qui sortiront du champ, en silence. Un fichier qui ne grandit pas est un fichier qui a laissé les faits ailleurs.
Des règles dedans, des faits dehors
C'est la seule distinction qui compte, et elle explique presque tous les CLAUDE.md qui cessent de fonctionner. Une règle reste vraie des mois. Un fait vieillit sans prévenir, et un fait périmé dans un fichier chargé d'office ne se contente pas d'être inutile, il induit activement en erreur.
Ce qui reste vrai
Qui vous êtes et ce que vous vendez. Comment vous voulez qu'on vous parle. Ce qui ne se fait jamais sans votre accord. Vos interdits d'écriture. Et l'adresse du reste.
Ce qui vieillit
Un montant, un statut de dossier, qui est client et qui ne l'est plus, l'état d'un chantier, une échéance. Tout cela est vrai aujourd'hui et faux dans trois semaines.
Un CLAUDE.md discipliné se stabilise autour d'une taille et n'en bouge plus, parce que le nombre de règles vitales d'un métier est fini. Le reste part dans un dossier à côté, une fiche par sujet, et c'est là que commence le vrai travail.
Une fiche, un fait, jamais deux
La tentation est de faire un fichier par thème et d'y empiler ce qui s'y rapporte. Elle se paie deux fois. Un fichier qui contient six sujets est ouvert pour un seul et les cinq autres entrent quand même dans la conversation. Et le jour où l'un des six devient faux, personne ne sait lequel corriger sans relire les six.
--- name: jamais-deployer-sans-accord description: Aucune mise en ligne sans un accord écrit, même pour une correction d'une ligne. Incident du 14 mars. type: correction --- # La règle Rien ne part en ligne sans que je l'aie dit explicitement. ## Pourquoi Le 14 mars, une correction « évidente » est partie seule et a cassé le tunnel de commande pendant deux heures un samedi. Mot pour mot ce jour-là : « je n'ai jamais dit de publier ». ## Comment l'appliquer Préparer, montrer, attendre le mot. Un « ok » sur autre chose ne vaut pas accord de publication.
Quatre blocs, toujours les mêmes. Un nom. Une description. La règle. Le pourquoi, avec la date et la phrase exacte. Le comment. Le pourquoi est la partie que tout le monde saute, et c'est la seule qui permette de trancher un cas nouveau que la règle n'avait pas prévu. Une règle sans son incident est un ordre, et un ordre ne couvre que le cas exact. Une règle avec son incident est un principe, et un principe se transpose.
La ligne de description décide de tout
Voilà la partie que presque personne n'écrit, et sans laquelle le reste ne sert à rien. L'assistant ne lit pas vos trente fiches. Il lit un index d'une ligne par fiche, et il choisit laquelle ouvrir uniquement sur la foi de sa description. Cette phrase n'est pas de la documentation. C'est un aiguillage, et c'est le seul.
Une question, une ligne d'index qui correspond, un fichier ouvert. Rien d'approximatif n'entre dans la réponse.
Une description ratée rend une fiche invisible, et une fiche invisible est pire qu'une fiche absente, parce que vous croyez la règle en place. Écrivez-la pour quelqu'un qui ne connaît pas le sujet et doit choisir entre trente fiches en une seconde. « Notes sur la facturation » ne dit rien. « Aucune mise en ligne sans accord écrit, incident du 14 mars » se choisit tout seul.
| Ce qu'on écrit spontanément | Ce qui aiguille vraiment |
|---|---|
| Notes sur la facturation | Numérotation des factures, jamais de numéro sauté, une seule source qui l'attribue |
| Règles de ton | Vouvoiement partout, aucun tiret long, aucun mot d'anglais évitable |
| Client Durand | Durand, contrat signé en mai, interlocuteur unique, ne jamais écrire à son associé |
La colonne de gauche décrit un sujet. La colonne de droite décrit une décision. Un sujet ne permet de choisir qu'entre des fiches qui parlent de choses très différentes ; dès que vous en avez trois sur la facturation, il ne sert plus à rien. Une décision se reconnaît même au milieu de trente lignes. La règle pratique tient en une phrase : si la description pourrait coiffer deux fiches différentes, elle est à réécrire.
C'est aussi la réponse à une question qu'on me pose souvent. Pourquoi ça bat une recherche par proximité de sens sur un corpus que vous entretenez à la main ? Parce qu'une recherche par nom rend une réponse exacte et un fichier entier, là où une recherche par proximité rend un morceau approchant. Sur quelques mégaoctets rangés, l'exact gagne à tous les coups. Sur des milliers de documents que personne n'a rangés, la conclusion s'inverse.
À quoi ça ressemble une fois posé
Trois niveaux, pas un de plus. Le fichier chargé d'office, l'index qui aiguille, les fiches qu'on va chercher. Et un dossier par projet, parce que mélanger deux métiers dans une même mémoire, c'est fabriquer les contradictions que vous passerez vos soirées à démêler.
CLAUDE.md chargé d'office · règles seulement memoire/ INDEX.md chargé d'office · une ligne par fiche identite.md qui je suis, le durable jamais-deployer-....md une correction ton-et-interdits.md une correction acces-outils.md une référence client-durand.md un dossier en cours projets/ boutique/ CLAUDE.md les règles de CE projet memoire/INDEX.md son propre index, cloisonné comptabilite/ CLAUDE.md memoire/INDEX.md
Le cloisonnement n'est pas du rangement, c'est une protection. Une règle de la boutique qui contredit une règle de la comptabilité ne se rencontrent jamais si elles vivent dans deux silos. Dans un dossier commun, elles se rencontrent au pire moment, et c'est l'assistant qui tranche à votre place, sans vous le dire.
Deux plafonds à surveiller, et ils sont mécaniques, pas moraux. Le CLAUDE.md et l'index sont chargés d'office, donc ils sont tous les deux plafonnés. Le jour où l'index déborde, sa fin est coupée en silence et toutes les fiches qui y figuraient deviennent invisibles d'un coup. C'est la panne la plus vicieuse du dispositif, parce que rien ne change en apparence. Mesurez la taille de ces deux fichiers, ne l'estimez pas.
Les trois fichiers de départ
Vous n'avez pas besoin d'un outil, ni d'un abonnement, ni de savoir écrire une ligne de code. Vous avez besoin de trois fichiers texte et de dix minutes pour le premier. Les voici, remplis d'exemples à remplacer, avec le mode d'emploi.
Un conseil sur l'usage, et il compte plus que le kit lui-même. Ne remplissez pas le dossier d'avance. Une fiche s'écrit le jour où vous vous entendez répéter une correction pour la deuxième fois, jamais avant. Un dossier rempli en une soirée est un dossier de règles que personne n'a vérifiées, et vous ne saurez plus lesquelles servent.
Ce qui vient après le rangement
Une fois les fichiers en place, deux questions arrivent toujours. Que faire quand la même règle est enfreinte malgré tout, et comment savoir si tout ça change vraiment quelque chose. Les deux sont traitées sur la page mémoire Claude Code, avec le compteur de récidive, le moment où une règle doit devenir un mécanisme, et la mesure qui vérifie non pas que vos règles sont écrites, mais qu'elles changent le comportement.
Ce qui se passe si vous ne faites que ça
Le premier jour, vous écrivez le CLAUDE.md et vous ne voyez presque rien : l'assistant arrête simplement de vous redemander qui vous êtes. Le vrai basculement arrive plus tard, le jour où vous vous entendez répéter une correction et où, au lieu de la redire, vous l'écrivez. À partir de là chaque agacement devient une fiche, chaque fiche devient une ligne d'index, et le système se met à tenir la rigueur à votre place les jours où vous êtes fatigué. C'est tout le mécanisme, et il n'y en a pas d'autre.
Et si vous préférez qu'on regarde vos dossiers plutôt que de lire, c'est exactement le sujet des journées de formation et de mon travail avec les équipes chez TimeKraft : on part de vos vrais fichiers, et vous repartez avec la mémoire construite sur votre métier, pas sur un exemple.
Donner une mémoire à votre IA
Pour que votre assistant cesse de vous faire répéter, et cesse de refaire les mêmes erreurs. Sans savoir programmer.
- →Les huit règles, chacune avec le dégât qui l'a provoquée.
- →Les trois modèles de fichiers, prêts à recopier.
- →La grille de mesure, pour savoir si votre mémoire tient.
Une adresse, rien d'autre. Le document arrive dans l'instant, puis cinq courriels sur onze jours pour vous aider à l'appliquer. Désinscription en un clic, adresse jamais transmise.