Pasta do romance e regras do CLAUDE.md: estrutura e registros

Neste artigo 9 seções

Primeiro a conclusão: quatro tipos de pasta, regras duras no arquivo de regras e o registro atualizado a cada capítulo

Claude Code, Cursor e Codex CLI nasceram como ferramentas para escrever código, mas cada vez mais autores as usam para escrever romances. O motivo é bem concreto: elas leem e escrevem a pasta inteira, uma alteração pode atravessar dezenas de arquivos e, se estragar, há como voltar atrás (Claude Code e Cursor têm checkpoints próprios, e o Codex CLI recomenda oficialmente usar o Git para criá-los), o que serve para gerir uma obra longa com centenas de arquivos.

Para escrever romances com elas, as práticas públicas convergem, em linhas gerais, para o mesmo conjunto de procedimentos:

1. Arquivos de ambientações, personagens, roteiro e texto ficam separados;
2. Um arquivo de regras na raiz (Claude Code usa o CLAUDE.md, o Codex usa o AGENTS.md, o Cursor usa arquivos de regras em .cursor/rules), escrevendo as restrições duras;
3. Um conjunto de registros à parte (estado dos personagens, pistas plantadas, linha do tempo), atualizado ao fim de cada capítulo, como base única de «até onde a história chegou»;
4. Versões geridas com Git ou com os checkpoints da própria ferramenta.

A seguir, item por item e, no fim, quando vale mais a pena migrar para um software de escrita. As práticas públicas citadas neste texto foram conferidas em 2026-10-11.

Estrutura de pastas: um esqueleto que dá para copiar direto

Com base em projetos e tutoriais públicos, o diretório de um romance longo em chinês pode ser montado assim:

• CLAUDE.md (ou AGENTS.md): arquivo de regras
• ambientacoes/: mundo.md, sistema-de-poder.md, forcas.md, lugares.md
• personagens/: um arquivo para cada personagem importante, como lin-yao.md
• roteiro/: roteiro-geral.md, roteiro-do-volume/volume-1.md, roteiro-do-capitulo/001.md…
• texto/: 001-noite-de-chuva.md, 002-ingresso.md…
• registros/: estado-dos-personagens.md, pistas-plantadas.md, linha-do-tempo.md, progresso.md
• estilo/: trechos-de-amostra.md
• arquivo/: personagens que saíram, lugares antigos

Alguns detalhes:

• Nomes de arquivo de capítulo começam com três dígitos. Títulos de capítulo em chinês, ordenados alfabeticamente, bagunçam a ordem; um artigo do Juejin sobre escrever uma obra longa no Cursor menciona esse problema, e no fim foi preciso escrever um script para juntar os capítulos (fonte). Nomes como «001-noite-de-chuva.md» evitam isso.
• Um arquivo guarda só um personagem ou um tipo de ambientação. Arquivos pequenos fazem a IA ler a cada vez só os necessários; foi assim que fez o autor que compartilhou o Buckram Studio no fórum oficial do Cursor, citando, a cada capítulo, só os arquivos relevantes (fonte).
• O que o autor escreve e o que a IA escreve ficam separados. Um tutorial do CSDN divide o diretório em duas metades: as restrições duras mantidas pelo autor (estilo, ambientação geral, personagens centrais, trama principal) e os registros mantidos pela IA (estado dos capítulos, linha do tempo dos personagens, pistas, linhas dos personagens), e a IA não pode mexer nos primeiros (fonte).

O que escrever no CLAUDE.md: só o que precisa ser cumprido toda vez

O arquivo de regras vale segundo as regras de carregamento de cada ferramenta, e, quanto mais longo, mais contexto ocupa; por isso deve ser curto, só com restrições duras. Pode incluir estes pontos:

• Uma frase apresentando o livro: gênero, ponto de vista, público-alvo;
• Arquivos de leitura obrigatória antes de escrever o capítulo: roteiro do capítulo, fichas dos personagens que aparecem, estado dos personagens no registro, texto dos dois capítulos anteriores;
• Regras duras de escrita: pessoa e ponto de vista, faixa de tamanho por capítulo, frases feitas e construções proibidas;
• O que fazer ao terminar cada capítulo: atualizar os quatro registros: estado dos personagens, pistas, linha do tempo e progresso;
• Arquivos que não podem ser alterados: ambientações e fichas de personagem só o autor muda; quando a IA encontra conflito, lista e não altera por conta própria;
• Quem prevalece em caso de conflito: os fatos já escritos no texto prevalecem sobre o roteiro, e o registro segue o capítulo mais recente.

