Idée principale

Quand on travaille sur un sujet long avec Claude Code en laissant l'assistant écrire dans un fichier Markdown, la question qui finit par se poser n'est pas la taille du fichier, c'est pour qui il est rangé.

Un assistant a besoin de repères de reprise : où le travail s'est arrêté, quelles décisions ont été prises, où retrouver une source. Il lui faut des sections stables, des identifiants, des états. Un product manager qui relit le même fichier cherche autre chose : agréger l'information, la valider, la redécouper par thème ou par niveau de risque pour arbitrer. Ce ne sont pas deux présentations d'une même structure, ce sont deux structures.

Tenir les deux dans un seul fichier ne produit donc pas un compromis, mais un document que chacun des deux lecteurs doit traverser en ignorant la moitié. Dédoubler le fichier — un pour l'assistant, un pour l'humain — repousse le problème sans le résoudre : les deux enflent, et chacun finit par contenir un peu de tout, des sources, des décisions, des hypothèses et des directives mêlées dans le même flux. Le découpage qui tient ne se fait pas par destinataire, il se fait par nature de contenu.

Pourquoi c'est important

Cela identifie l'étape que l'on saute quand on passe du fichier unique au système de fichiers. On croit d'abord avoir un problème de volume, on croit ensuite avoir un problème de public ; c'est en réalité un problème de types d'objets, et tant qu'on ne l'a pas vu, on multiplie des fichiers qui redeviennent tous des fourre-tout.

Cela donne aussi un critère de relecture simple pour un document de travail partagé avec un assistant : demander à qui sert chaque section, et compter combien en servent deux.

Nuances et limites

Un document court échappe à la règle. Tant qu'un fichier se lit en entier en une minute, le désordre ne coûte rien, et l'imposer une structure coûte plus que ce qu'il rapporte.

Et la séparation a un prix : deux structures à tenir se désynchronisent, et l'une des deux finit par ne plus être relue.

Questions ouvertes

• Comment vérifier que la version destinée à l'humain n'est pas restée en arrière de celle que l'assistant met à jour à chaque session ?