Папка романа и CLAUDE.md: каталоги и реестры для кодинг-агентов

Содержание 9 разделов

Сначала вывод: папки в четыре класса, файл правил — жёсткие ограничения, реестры обновлять каждую главу

Claude Code, Cursor, Codex CLI изначально инструменты для написания кода, но всё больше авторов пишут ими романы. Причина практическая: они читают и пишут всю папку, одна правка может охватить десятки файлов, а при порче есть способы откатиться (у Claude Code и Cursor встроены контрольные точки, Codex CLI официально рекомендует создавать контрольные точки через Git), — подходят для управления книгой из сотен файлов.

При письме романов в них публичная практика сходится примерно к одному набору приёмов:

1. Файлы библии, персонажей, плана и текста лежат раздельно;
2. В корне — файл правил (у Claude Code CLAUDE.md, у Codex AGENTS.md, у Cursor — файлы правил в .cursor/rules), в нём жёсткие ограничения;
3. Отдельный набор реестров (состояние персонажей, заделы, хронология), обновляется после каждой главы как единая опора для «докуда дошла история»;
4. Версии ведутся через Git или встроенные контрольные точки.

Ниже — по пунктам, в конце — когда удобнее перейти на программу для письма. Публичные практики, упомянутые в статье, сверены на 2026-10-11.

Структура папок: каркас, который можно копировать

По публичным проектам и руководствам каталог китайского длинного романа можно строить так:

• CLAUDE.md (или AGENTS.md): файл правил
• библия/: мир.md, система-силы.md, фракции.md, места.md
• персонажи/: на каждого важного персонажа по файлу, например Линь-Яо.md
• план/: общий-план.md, планы-томов/том-1.md, планы-глав/001.md…
• текст/: 001-ночной-дождь.md, 002-вступление.md…
• реестры/: состояние-персонажей.md, заделы.md, хронология.md, прогресс.md
• стиль/: образцы-фрагментов.md
• архив/: ушедшие персонажи, старые места

Несколько деталей:

• Имена файлов глав начинайте с трёх цифр. Китайские названия глав при сортировке по алфавиту путаются; об этой проблеме упоминала статья на Juejin об использовании Cursor для длинного романа, в итоге пришлось писать скрипт для склейки глав (источник). Имена вроде «001-ночной-дождь.md» это обходят.
• В одном файле — один персонаж или один вид настроек. Файлы маленькие, ИИ каждый раз читает только нужные; автор, поделившийся на официальном форуме Cursor проектом Buckram Studio, делает именно так: пишет главу — ссылается на нужные файлы (источник).
• Написанное автором и написанное ИИ — раздельно. Одно руководство на CSDN делит каталог на две половины: жёсткие ограничения, которые ведёт автор (стиль, общая библия, ключевые персонажи, основная линия), и реестры, которые ведёт ИИ (состояние глав, хронология персонажей, заделы, линии героев); первое ИИ менять не разрешается (источник).

CLAUDE.md: что писать — только то, что нужно соблюдать каждый раз

Файл правил действует по правилам загрузки каждого инструмента; чем он длиннее, тем больше занимает контекста, поэтому он должен быть коротким, только жёсткие ограничения. Можно включить такие пункты:

• Одно предложение о книге: жанр, точка зрения, целевой читатель;
• Файлы, обязательные перед написанием главы: план этой главы, карточки действующих лиц, состояния персонажей из реестра, текст двух предыдущих глав;
• Жёсткие правила письма: лицо и точка зрения, диапазон знаков на главу, запрещённые штампы и обороты;
• Что обязательно сделать после главы: обновить четыре реестра — состояние персонажей, заделы, хронологию, прогресс;
• Файлы, которые менять нельзя: библию и карточки персонажей меняет только автор, при обнаружении конфликта ИИ перечисляет их, не правя самовольно;
• При конфликте — кто главнее: факты, уже написанные в тексте, важнее плана, реестр — по последней главе.