É preciso conter o tamanho. Tomando o Codex como exemplo, a documentação oficial diz que o limite padrão do AGENTS.md somado é de 32 KiB (fonte); o Codex recomenda oficialmente pôr no AGENTS.md as regras que precisam ser obedecidas, em vez de depender só da função de memória (fonte); e a documentação do Cursor também explica que o modelo não guarda memória entre duas conclusões e que as regras servem para dar contexto persistente (fonte).

Registros: a chave para uma obra longa poder continuar

O arquivo de regras cuida do «como escrever», e o registro cuida do «até onde se escreveu». Nos projetos públicos, as práticas mais maduras têm três pontos:

• Reconhecer uma única fonte de fatos. O oh-story-claudecode coloca o acompanhamento do estado num arquivo só, como fonte geral do estado estruturado, e mantém à parte um resumo de «contexto» com seções fixas e limite de tamanho (fonte). O webnovel-writer também guarda separadamente roteiro geral, roteiro do volume, linha do tempo, roteiro do capítulo e índice de estado (fonte).
• Registrar separadamente «o que o autor sabe» e «o que o leitor sabe». O oh-story-claudecode faz assim para impedir que o personagem saiba a resposta antes da hora.
• Atualizar ao fim de cada capítulo. Estado dos personagens (onde estão, ferimentos, força, o que sabem), pistas plantadas (em que capítulo foram plantadas, quando serão fechadas) e linha do tempo (quantos dias passaram no livro). Um autor no Reddit que terminou com o Claude uma obra longa de 300 mil palavras registrou, para cada personagem, «o que sabe em cada ponto do tempo» e pediu ao Claude Code que fizesse checagens de continuidade em centenas de arquivos (fonte).

Versões: além dos checkpoints, é preciso ter o Git

• O Claude Code cria um checkpoint automaticamente a cada prompt, e dá para voltar com /rewind; a documentação oficial diz que ficam guardados os 100 mais recentes (fonte).
• Os checkpoints do Cursor ficam locais, separados do Git, e a recomendação oficial é usar o Git para o controle de versões de longo prazo (fonte).
• O Codex CLI recomenda oficialmente criar checkpoints do Git antes e depois da tarefa, para poder voltar atrás (fonte).

Por isso, um hábito mais seguro é fazer um commit no Git ao fim de cada capítulo, com o número do capítulo na mensagem.

Problemas que se repetem nas práticas públicas

Reunindo esses tutoriais e discussões públicos, alguns problemas aparecem com mais frequência:

• Conversa longa «embaça». O autor do Buckram Studio menciona que, numa conversa longa de duzentas mensagens, surgem degradação de contexto, custo crescente, repetição e texto genérico (fonte); o artigo do Juejin também diz que muitas vezes «esquece a ambientação do romance».
• Deriva de personagem e de estilo. As palavras do tutorial do CSDN são «a força do protagonista oscila, parece que trocou de pessoa»; o autor do Reddit menciona que, ao chegar ao capítulo 80, o ritmo do capítulo 12 já não existia e foi preciso fornecer de novo trechos de amostra várias vezes.
• Uso e custo. Pedir à IA que junte arquivos um por um esgota a cota rapidamente (fonte).
• Barreira para quem não programa. Um mesmo artigo menciona que o VS Code «só de ouvir já assusta» quem não programa; outro artigo acha que dá para começar sem diploma de ciência da computação e, ao mesmo tempo, prevê que a maioria dos autores usará principalmente a interface de chat (fonte).

Esses problemas têm como ser atenuados: arquivos pequenos, registro atualizado a cada capítulo, ler a cada capítulo só os arquivos necessários e abrir conversas novas de tempos em tempos. O preço é que o autor precisa projetar o diretório, escrever as regras, manter os registros e olhar as comparações de arquivos.

Quando migrar para um software de escrita de romances

O agente de programação lhe dá controle total: os arquivos são locais, a estrutura é você quem define, e trocar de modelo ou de ferramenta é fácil. Para o autor que gosta desse modo e conhece terminal e Git, escrever romances com ele é uma ótima escolha.

Nas situações abaixo, vale considerar migrar para um software de escrita específico:

• O tempo gasto mantendo registros e arquivo de regras começa a superar o tempo de escrever o texto;
• Você não conhece terminal nem Git e, a cada vez que olha as alterações, precisa decifrar a comparação de arquivos;
• Quer escrever a qualquer hora na web ou no celular, sem ficar preso a um computador;
• Quer ver fichas de personagem, diretório e lista de pistas plantadas, e não um monte de arquivos Markdown;
• Rede ou conta com restrições. Por exemplo, a lista oficial de regiões atendidas pelo Claude não inclui a China continental, e essa restrição abrange Claude.ai, Claude Code e a API (fonte).

