Le CLAUDE.md de ma chaîne : ce qu'il contient, ce qu'il m'évite

Le projet derrière le fichier

Ma chaîne « tips dev » tient dans un seul dossier : D:\Stream\Dev. Elle produit des shorts verticaux pour TikTok, Instagram et YouTube, à partir de fiches texte. Pas de tournage : une fiche rédigée devient une page HTML animée, puis une vidéo. Toute la chaîne est racontée dans la formation Ma chaîne de vidéos pilotée par Claude Code.

Le projet a démarré le 18 septembre 2026. Moins de deux semaines plus tard, il compte plus de 250 shorts, des vidéos de promo narrées, des carrousels et un premier tuto YouTube. Je travaille souvent avec plusieurs sessions Claude Code ouvertes en même temps. Toutes démarrent en lisant le même fichier : D:\Stream\Dev\CLAUDE.md.

Voici ce qu'il contient, extrait par extrait.

Une phrase qui fixe le cap

Le fichier s'ouvre sur le principe du projet :

**Principe directeur : le client fournit du texte, Claude génère tout le reste.** Pas de rush, pas de tournage, pas d'enregistrement par short.

Cette phrase répond d'avance à une foule de questions. Quand Claude hésite entre me demander d'enregistrer quelque chose et le générer lui-même, la réponse est déjà écrite, dès la première ligne qu'il lit.

Des règles qui protègent

Mon public est fait de développeurs. Un exemple de code faux, et les commentaires me le font payer. D'où cette règle :

**Ne jamais produire depuis une fiche non `valide`.** **Tout extrait de code doit avoir été réellement exécuté** et la sortie affichée doit être la sortie réelle (`code_verifie: true`) — public de développeurs, une erreur se paie en commentaires.

Regarde la fin : la règle donne sa raison. La raison aide Claude à trancher un cas que la règle n'avait pas prévu. C'est aussi ce que l'outil de ménage de Claude Code garde en priorité quand il raccourcit un CLAUDE.md : les pièges et leurs raisons.

Autre règle, née de mes sessions en parallèle :

Le client fait souvent tourner plusieurs sessions en parallèle sur ses projets : ne commiter que les fichiers de sa propre étape (`git add <chemins>`, pas `git add -A` à l'aveugle), et ne jamais annuler ni écraser des modifications qu'on n'a pas faites soi-même.

Sans elle, une session pourrait embarquer dans son commit le travail à moitié fini d'une autre.

Chaque erreur devient une ligne

Mon fichier garde la trace des erreurs qui m'ont coûté cher. Celle-ci, par exemple (raccourcie) :

**Leçon du 2026-09-19 — l'identifiant fait loi** : un ID doit avoir **trois segments** `<TECHNO>-<SERIE>-<NN>`. La série avait été créée en `SQL-01` : le cockpit ne la détectait pas du tout [...], donc 10 shorts invisibles pour le client. Renommée en `SQL-PIE-01..10`, ce qui a coûté un re-rendu complet

Dix vidéos à refaire pour un nom mal formé. Depuis que la règle est écrite, chaque session la lit avant de créer quoi que ce soit.

Il y a aussi les pièges techniques, ceux qu'aucune lecture du code ne révèle :

dans le workdir lancer `npx --yes hyperframes@0.8.47 ...` (le `package.json` s'appelle `hyperframes`, `npx hyperframes` échoue)

Claude ne peut pas deviner ça seul. Il l'aurait découvert en échouant, à chaque session. Une ligne suffit à l'éviter.

Il décrit aussi comment je travaille

La fin du fichier ne parle pas du code, mais de moi :

- Il dicte ses messages à la voix (Win+H) : phrases longues, hésitations, mots parfois mal transcrits — reformuler l'intention plutôt que buter sur la lettre.
- Il délègue les décisions de structure : proposer un plan concret et l'exécuter, ne poser une question que pour ce qu'il est seul à savoir.

Ces deux lignes règlent le ton des échanges. Claude cherche l'intention derrière un mot mal transcrit, et il garde ses questions pour ce que je suis seul à savoir.

Ce qu'il m'évite

Je n'ai pas de mesure fiable du temps gagné, donc je ne t'inventerai pas de chiffre. Mais le changement se voit tous les jours :

• je ne réexplique plus le projet : chaque session lit l'état du projet et reprend là où la précédente s'est arrêtée ;
• mes sessions parallèles appliquent les mêmes règles, sans que je les répète à chacune ;
• une erreur payée une fois ne se repaie pas.

Et là où il a dérapé

Maintenant, la partie moins flatteuse. La documentation conseille de viser moins de 200 lignes par CLAUDE.md. Le mien en fait 190. Sur le papier, tout va bien.

Sauf qu'il contient 9 763 mots, environ 65 Ko. Le CLAUDE.md de la plateforme de formations, lui, fait 64 lignes et 602 mots. Une ligne du fichier de la chaîne compte en moyenne 51 mots, contre 9 pour l'autre. La raison : dans sa section « État du projet », chaque ligne est un paragraphe entier, et l'historique s'empile au lieu d'être remplacé.

Pire : il se contredit. Trois lignes datées parlent de YouTube, et les trois sont encore dans le fichier :

YOUTUBE S'AJOUTE AUX SHORTS DEV (décision du client, 2026-09-19) [...] sur la chaîne « Latshow »
YouTube en pause pour le dev depuis le 2026-09-24
Le dev a maintenant sa chaîne YouTube « linedev »

La documentation prévient : si deux règles se contredisent, Claude peut en choisir une au hasard. Et le titre de la section annonce « mis à jour le 2026-09-19 » alors qu'elle contient des décisions du 29.

Ce que la suite t'apporte

Tu as vu le résultat et ses limites. La suite de la formation te donne la méthode pour obtenir le premier sans subir les secondes.

Dans « Bien ranger », tu apprends où chaque consigne doit vivre et dans quel ordre Claude les lit. Tu pars d'un premier jet propre avec /init, puis tu découpes : des imports @ pour organiser, et des règles qui ne se chargent que lorsque Claude touche aux fichiers concernés.

Dans « Une mémoire qui vit », tu découvres les notes que Claude prend tout seul (j'en avais 39 sur ce seul projet en préparant la formation) et comment les relire. Tu vois le montage @AGENTS.md qui sert à la fois Claude et Codex, avec sa limite. La dernière leçon applique la méthode d'entretien à ce fichier de 9 763 mots : le plan pour qu'il redevienne court sans rien perdre d'important.

Sources : How Claude remembers your project, pour la taille conseillée et les règles qui se contredisent, vérifiée le 19 octobre 2026.