Dossier de roman et CLAUDE.md : arborescence et registres

Dans cet article 9 sections

D’abord la conclusion : quatre types de fichiers, des règles dures dans le fichier de règles, un registre mis à jour à chaque chapitre

Claude Code, Cursor et Codex CLI sont à l’origine des outils pour écrire du code, mais de plus en plus d’auteurs s’en servent pour écrire des romans. La raison est concrète : ils lisent et écrivent tout un dossier, une modification peut traverser des dizaines de fichiers, et l’on peut revenir en arrière en cas de casse (Claude Code et Cursor ont des points de contrôle intégrés, la documentation de Codex CLI recommande de créer des points de contrôle avec Git), ce qui convient pour gérer un roman long de plus d’une centaine de fichiers.

Pour écrire un roman avec eux, les pratiques publiques convergent à peu près vers la même méthode :

1. Séparer les quatre types de fichiers : bible, personnages, plans, texte ;
2. Mettre un fichier de règles à la racine (CLAUDE.md pour Claude Code, AGENTS.md pour Codex, fichiers de règles sous .cursor/rules pour Cursor), avec des contraintes dures ;
3. Créer à part un ensemble de registres (état des personnages, amorces, chronologie), mis à jour après chaque chapitre, comme référence unique de « où en est l’histoire maintenant » ;
4. Gérer les versions avec Git ou les points de contrôle de l’outil.

Ci-dessous, point par point, puis quand passer à un logiciel d’écriture. Les pratiques publiques citées ici ont été vérifiées le 11 octobre 2026.

Arborescence : un squelette à recopier

D’après des projets et tutoriels publics, l’arborescence d’un roman long en chinois peut se monter ainsi :

• CLAUDE.md (ou AGENTS.md) : fichier de règles
• bible/ : monde.md, systeme-de-puissance.md, forces.md, lieux.md
• personnages/ : un fichier par personnage important, par exemple lin-yao.md
• plans/ : plan-general.md, plans-de-tome/tome-1.md, plans-de-chapitre/001.md…
• texte/ : 001-nuit-de-pluie.md, 002-entree-en-secte.md…
• registres/ : etat-des-personnages.md, amorces.md, chronologie.md, avancement.md
• style/ : extraits-modeles.md
• archives/ : personnages sortis, anciens lieux

Quelques détails :

• Commencez les noms de fichiers de chapitre par un nombre à trois chiffres. Les titres de chapitres en chinois, triés par ordre alphabétique, partent en désordre ; un article de Juejin sur un roman long écrit avec Cursor mentionne ce problème, et l’auteur a fini par écrire un script pour fusionner les chapitres (source). Un nom comme « 001-nuit-de-pluie.md » l’évite.
• Un fichier ne contient qu’un personnage ou un type de bible. Fichiers petits, l’IA ne lit à chaque fois que ceux dont elle a besoin ; l’auteur de Buckram Studio, partagé sur le forum officiel de Cursor, fait ainsi : pour tel chapitre, il référence tels fichiers (source).
• Séparer ce que l’auteur écrit de ce que l’IA écrit. Un tutoriel CSDN divise l’arborescence en deux moitiés : les contraintes dures tenues par l’auteur (style, bible d’ensemble, personnages centraux, intrigue principale) et le registre tenu par l’IA (état des chapitres, chronologie des personnages, amorces, lignes de personnages), l’IA n’ayant pas le droit de toucher aux premières (source).

Que mettre dans CLAUDE.md : seulement ce qu’il faut respecter à chaque fois

Le fichier de règles s’applique selon les règles de chargement de chaque outil ; plus il est long, plus il occupe de contexte, donc il doit rester court, avec seulement des contraintes dures. On peut y mettre ces points :

• Une phrase de présentation du livre : genre, point de vue, lectorat visé ;
• Les fichiers à lire avant d’écrire un chapitre : plan du chapitre, fiches des personnages présents, état des personnages dans le registre, texte des deux chapitres précédents ;
• Règles d’écriture dures : personne et point de vue, fourchette de longueur par chapitre, formules et tournures interdites ;
• Ce qu’il faut faire après chaque chapitre : mettre à jour les quatre registres : état des personnages, amorces, chronologie, avancement ;
• Fichiers à ne pas modifier : la bible et les fiches de personnage ne sont modifiées que par l’auteur, l’IA liste les conflits qu’elle trouve sans rien modifier de son propre chef ;
• En cas de conflit, qui fait foi : les faits déjà écrits dans le texte priment sur le plan, le registre suit le chapitre le plus récent.

