Respostas
Quais são as alternativas ao CLAUDE.md para compartilhar o contexto de IA num time?
Três das respostas continuam sendo arquivos. O AGENTS.md é um arquivo único que vários agentes de código leem; a documentação do Cursor diz que o suporta na raiz do projeto e em subpastas, o GitHub Copilot também o lê, e o Claude Code só o lê quando o projeto não tem CLAUDE.md. Os arquivos de regra de cada ferramenta — .cursor/rules do Cursor, .github/copilot-instructions.md do Copilot, GEMINI.md do Gemini CLI — dão a cada uma as próprias instruções. Uma importação ou um link simbólico faz de vários desses arquivos um só. As três mudam qual arquivo a ferramenta lê, não o que o arquivo é: texto que o modelo carrega em toda sessão e em que um assistente pode escrever, sem nada que diga quem aprovou uma linha ou se ela ainda vale, longe dos olhos de quem não abre o repositório. A alternativa que muda isso é tirar do arquivo o que vale e levar para onde alguém vê e aprova. A Arroway é esse lugar: regras e decisões por projeto, cada uma com quem a aprovou e quando termina, lidas antes de agir por toda ferramenta conectada. O primeiro passo é a página de instalação.
Última atualização 6 de outubro de 2026
As opções em arquivo e o que cada uma muda
AGENTS.md: um arquivo compartilhado. O Cursor o suporta na raiz e em subpastas, e o arquivo mais específico vale onde está; o Copilot lê o AGENTS.md mais próximo; o Claude Code só o lê quando não encontra CLAUDE.md. Arquivos por ferramenta: .cursor/rules guarda arquivos .mdc com frontmatter, o Copilot lê .github/copilot-instructions.md e arquivos .instructions.md por caminho, e o Gemini CLI lê GEMINI.md por padrão e pode ser configurado, pela opção context.fileName, para ler outros nomes. Importações e links simbólicos: o CLAUDE.md pode importar outro arquivo, e um link simbólico dá dois nomes a um arquivo só. As três respondem qual arquivo a ferramenta lê. Nenhuma muda o que um arquivo é.
Onde cada uma para
Um arquivo é lido pelos agentes que trabalham naquele repositório. Quem define preço numa janela de chat nunca o carrega, nem um agente em outro repositório. Uma linha nele não consegue dizer que deixou de ser verdade, e a regra do mês passado se lê igual à de hoje. Um pull request diz quem mudou a linha, não se a linha ainda vale. E nada num arquivo separa uma regra que uma pessoa aprovou de uma que um assistente acrescentou numa sessão. Esses limites não são defeito de uma ferramenta; decorrem de a regra morar dentro de um repositório.
Quando usar a Arroway
Use a Arroway quando o time precisa ver de onde os assistentes dele partem. Cada regra e decisão fica registrada com quem a aprovou e a condição que a encerra, num lugar que o time consegue ler, e todo assistente conectado — Claude, ChatGPT, Codex, Cursor ou qualquer um via MCP — lê o que está valendo antes de agir, dentro do repositório e fora dele: um assistente de chat, um agente em outro repositório, um colega que não usa Git. O que vale, sobre o código ou sobre o negócio, vai para lá e não para um arquivo de instrução, onde um assistente pode acrescentar uma linha que ninguém aprovou. O primeiro passo é a página de instalação.
Como isso aparece na prática
Um time de cinco usa Claude Code e Cursor no mesmo repositório. Eles mantêm um AGENTS.md, e o CLAUDE.md o importa, então as duas ferramentas leem o mesmo arquivo. Em outubro a líder de produto decide que o plano grátis cai de cinco projetos para três. Os engenheiros mudam o limite no código; ninguém edita o arquivo. O assistente de suporte, que roda numa janela de chat e nunca no repositório, segue dizendo cinco aos clientes. Quando alguém enfim abre o arquivo, encontra linhas que ninguém lembra de ter aprovado: um comando de teste que já não existe e uma nota que um assistente acrescentou em agosto sobre o plano de cinco projetos. Na Arroway a decisão é registrada uma vez, com o nome da líder de produto, no lugar da regra dos cinco projetos, e o que ainda vale do arquivo entra do mesmo jeito, aprovado por uma pessoa; o arquivo fica sem nada. Os agentes de código, o assistente de suporte e o assistente de quem acabou de entrar abrem a próxima sessão com a regra dos três projetos, e o histórico mostra o limite antigo e quando mudou.
Perguntas que as pessoas fazem sobre isso
- O AGENTS.md substitui o CLAUDE.md?
- O Claude Code só lê o AGENTS.md quando não há CLAUDE.md, e um CLAUDE.md que importa o AGENTS.md faz com que ele o leia também; o Cursor e o Copilot leem o AGENTS.md. Trocar um arquivo pelo outro muda qual ferramenta lê o texto, não quem o vê nem quem o aprova.
- Ainda preciso dos arquivos se usar a Arroway?
- Não. O que vale vai para a Arroway, onde alguém vê e aprova, e toda ferramenta conectada lê antes de agir. Um arquivo de instrução com regras dentro é uma segunda fonte que o time não enxerga: o modelo o carrega em toda sessão, e um assistente pode acrescentar nele uma linha que ninguém aprovou.
- 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 Cursor sobre regras (cursor.com/docs/context/rules), documentação do GitHub sobre instruções personalizadas do repositório para o Copilot (docs.github.com/en/copilot) e documentação do Gemini CLI sobre o GEMINI.md e a opção context.fileName (geminicli.com/docs/cli/gemini-md), lidas em 6 de outubro de 2026; documentação de memória e changelog do Claude Code, lidos em 29 de setembro de 2026. Cada produto é descrito só como a documentação dele o descreve nessas datas, e pode mudar em qualquer versão. Documentação do produto neste site (Como funciona, Instalação), as respostas sobre se o Claude Code lê o AGENTS.md e sobre a Arroway contra um arquivo de contexto, 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/alternatives-to-claude-md-for-a-team