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.

Quando não fazer

Não monte isso para um projeto solo com um assistente: um arquivo só já é a fonte única. E não use o truque da importação como conserto para um time: ele reduz o número de arquivos sem dizer a ninguém quem decidiu uma linha nem quando ela deixa de valer. Se o único problema são dois arquivos que você controla, um link simbólico basta.

Um erro comum: sincronizar por script

Um script que copia o CLAUDE.md para o GEMINI.md a cada commit parece um conserto, até o dia em que alguém edita a cópia. O script sobrescreve a edição, ou a edição sobrevive e os dois voltam a divergir, e nos dois casos ninguém vê. Sincronizar o texto mantém os arquivos iguais; não decide qual texto está certo, e uma regra que ninguém aprovou se espalha para todas as ferramentas de uma vez.

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.

Fazer três arquivos de instrução pararem de divergir, em seis passos

  1. Ponha os três arquivos lado a lado e compare. No time do exemplo, as dez regras escritas em setembro deveriam ser idênticas, e toda linha que não for é uma pendência. Conte as diferenças; o número é o seu ponto de partida.
  2. Para cada diferença, ache quem fez a mudança e pergunte qual texto o time quer dizer. Não escolha por arquivo: o CLAUDE.md não está mais certo que o GEMINI.md por ter sido editado mais recentemente.
  3. Dentro do repositório, reduza o número de textos se as ferramentas permitirem: importe o AGENTS.md no CLAUDE.md e aponte o context.fileName do Gemini CLI para o AGENTS.md. Isso faz os agentes de código lerem um texto só, e nada além disso.
  4. Decida quais regras são sobre o código e quais são decisões do time. “Toda mudança de banco precisa de um segundo revisor” é decisão do time, e pertence ao lugar que toda ferramenta lê e o dono aprova, não ao arquivo compartilhado.
  5. Registre cada decisão do time uma vez, com quem aprovou e o que a encerra. Quando a regra de um revisor for substituída, a nova cita a antiga, e a próxima sessão de toda ferramenta abre com a versão atual.
  6. Ponha a conferência no hábito, não nos arquivos: quando alguém propõe uma regra a partir de uma sessão, a pergunta é se ela já existe. Rode a comparação de novo depois de um mês. Se os arquivos voltaram a divergir, ainda se acrescentam regras direto neles.

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.
Instalar o ArrowayVer como funciona →

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

Continue explorando

Ver todas as respostas