Il faut rester sobre sur la taille. Prenons Codex : la documentation officielle indique que la taille cumulée de AGENTS.md est plafonnée par défaut à 32 KiB (source) ; Codex recommande de mettre les règles obligatoires dans AGENTS.md, sans compter seulement sur la fonction de mémoire (source) ; la documentation de Cursor précise aussi que le modèle ne garde pas de mémoire entre deux complétions, les règles servant à fournir un contexte persistant (source).

Les registres : ce qui décide si un roman long peut se poursuivre

Le fichier de règles gère « comment écrire », les registres gèrent « où on en est ». Dans les projets publics, les pratiques les plus mûres tiennent en trois points :

• Une seule source de faits. oh-story-claudecode met le suivi d’état dans un seul fichier, source principale de l’état structuré, avec en plus un résumé « contexte » aux rubriques fixes et à taille plafonnée (source). webnovel-writer sépare aussi plan général, plans de tome, chronologie, plans de chapitre et index d’état (source).
• Noter séparément « ce que sait l’auteur » et « ce que sait le lecteur ». oh-story-claudecode le fait pour empêcher un personnage de connaître la réponse trop tôt.
• Mettre à jour après chaque chapitre. État des personnages (où, blessures, force, ce qu’il sait), amorces (posée à quel chapitre, à refermer quand), chronologie (combien de jours écoulés dans le livre). Sur Reddit, un auteur qui a fini un roman long de 300 000 mots avec Claude a consigné pour chaque personnage « ce qu’il sait à chaque moment », et fait faire à Claude Code des contrôles de continuité sur une centaine de fichiers (source).

Versions : en plus des points de contrôle, Git

• Claude Code crée automatiquement un point de contrôle à chaque invite, on peut revenir avec /rewind, la documentation officielle indique que les 100 derniers sont conservés (source).
• Les points de contrôle de Cursor sont stockés en local, séparés de Git, la documentation recommande Git pour la gestion de versions à long terme (source).
• La documentation de Codex CLI recommande de créer des points de contrôle Git avant et après les tâches, pour pouvoir revenir en arrière (source).

L’habitude la plus sûre : un commit Git après chaque chapitre, avec le numéro de chapitre dans le message.

Problèmes récurrents dans les pratiques publiques

En rassemblant ces tutoriels et discussions publics, quelques problèmes reviennent souvent :

• Conversation longue, ça devient « flou ». L’auteur de Buckram Studio mentionne qu’une conversation de deux cents messages entraîne une dégradation du contexte, une hausse des coûts, des répétitions et un texte quelconque (source) ; l’article de Juejin dit aussi qu’elle « oublie souvent la bible du roman ».
• Dérive des personnages et du style. La formule du tutoriel CSDN : « les pouvoirs du héros fluctuent, on dirait un autre » ; l’auteur de Reddit mentionne qu’au chapitre 80, le rythme du chapitre 12 n’y était plus, il fallait redonner sans cesse des extraits modèles.
• Consommation et coûts. Faire fusionner les fichiers un par un par l’IA épuise vite le quota (source).
• Barrière pour les non-programmeurs. Le même article dit que VS Code « sonne effrayant » pour un non-programmeur ; un autre article estime qu’il n’y a pas besoin de diplôme d’informatique pour s’y mettre, tout en jugeant que la plupart des auteurs utiliseront surtout l’interface de chat (source).

Ces problèmes ont des parades : fichiers petits, registre mis à jour à chaque chapitre, ne lire à chaque chapitre que les fichiers nécessaires, ouvrir régulièrement une nouvelle conversation. Le prix : l’auteur doit concevoir lui-même l’arborescence, rédiger les règles, tenir le registre, regarder les comparaisons de fichiers.

Quand passer à un logiciel d’écriture de roman

L’agent de programmation vous donne le contrôle total : fichiers en local, structure à votre main, changer de modèle ou d’outil est facile. Pour un auteur qui aime ce mode et connaît le terminal et Git, c’est un excellent choix pour écrire un roman.

Dans les cas suivants, on peut envisager un logiciel d’écriture dédié :

• Le temps passé à tenir registres et fichier de règles commence à dépasser celui passé à écrire le texte ;
• On ne connaît pas le terminal ni Git, et chaque comparaison de modifications demande de réfléchir à la comparaison de fichiers ;
• On veut écrire à tout moment sur le web ou le téléphone, sans être attaché à un seul ordinateur ;
• On veut voir des fiches de personnage, un sommaire, une liste d’amorces, plutôt qu’un tas de fichiers Markdown ;
• Conditions de réseau ou de compte limitées. Par exemple, la liste officielle des régions prises en charge par Claude n’inclut pas la Chine continentale, cette limite couvrant Claude.ai, Claude Code et l’API (source).

