Les fichiers CLAUDE.md sont souvent organisés pour les développeurs, pas pour les modèles d'IA – voici pourquoi cela importe

Un post sur r/ClaudeAI met en lumière un mode de défaillance courant dans les fichiers CLAUDE.md : ils sont structurés autour de ce que le développeur veut documenter, pas de ce dont le modèle a besoin pour décider. Ce sont des problèmes différents.

La structure orientée développeur

Exemple d'un fichier organisé pour le développeur :

## À propos de ce projet
[3 paragraphes de contexte]
## Stack technique
[15 éléments]
## Objectifs
[5 puces]
## Règles Strictes   <- ceci est à la ligne 47

Le modèle lit de manière linéaire. Au moment où il atteint les règles strictes, il a déjà commencé à construire des hypothèses. Si une contrainte est censée remplacer ces hypothèses, le modèle lutte à contre-courant.

Une structure orientée modèle

Le post suggère un modèle mental : demandez-vous « de quoi le modèle a-t-il besoin 3 secondes avant de faire quelque chose d'irréversible ? » Mettez cela en premier. Une meilleure structure :

## Règles Strictes (lisez-les d'abord)
[vos contraintes réelles]
## Contexte actuel
[ce qui est en ligne maintenant]
## Contexte général
[le reste]

Le problème de la longueur

Un CLAUDE.md de 4000 lignes n'est pas organisé — il est archivé. Un fichier archivé n'est pas bien lu. Un fichier organisé est lu rapidement. La clarté bat l'exhaustivité, à chaque fois. L'auteur demande : qu'y a-t-il dans les 20 premières lignes de votre CLAUDE.md ?