Respostas
copilot-instructions.md vs CLAUDE.md: você precisa dos dois?
Segundo a documentação do GitHub, o Copilot lê o .github/copilot-instructions.md para o repositório inteiro, arquivos .instructions.md específicos de caminho que trazem um padrão applyTo, arquivos AGENTS.md (o mais próximo na árvore de diretórios tem precedência) e um único CLAUDE.md ou GEMINI.md na raiz do repositório como alternativa ao AGENTS.md. Então o Copilot consegue ler um CLAUDE.md sozinho; o que um CLAUDE.md não dá a ele são regras por caminho, que existem só em arquivos .instructions.md, e a documentação diz que instruções por caminho hoje são aceitas no GitHub.com apenas pelo agente de nuvem do Copilot e pela revisão de código do Copilot. Quando um arquivo do repositório inteiro e um de caminho específico valem para o mesmo arquivo, o Copilot usa os dois. Entre instruções pessoais, de repositório e de organização, todos os conjuntos relevantes são fornecidos, e a documentação aconselha evitar conflitos entre eles. Nenhum dos dois arquivos registra quem decidiu uma linha nem quando ela deixa de valer. Na Arroway, os assistentes escrevem propostas, uma pessoa aprova o que vira regra, cada regra carrega a condição que a encerra, e o Copilot, o Claude Code, o Cursor ou qualquer ferramenta por MCP lê a versão vigente antes de agir. O primeiro passo é a página de instalação.
Última atualização 9 de outubro de 2026
O que cada ferramenta lê
A documentação do GitHub que li lista os arquivos que o Copilot toma como instruções: .github/copilot-instructions.md para o repositório, arquivos .instructions.md em .github/instructions com um padrão applyTo para caminhos específicos, AGENTS.md em qualquer lugar do repositório e um CLAUDE.md ou GEMINI.md na raiz. Recursos diferentes do Copilot leem conjuntos diferentes: o agente de nuvem e a revisão de código leem os arquivos por caminho, e o Copilot Chat usa as instruções do repositório quando o repositório está anexado. Li só a documentação do GitHub para esta página, então o que o Claude Code faz com o .github/copilot-instructions.md não é descrito aqui.
Onde para
A documentação diz que a revisão de código do Copilot lê as instruções da branch de origem do pull request, não da branch base, então uma branch que edita o arquivo de instruções é revisada sob a própria edição. Diz também que, quando conjuntos de instruções entram em conflito, todos são fornecidos e evitar o conflito é com você; não diz como o CLAUDE.md e o AGENTS.md interagem quando os dois existem. Um arquivo mostra quem mudou uma linha e quando. Não mostra quem a decidiu, se ela ainda vale ou o que substituiu, e quem trabalha fora do repositório não tem arquivo nenhum.
Quando usar a Arroway
Use a Arroway quando uma regra precisa chegar ao Copilot, ao Claude Code e às pessoas que nunca abrem o repositório, com alguém respondendo por ela. Cada regra é registrada uma vez, por quem responde por ela, com quem a aprovou e a condição que a encerra, e todo assistente conectado lê a versão vigente no começo de uma sessão. Quando a regra muda, a substituta nomeia a que aposenta, e a sessão seguinte de todo mundo abre com a nova. O que vale vai para lá, e os arquivos ficam sem nada que mereça ficar. O primeiro passo é a página de instalação.
Como isso aparece na prática
Um time de seis pessoas usa a revisão de código do Copilot nos pull requests e o Claude Code para boa parte da escrita. Em junho, a pessoa que lidera a técnica acrescenta uma linha ao .github/copilot-instructions.md: todo endpoint novo precisa de um teste de integração. Um desenvolvedor acrescenta uma linha parecida ao CLAUDE.md, com outras palavras. Em setembro, um desenvolvedor abre um pull request que afrouxa a linha do copilot-instructions.md para um serviço. O Copilot revisa esse pull request usando a branch de origem, então revisa a mudança sob a regra que a própria mudança reescreveu, enquanto o Claude Code, na sessão seguinte, ainda lê a redação de junho. Ninguém sabe dizer qual versão o time queria, nem quem tinha autoridade para afrouxá-la. Na Arroway, a regra é registrada uma vez com o nome de quem lidera a técnica; a exceção de setembro é uma proposta até essa pessoa aprová-la como substituta, com a própria condição de término. Copilot e Claude Code abrem a sessão seguinte com a regra vigente, e o histórico mostra a antiga, quando mudou e quem mudou. O time deste exemplo é ilustrativo.
Perguntas que as pessoas fazem sobre isso
- O Copilot lê o CLAUDE.md?
- Segundo a documentação do GitHub, sim: um único CLAUDE.md ou GEMINI.md na raiz do repositório é lido como alternativa ao AGENTS.md. Regras por caminho precisam de arquivos .instructions.md.
- Onde deve morar uma regra que as duas ferramentas seguem?
- Fora dos dois arquivos, num lugar só onde alguém a vê e a aprova. Na Arroway a regra é registrada uma vez, com quem a aprovou e a condição que a encerra, e as duas ferramentas a leem antes de agir.
- Como experimento a Arroway?
- Instale na ferramenta que você já usa — a página de instalação tem um caminho para Claude, ChatGPT, Codex, Cursor ou qualquer ferramenta MCP — e entre quando a ferramenta pedir. Daí em diante, as sessões abrem lendo o projeto e fecham registrando o que foi decidido.
Onde isto se confere
Documentação do GitHub sobre como adicionar instruções personalizadas de repositório para o Copilot (docs.github.com/en/copilot/how-tos/configure-custom-instructions/add-repository-instructions), lida em 9 de outubro de 2026 — o Copilot é descrito só como essa documentação o descreve nessa data, e pode mudar em qualquer versão. Documentação do produto neste site (Como funciona, Instalação), as respostas sobre regras do Cursor e CLAUDE.md no mesmo time e sobre manter três arquivos de instrução em sincronia, 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/copilot-instructions-and-claude-md-in-the-same-repo