Respostas
Seu CLAUDE.md passou de uma página. O que sai dele?
O conselho de sempre é manter o CLAUDE.md em menos de uma página e cortar quando ele cresce. Cortar trata o tamanho como o problema. O problema é que tudo no arquivo governa toda sessão, e ninguém vê o que entra nem aprova: o palpite de um assistente, uma linha de status de março e uma decisão tomada numa reunião em que o leitor não estava pesam o mesmo que o comando de build. Então o que sai é tudo. O que ainda vale vai para a Arroway, onde uma pessoa aprova e a leitura escolhe pela tarefa; o que venceu ou é ruído é apagado. O arquivo pode terminar vazio.
Última atualização 26 de agosto de 2026
Por que as linhas curtas e verdadeiras não ganham exceção
O comando de build, o desenho das pastas e a convenção que o código segue parecem exceções seguras, porque são curtos e verdadeiros hoje. São também as linhas que um assistente pode reescrever de passagem sem ninguém revisar, e as que ninguém relê quando deixam de ser verdade. O que fica no arquivo fica fora da vista de todo mundo. Na Arroway o mesmo fato é uma memória com autor, com uma pessoa que a aprovou e com a condição que a encerra — e chega a toda ferramenta que o time usa, não só àquela que carrega o arquivo.
O que está deixando ele longo
Tudo o que tem uma pessoa por trás. Uma decisão de preço ou de escopo, uma regra sobre o que pode ser enviado a um cliente, a abordagem que o time tentou e abandonou, a convenção acertada numa reunião por alguém que não commita código. Chegam linhas novas o tempo todo, porque decisões não param de ser tomadas, então o arquivo cresce na única direção que não pode — e quando passa de uma página, as linhas que mais importam disputam atenção com as que simplesmente nunca foram apagadas.
Para onde vai, então
Para a Arroway: escrito por pessoas e pelos assistentes que elas usam, aprovado por uma pessoa antes de governar qualquer coisa, carregando a condição que o encerra, e servido por relevância para a tarefa da vez em vez de carregado inteiro. O problema de tamanho deixa de ser problema de tamanho, porque uma leitura seleciona. Um arquivo não seleciona — vai todo para a frente do modelo, toda vez, e o único jeito de mantê-lo pequeno é ficar apagando coisas de que uma pessoa ainda precisa.
Como isso aparece na prática
O arquivo de contexto de um time chega a quatro páginas. Alguém corta de volta para uma, por tamanho: os comandos de build ficam porque são curtos, e o parágrafo explicando por que o time parou de usar uma biblioteca sai porque é longo. Duas semanas depois um assistente propõe essa biblioteca. O corte foi feito exatamente como aconselhado, e removeu a linha que mais estava trabalhando — e nada no arquivo tinha como dizer qual era ela: nem autor, nem data, nem aprovação.
Perguntas que as pessoas fazem sobre isso
- Então o CLAUDE.md está errado?
- É o lugar errado para qualquer coisa que precise valer. O que está nele governa toda sessão, e ninguém vê o que entrou nem aprova — a linha que um assistente acrescentou por conta própria, o status que venceu, a decisão que ninguém lembra de ter tomado. Ele também não consegue dizer que uma linha foi superada, nem alcançar uma pessoa que nunca abre o repositório. A recomendação da Arroway é deixá-lo vazio e guardar o que vale na Arroway, onde uma pessoa vê e aprova cada linha.
- Não dá para só dividir em vários arquivos?
- Dá, e isso adia o problema em vez de resolver. Mais arquivos são mais texto na frente do modelo, ou uma regra de carregamento que alguém precisa manter — e nenhum dos dois toca na parte que dói de verdade: nada num arquivo diz qual de duas linhas contraditórias vale hoje. Dividir organiza o texto. Não dá a uma decisão uma validade, um autor, nem uma pessoa que a aprovou.
- O que o assistente lê, então, e como eu sei que chegou?
- Ele pede à Arroway, no começo do trabalho. Essa leitura é ordenada pela tarefa e volta dizendo o que entregou e o que não coube — então “o assistente pegou mesmo as nossas regras?” tem uma resposta que dá para olhar, o que nenhum arquivo consegue oferecer sobre si mesmo.
Onde isto se confere
A documentação do produto neste site (Como funciona, Instalação) e a spec sancionada no repositório. A recomendação de manter o arquivo de contexto curto é prática publicada; toda propriedade citada aqui sobre um arquivo de contexto comum é de qualquer arquivo de texto versionado — sem vigência, sem etapa de sanção, sem seleção, sem recibo de entrega. Esta página não afirma nada sobre a memória nativa de nenhum produto de IA.
https://www.arroway.app/pt-BR/answers/context-file-outgrew-a-page