Que etapas o Maliang Writer automatiza

O diretório, as regras e os registros acima correspondem no Maliang Writer a isto:

• Cada um dos quatro tipos de arquivo tem seu lugar. Personagens, ambientações, pistas plantadas e linhas narrativas são fichas, uma a uma, da bíblia da história, exibidas na barra lateral; o roteiro geral fica guardado à parte; amostras de estilo e materiais de abertura de livro são documentos em «Documentos». A IA lê o necessário ao escrever; você vê fichas e diretório, sem manter pastas.
• Os registros são organizados pelo arquivista. Quando o capítulo termina e esta etapa de escrita acaba, o arquivista organiza os arquivos da história a partir do texto: estado dos personagens, relações, posições, pistas plantadas. Os pontos que não batem com a ambientação existente entram em «Pendente de confirmação», e você decide de que lado mudar. Se não quiser, dá para desligar em «Arquivos».
• Comparar e desfazer ficam no editor. O texto alterado pela IA mostra direto exclusões e acréscimos, que podem ser mantidos ou revertidos ponto a ponto; se não gostar, dá para desfazer a rodada atual, abrir uma ramificação a partir de antes da rodada ou editar e reenviar. A ramificação e a conversa original compartilham o mesmo manuscrito.

• O texto fica com o agente redator. Na continuação, o redator recebe só o material de que este capítulo precisa: roteiro do capítulo, ambientações dos personagens relacionados, texto anterior e amostra de estilo.
• Ambientações antigas são guardadas por volume. Ao chegar a um volume novo, personagens, lugares e pistas que só apareceram nos volumes anteriores vão para o arquivo, e a IA deixa de consultá-los ao escrever capítulos novos, mas ainda dá para achá-los quando precisar.
• Usa-se direto na web, sem instalar.

A comparação detalhada entre os dois modos está em Claude Code vs Maliang Writer, Como escolher entre agente de programação e software de escrita de romances e Como escolher entre pastas e escrita estruturada.

Perguntas frequentes

P: O Claude Code consegue escrever romances?
Consegue. Ele lê e escreve a pasta inteira, altera vários arquivos e tem checkpoints próprios para voltar atrás; já há autores que usaram o Claude para escrever o texto e o Claude Code para checagens entre arquivos, concluindo obras longas. Você precisa projetar o diretório, escrever o CLAUDE.md e manter os registros do estado dos personagens e das pistas plantadas.

P: O que escrever no CLAUDE.md?
Só o que precisa ser cumprido toda vez: a apresentação do livro em uma frase, os arquivos de leitura obrigatória antes de escrever o capítulo, as regras duras de escrita, os registros a atualizar ao fim de cada capítulo, que arquivos a IA não pode mudar e quem prevalece em caso de conflito. Mantenha curto.

P: Como configurar as regras ao escrever romance no Cursor?
Crie arquivos de regras no diretório .cursor/rules do projeto, deixando claros os arquivos obrigatórios e as regras duras; também dá para usar o AGENTS.md. Divida ambientações e personagens em arquivos pequenos e, a cada capítulo, cite só os relevantes. Os checkpoints do Cursor ficam locais, e a recomendação oficial é usar o Git para as versões de longo prazo.

P: O Codex CLI consegue escrever romances?
Consegue, de modo semelhante ao do Claude Code: regras no AGENTS.md e ambientações, roteiro e texto organizados por diretório. A documentação oficial diz que o limite padrão do AGENTS.md somado é de 32 KiB, então as regras precisam ser enxutas.

P: Para escrever romances com o Claude Code é preciso saber programar?
Não é preciso escrever código, mas é preciso estar à vontade com terminal ou editor, entender um pouco de arquivos e diretórios, e usar Git para gerir versões facilita. Para quem não conhece nada disso, haverá um período de adaptação.

P: Dá para usar o Claude Code na China continental?
A lista oficial de regiões atendidas pelo Claude não inclui a China continental, e essa informação abrange Claude.ai, Claude Code e a API. Os detalhes seguem a página oficial.

P: Quando trocar do agente de programação para um software de escrita?
Quando o tempo de manter registros e regras superar o de escrever o texto, quando não quiser usar terminal e Git, quando quiser escrever na web ou no celular, ou quando preferir ver fichas em vez de arquivos, vale considerar um software de escrita de romances específico.