По объёму нужно сдерживаться. На примере Codex: в официальной документации сказано, что суммарный размер AGENTS.md по умолчанию ограничен 32 KiB (источник); Codex официально рекомендует правила, обязательные к исполнению, класть в AGENTS.md, а не полагаться только на функцию памяти (источник); в документации Cursor тоже сказано, что между двумя дополнениями модель не сохраняет память, и правила служат для предоставления постоянного контекста (источник).

Реестры: ключ к тому, чтобы длинный роман можно было дописать

Файл правил отвечает на вопрос «как писать», реестры — «докуда дошли». В публичных проектах более зрелые подходы — три:

• Только один источник фактов. oh-story-claudecode хранит отслеживаемое состояние в одном файле как источник структурированного состояния, плюс отдельное краткое «контекстное» резюме с фиксированными разделами и ограничением по размеру (источник). webnovel-writer так же раздельно хранит общий план, планы томов, хронологию, планы глав и индекс состояний (источник).
• «Что знает автор» и «что знает читатель» записывают раздельно. oh-story-claudecode делает так, чтобы персонаж не узнал ответ заранее.
• Обновлять после каждой главы. Состояние персонажей (где, ранения, сила, что знает), заделы (в какой главе заложен, когда закрыть), хронология (сколько дней прошло в книге). Автор на Reddit, написавший с Claude длинный роман на 300 000 слов, записал для каждого персонажа «что он знает в разные моменты времени» и поручил Claude Code проверять непрерывность по сотням файлов (источник).

Версии: помимо контрольных точек нужен Git

• Claude Code при каждом запросе автоматически создаёт контрольную точку, можно откатываться через /rewind, в официальной документации сказано, что хранятся последние 100 (источник).
• Контрольные точки Cursor хранятся локально, отдельно от Git; официально для долгосрочного управления версиями рекомендуется Git (источник).
• Codex CLI официально рекомендует создавать контрольные точки Git до и после задачи, чтобы можно было откатиться (источник).

Поэтому надёжная привычка — после каждой главы делать коммит Git, в сообщении указывая номер главы.

Повторяющиеся в публичной практике проблемы

Обобщая эти публичные руководства и обсуждения, чаще всего встречаются такие проблемы:

• Чем длиннее диалог, тем он «мутнее». Автор Buckram Studio упоминает, что в длинном диалоге из двухсот сообщений наблюдаются деградация контекста, рост затрат, повторы и бессодержательный текст (источник); в статье на Juejin также сказано, что часто «забывается библия романа».
• Дрейф образов и стиля. Дословно в руководстве на CSDN: «сила героя то сильная, то слабая, будто подменили человека»; автор на Reddit упоминает, что к главе 80 уже нет ритма главы 12 и приходится снова и снова давать образцы фрагментов.
• Расход и стоимость. Если просить ИИ склеивать файлы по одному, квота быстро кончается (источник).
• Порог для непрограммистов. В той же статье сказано, что VS Code для непрограммистов «звучит пугающе»; другая статья считает, что осваивать можно и без диплома по информатике, и одновременно предполагает, что большинство авторов будут в основном пользоваться чат-интерфейсом (источник).

Для этих проблем есть способы смягчения: дробить файлы, обновлять реестры каждую главу, на каждую главу читать только нужные файлы, периодически открывать новый диалог. Цена — автору самому придётся проектировать каталог, писать правила, вести реестры, смотреть сравнение файлов.

Когда переходить на программу для письма романов

Агенты для программирования дают полный контроль: файлы локально, структуру определяете Вы, модели и инструменты легко менять. Авторам, которым нравится этот способ и знакомы терминал и Git, писать ими романы — отличный выбор.

В таких случаях можно подумать о переходе на специальную программу для письма:

• время на ведение реестров и файлов правил начало превышать время на написание текста;
• нет привычки к терминалу и Git, и при каждом просмотре правок приходится разбираться в сравнении файлов;
• хочется писать в браузере или на телефоне в любой момент, не привязываясь к одному компьютеру;
• хочется видеть карточки персонажей, оглавление, список заделов, а не груду файлов Markdown;
• ограничены сеть или аккаунт. Например, в официальном списке поддерживаемых регионов Claude нет материкового Китая, и это ограничение распространяется на Claude.ai, Claude Code и API (источник).

