GitHub Copilot custom instructions: onde fica e como as ferramentas o leem

O GitHub Copilot lê um arquivo para todo o repositório, .github/copilot-instructions.md, além de arquivos .instructions.md específicos para caminhos. Ele também respeita AGENTS.md ou um único CLAUDE.md ou GEMINI.md na raiz.

Onde fica

• .github/copilot-instructions.md, aplicado a todo o repositório.
• .github/instructions/**/NAME.instructions.md, aplicado aos arquivos correspondentes a applyTo.
• AGENTS.md em qualquer lugar do repositório; o arquivo mais próximo prevalece.
• Um único CLAUDE.md ou GEMINI.md na raiz, como alternativa.

Formato

Markdown; espaços em branco entre instruções são ignorados. Somente arquivos .instructions.md aceitam frontmatter: applyTo contém globs separados por vírgulas, e excludeAgent aceita "code-review" ou "cloud-agent". O code review deixou de ter o limite de 4,000 caracteres em 2026-06-12, e o GitHub recomenda no máximo cerca de 1,000 linhas por arquivo.

Chaves do frontmatter: applyToexcludeAgent

# Copilot instructions

This is a Rails app with a React front end in app/javascript/.

## Build and test

- Install: `bundle install && yarn install`
- Test: `bin/rails test`
- Lint: `bin/rubocop`

## Conventions

- Put business logic in app/services/, not in controllers.
- Every migration must be reversible.
- Never commit credentials or edit config/master.key.

Precedência e combinação

As instruções pessoais vêm primeiro, seguidas pelas do repositório e da organização, e todos os conjuntos relevantes ainda são enviados. Quando um arquivo específico para um caminho e o arquivo para todo o repositório correspondem, o Copilot usa ambos. O code review lê as instruções do branch de origem do pull request.

Dicas

• No github.com, arquivos .instructions.md específicos para caminhos funcionam apenas com o Copilot cloud agent e o Copilot code review.
• Adicione excludeAgent: "code-review" para excluir um arquivo das revisões, enquanto o cloud agent continua usando-o.
• O Copilot cloud agent pode criar um rascunho de copilot-instructions.md para você; mantenha-o com cerca de duas páginas e não o vincule a uma única tarefa.

Outros arquivos de instruções