Ce que Maliang Writer automatise

L’arborescence, les règles et les registres ci-dessus correspondent chez Maliang Writer à ceci :

• Chacun des quatre types de fichiers a sa place. Personnages, bible, amorces, lignes narratives sont des fiches dans la barre latérale de la bible de l’histoire à gauche ; le plan général est rangé à part ; échantillons de style et matériaux d’ouverture sont des documents dans « Documents ». L’IA lit au besoin en écrivant, vous voyez des fiches et un sommaire, sans avoir à tenir un dossier.
• Les registres sont tenus par l’archiviste. Une fois un chapitre écrit, ce passage d’écriture terminé, l’archiviste remet en ordre les archives de l’histoire d’après le texte : état des personnages, relations, positions, amorces. Ce qui ne colle pas avec la bible est listé dans « À confirmer », vous décidez de quel côté corriger. Si vous n’en voulez pas, vous pouvez le désactiver dans « Archives ».
• Comparaison et annulation dans l’éditeur. Le texte modifié par l’IA affiche directement suppressions et ajouts, à garder ou rétablir un à un ; si cela ne convient pas, on peut annuler l’échange, ouvrir une branche avant cet échange, ou modifier puis renvoyer. La branche et la conversation d’origine partagent le même manuscrit.

• Le texte est confié à l’agent rédacteur. À la suite, l’agent rédacteur ne reçoit que le matériel nécessaire à ce chapitre : plan du chapitre, bible des personnages concernés, texte précédent, échantillon de style.
• Ranger l’ancienne bible par tome. En écrivant un nouveau tome, les personnages, lieux et amorces qui ne sont apparus que dans les premiers tomes sont rangés aux archives, l’IA ne s’y réfère plus pour écrire un nouveau chapitre, on peut toujours les retrouver au besoin.
• Utilisable directement sur le web, sans installation.

Pour une comparaison détaillée des deux approches, voir Claude Code et Maliang Writer comparés, Agent de programmation ou logiciel d’écriture de roman : comment choisir et Dossier ou écriture structurée : comment choisir.

Questions fréquentes

Q : Claude Code peut-il écrire un roman ?
Oui. Il lit et écrit tout un dossier, modifie à travers les fichiers, ses points de contrôle intégrés permettent de revenir en arrière, et des auteurs ont déjà fini des romans longs en utilisant Claude pour le texte et Claude Code pour les contrôles entre fichiers. C’est à vous de concevoir l’arborescence, d’écrire CLAUDE.md, de tenir les registres d’état des personnages et d’amorces.

Q : Que mettre dans CLAUDE.md ?
Seulement ce qu’il faut respecter à chaque fois : la présentation en une phrase du livre, les fichiers à lire avant d’écrire un chapitre, les règles d’écriture dures, les registres à mettre à jour après chaque chapitre, les fichiers que l’IA n’a pas le droit de modifier, qui fait foi en cas de conflit. Restez bref.

Q : Comment régler les règles pour écrire un roman avec Cursor ?
Créez des fichiers de règles sous le dossier .cursor/rules du projet, en y écrivant les fichiers à lire et les règles dures ; on peut aussi utiliser AGENTS.md. Découpez bible et personnages en petits fichiers, référencez ceux du chapitre à écrire. Les points de contrôle de Cursor sont stockés en local, la documentation recommande Git pour les versions à long terme.

Q : Codex CLI peut-il écrire un roman ?
Oui, la méthode est proche de celle de Claude Code : règles dans AGENTS.md, bible, plans et texte organisés par dossiers. La documentation indique que la taille cumulée de AGENTS.md est plafonnée par défaut à 32 KiB, les règles doivent donc être concises.

Q : Faut-il savoir programmer pour écrire un roman avec Claude Code ?
Pas besoin d’écrire du code, mais il faut être à l’aise avec le terminal ou un éditeur, comprendre un peu la gestion de fichiers et de dossiers ; savoir gérer les versions avec Git est plus pratique. Pour qui ne connaît pas du tout ces outils, il y a une période d’adaptation.

Q : Peut-on utiliser Claude Code en Chine ?
La liste officielle des régions prises en charge par Claude n’inclut pas la Chine continentale, cette précision couvrant Claude.ai, Claude Code et l’API. Se référer à la page officielle pour les détails.

Q : Quand passer d’un agent de programmation à un logiciel d’écriture ?
Quand le temps passé à tenir registres et règles dépasse celui passé à écrire le texte, quand on ne veut pas du terminal ni de Git, quand on veut écrire sur le web ou le téléphone, ou qu’on préfère voir des fiches plutôt que des fichiers, on peut envisager un logiciel d’écriture de roman dédié.