Что в Maliang Writer автоматизировано

Вот как каталог, правила и реестры выше соответствуют Maliang Writer:

• У четырёх классов файлов есть свои места. Персонажи, библия, заделы, сюжетные линии — карточки в левой панели библии; общий план хранится отдельно; образцы стиля и материалы запуска книги — документы в разделе «Документы». ИИ при письме читает по мере необходимости, Вы видите карточки и оглавление, папки вести самим не нужно.
• Реестры ведёт архивист. После главы, когда этот отрезок письма закончен, архивист приводит в порядок архивы истории по тексту: состояние персонажей, отношения, положения, заделы. Расхождения с существующей библией попадают в «На подтверждение», решаете Вы, в чью сторону править. Если не нужно, можно отключить в «Архивы».
• Сравнение и откат — в редакторе. Текст, правленный ИИ, прямо помечает удаления и добавления, можно оставлять или отклонять по одному; если не понравилось, можно отменить текущий раунд, начать ветку до этого раунда или отправить повторно после правки. Ветка и исходный диалог делят одну рукопись.

• Текст поручается агенту-автору. При продолжении агент-автор получает только материалы, нужные для этой главы: план главы, связанные настройки персонажей, предыдущий текст, образцы стиля.
• Старые записи библии убираются по томам. При письме нового тома персонажи, места, заделы, бывшие только в предыдущих томах, уходят в архив, ИИ при письме новой главы их больше не учитывает, при необходимости их можно найти.
• Работает прямо в браузере, ставить не нужно.

Подробное сравнение двух подходов — в сравнении Claude Code и Maliang Writer, как выбрать между агентом для программирования и программой для письма романов и как выбрать между папками и структурированным письмом.

Частые вопросы

В: Может ли Claude Code писать романы?
Может. Он читает и пишет всю папку, правит по файлам, есть встроенные контрольные точки для отката; уже есть авторы, которые писали текст с Claude и делали сквозные проверки с Claude Code, завершив длинный роман. Нужно самим проектировать каталог, писать CLAUDE.md, вести реестры состояния персонажей и заделов.

В: Что писать в CLAUDE.md?
Только то, что нужно соблюдать каждый раз: одно предложение о книге, файлы, обязательные перед главой, жёсткие правила письма, реестры, которые нужно обновить после главы, какие файлы ИИ менять нельзя, кто главнее при конфликте. Держите коротким.

В: Как настроить правила для письма романа в Cursor?
Создайте файлы правил в каталоге .cursor/rules проекта, чётко прописав обязательные файлы и жёсткие правила; можно использовать и AGENTS.md. Библию и персонажей разбейте на маленькие файлы, при написании главы ссылайтесь на нужные. Контрольные точки Cursor хранятся локально, для долгосрочных версий официально рекомендуется Git.

В: Может ли Codex CLI писать романы?
Может, подход похож на Claude Code: правила в AGENTS.md, библия, план и текст организованы по каталогам. В официальной документации сказано, что суммарный размер AGENTS.md по умолчанию ограничен 32 KiB, правила нужно писать сжато.

В: Нужно ли уметь программировать, чтобы писать роман в Claude Code?
Писать код не нужно, но надо привыкнуть к терминалу или редактору, немного разбираться в файлах и каталогах; удобнее, если умеете вести версии через Git. Для совсем не знакомых с этим авторов будет период привыкания.

В: Можно ли пользоваться Claude Code из материкового Китая?
В официальном списке поддерживаемых регионов Claude материкового Китая нет, это пояснение распространяется на Claude.ai, Claude Code и API. Подробности — на официальной странице.

В: Когда стоит перейти с агента для программирования на программу для письма?
Когда на ведение реестров и правил уходит больше времени, чем на текст, не хочется пользоваться терминалом и Git, хочется писать в браузере или на телефоне или привычнее смотреть карточки, а не файлы, можно подумать о переходе на специализированную программу для письма романов.