Respostas
Arroway ou escrever no CLAUDE.md: qual é a diferença?
O CLAUDE.md é um arquivo no repositório: alguém escreve, alguém mantém em dia, e o assistente de código que trabalha naquele repositório o carrega. A Arroway é uma memória compartilhada que toda ferramenta de IA conectada a um projeto lê antes de agir — Claude, ChatGPT, Codex e as outras ferramentas que falam o mesmo padrão de conexão. Ela guarda o que o arquivo não consegue: quais regras e decisões estão vigentes agora, quem decidiu cada uma, o que as encerraria e o que já foi aposentado. Os assistentes escrevem nela como proposta, e uma pessoa aprova o que passa a valer. Ela não lê seu código, seu repositório nem seus dados, e não roda seus agentes. O CLAUDE.md continua com o que é do repositório; a Arroway é onde mora o resto, para que as pessoas e as IAs delas trabalhem a partir do mesmo combinado.
Última atualização 24 de setembro de 2026
Duas coisas diferentes, muitas vezes descritas como uma
As duas acabam na frente do modelo, e é por isso que são comparadas. Mas o arquivo de contexto é um artefato do código: vive no controle de versão, viaja em todo clone e descreve como aquele código é construído e quais convenções ele segue. A Arroway se organiza por projeto, não por repositório. Um projeto pode ser um código, a conta de um cliente ou uma empresa inteira, e é lido do mesmo jeito por qualquer ferramenta conectada, em qualquer máquina, por um assistente que nunca viu o repositório — ou por um que trabalha onde nem existe repositório.
O que a Arroway não é
Ela não é uma ferramenta que inspeciona seu repositório, seu warehouse ou sua infraestrutura e reconcilia as regras com o que encontra lá. Não varre código, não roda nem agenda agentes e não monitora sistema. Ela guarda o que as pessoas e os assistentes escrevem nela — decisões, regras, fatos, bastões, um log datado — e serve a parte vigente para o assistente que pedir, ordenada pela tarefa que ele declara. O recorte estreito é de propósito: uma memória que também quisesse ser o monitor teria de decidir sozinha o que é verdade, e decidir é a parte que fica com uma pessoa.
Onde o arquivo para
O arquivo é o lugar certo para o que é do repositório e tem a mesma resposta em todo clone: como construir e rodar, a estrutura, as convenções do código. Ele para em três pontos. Uma linha dele não consegue dizer que foi superada, então a regra substituída se lê igualzinho à vigente. Ele não distingue a decisão que uma pessoa aprovou de algo que um assistente deduziu e anotou. E ele só alcança a ferramenta que o carrega, no repositório onde está — quem decide preço ou contrato de cliente nunca o abre. É para esses três pontos que a Arroway existe.
Como isso aparece na prática
Um time de quatro pessoas mantém um CLAUDE.md por serviço, quatro ao todo. A regra de que dado de cliente nunca entra em fixture de teste está escrita em três deles; o quarto serviço nasceu depois da regra, e ninguém a copiou. Numa reunião de planejamento o time afrouxa a regra para dado anonimizado. Um arquivo é atualizado. Dois ficam com a redação antiga. O quarto continua sem nada. Com a Arroway a regra é escrita uma vez, no projeto, com o nome de quem decidiu. Quando ela muda, a versão nova aponta para a que substitui e a antiga sai da leitura. Todo assistente — nos quatro serviços, na janela de chat que a gerente de produto usa, num notebook que nunca clonou nenhum deles — abre a sessão seguinte com a versão vigente. Os quatro CLAUDE.md voltam a descrever como cada serviço é construído.
Perguntas que as pessoas fazem sobre isso
- Preciso parar de usar o CLAUDE.md?
- Não, e nada na Arroway pede isso. O arquivo continua sendo o lugar certo para o que é do repositório. O que costuma sair dele é a parte que muda sem o código mudar e tem uma pessoa por trás — decisões, regras do time, o que foi combinado com um cliente. O próprio repositório da Arroway mantém um arquivo de contexto exatamente para a parte do repositório.
- A Arroway lê meu repositório ou confere meu código contra as regras?
- Não. Ela nunca se conecta ao seu repositório, ao seu banco ou à sua infraestrutura, e não compara o que está escrito com o que está no ar. Ela só conhece o que pessoas e assistentes registram nela. Conferir um código é trabalho do seu assistente, com as ferramentas que ele já tem; a Arroway entrega a ele as regras contra as quais conferir, com quem decidiu e se elas continuam vigentes.
- Dá para ver que partes do meu CLAUDE.md deveriam ir para a memória?
- Dá. A auditoria de CLAUDE.md deste site separa o arquivo colado em decisões, regras, fatos, log e ruído, e estima quanto dele é o tipo de conhecimento que arquivo não consegue manter atual. Ela roda inteira no seu navegador — o arquivo não é enviado para lugar nenhum — e os números que mostra são uma estimativa por marcas de texto, o que a própria página diz com todas as letras.
Onde isto se confere
Documentação do produto neste site (Como funciona, Instalar, a auditoria de CLAUDE.md), a resposta sobre arquivos versionados e memória curada para a comparação geral, e as regras de projeto, sanção, substituição e ordenação da leitura da especificação sancionada do produto. O CLAUDE.md é descrito aqui só pelo que ele é — um arquivo mantido no repositório e carregado pelo assistente que trabalha ali; esta página não afirma nada sobre a memória nativa de nenhuma ferramenta de IA. Tudo o que está descrito aqui é comportamento que as ferramentas aplicam hoje, não roadmap.