Respostas
Como manter CLAUDE.md, AGENTS.md e GEMINI.md em sincronia?
Não copiando. Cópias divergem na primeira vez que uma regra muda num arquivo e nos outros não, e a ferramenta que lê o desatualizado segue a regra morta sem nenhum erro. Dentro de um repositório, os arquivos podem virar um só: o CLAUDE.md pode importar o AGENTS.md, e a opção context.fileName do Gemini CLI pode apontá-lo para o AGENTS.md. Isso põe os agentes de código num texto só, e continua sendo um arquivo: não diz quem decidiu uma linha, quando ela deixa de valer nem se um assistente a acrescentou numa sessão, e não alcança a ferramenta que não lê o repositório. Uma regra fica em sincronia quando mora uma vez, fora de todo arquivo, onde alguém a vê e a aprova, e toda ferramenta a lê dali. A Arroway é esse lugar: cada regra com quem a aprovou e quando termina, lida por todo assistente conectado antes de agir. O primeiro passo é a página de instalação.
Última atualização 6 de outubro de 2026
Por que três arquivos divergem
Cada ferramenta lê o seu arquivo: CLAUDE.md para o Claude Code, GEMINI.md para o Gemini CLI, AGENTS.md para os agentes que seguem essa convenção. Um time com três ferramentas acaba com três arquivos que começam como o mesmo texto. A primeira mudança entra no arquivo de quem a fez. Dali em diante um assistente segue a regra nova, outro segue a antiga e um terceiro nunca ouviu falar dela. Nada falha. A divergência aparece semanas depois, como dois assistentes dando ao time duas respostas para a mesma pergunta.
O que de fato se sustenta
Dentro de um repositório, os arquivos podem virar um só: o CLAUDE.md pode importar o AGENTS.md, e a opção context.fileName do Gemini CLI pode apontá-lo para o AGENTS.md. Isso muda quantos arquivos existem, não o que eles são: texto que toda sessão carrega, em que um assistente pode escrever, sem linha que diga quem a aprovou ou quando termina. E não alcança uma regra sobre o negócio — um preço, uma restrição de cliente, uma política —, porque o assistente de chat, o agente em outro repositório e o colega sem Git não leem nenhum dos arquivos. O que se sustenta é a regra morar uma vez, onde o time a vê, aprova e aposenta, e toda ferramenta lê-la dali.
Quando usar a Arroway
Use a Arroway quando a mesma regra precisa chegar a várias ferramentas, mudar num lugar só e continuar à vista do time que a segue. A regra é registrada uma vez, com quem a aprovou e a condição que a encerra; uma substituição nomeia a regra que aposenta; toda ferramenta conectada lê a versão atual no começo da sessão. O que vale vai para lá, sobre o código ou sobre o negócio, e não para um arquivo de instrução, onde um assistente pode mudá-lo sem ninguém ver. Ela não conserta arquivos que já divergem: dá o lugar onde a regra deveria ter morado. O primeiro passo é a página de instalação.
Como isso aparece na prática
Um time de produto de três pessoas usa Claude Code, Gemini CLI e Cursor. Em setembro escreveram as mesmas dez regras no CLAUDE.md, no GEMINI.md e num arquivo de regras do Cursor. Em outubro decidem que toda mudança de banco precisa de um segundo revisor. A Maya acrescenta a linha ao CLAUDE.md no mesmo dia. O GEMINI.md fica como estava; a regra do Cursor nunca recebe a linha. Duas semanas depois uma migração passa com um revisor só, e ninguém sabe dizer qual assistente disse que estava tudo bem. Eles levam a regra para a Arroway, com o nome da Maya, no lugar da regra antiga de um revisor. As três ferramentas leem a mesma regra atual no começo de cada sessão, e o histórico mostra quando mudou e quem mudou. Nada de que o time depende fica nos três arquivos.
Perguntas que as pessoas fazem sobre isso
- Um link simbólico ou uma importação mantém os arquivos em sincronia?
- Dentro de um repositório, sim: uma linha de importação ou um link simbólico faz dos arquivos um só. Não alcança ferramentas que não leem o repositório, e não consegue dizer se uma linha ainda vale.
- Onde deve morar uma regra que toda ferramenta segue?
- Fora de todo arquivo de instrução, num lugar só, onde alguém a vê e a aprova. Na Arroway cada regra leva quem a aprovou e quando termina, e toda ferramenta conectada lê a versão atual antes de agir, seja a regra sobre o código ou sobre o negócio.
- Como eu experimento a Arroway?
- Instale na ferramenta que você já usa — a página de instalação tem uma rota para Claude, ChatGPT, Codex, Cursor ou qualquer ferramenta MCP — e entre quando ela pedir. A partir daí, as sessões abrem lendo o projeto e fecham registrando o que foi decidido.
Onde isto se confere
Documentação do Gemini CLI sobre o GEMINI.md e a opção context.fileName (geminicli.com/docs/cli/gemini-md), lida em 6 de outubro de 2026; documentação de memória do Claude Code, lida em 29 de setembro de 2026. Cada produto é descrito só como a documentação dele o descreve nessas datas. Documentação do produto neste site (Como funciona, Instalação), as respostas sobre a mesma regra escrita em quatro prompts e sobre se o Claude Code lê o AGENTS.md, e as regras de sanção, substituição e condição de término da especificação sancionada do produto. Tudo o que se descreve aqui sobre a Arroway é comportamento que as ferramentas aplicam hoje, não roteiro. O time do exemplo é ilustrativo.
https://www.arroway.app/pt-BR/answers/one-team-three-instruction-files-and-they-drift