---
title: "GitHub Copilot custom instructions: caminhos e formato · DotsAgent"
description: "Onde .github/copilot-instructions.md fica, seu formato e frontmatter, como cópias globais e aninhadas são combinadas e quais ferramentas o leem. Verificado em 2026-10-01."
url: https://dotsagent.io/pt/instructions/files/github-copilot-instructions
---

.github/copilot-instructions.md

# 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: `applyTo``excludeAgent`

`.github/copilot-instructions.md`

```
# 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.

Gere um AGENTS.md e arquivos de regras correspondentes para cinco ferramentas a partir de um único formulário. [Abrir o gerador de AGENTS.md →](https://dotsagent.io/pt/instructions)

## Outros arquivos de instruções

[AGENTS.md](https://dotsagent.io/pt/instructions/files/agents-md)

[CLAUDE.md](https://dotsagent.io/pt/instructions/files/claude-md)

[GEMINI.md](https://dotsagent.io/pt/instructions/files/gemini-md)

[.cursor/rules/*.mdc](https://dotsagent.io/pt/instructions/files/cursor-rules)

[.devin/rules/*.md](https://dotsagent.io/pt/instructions/files/windsurf-rules)

[.clinerules/](https://dotsagent.io/pt/instructions/files/cline-rules)

[~/.openclaw/workspace/AGENTS.md](https://dotsagent.io/pt/instructions/files/openclaw-workspace)

## Fontes

1. [docs.github.com](https://docs.github.com/en/copilot/how-tos/configure-custom-instructions/add-repository-instructions)/en/copilot/how-tos/configure-custom-instructions/add-repository-instr
2. [docs.github.com](https://docs.github.com/en/copilot/reference/custom-instructions-support)/en/copilot/reference/custom-instructions-support
3. [docs.github.com](https://docs.github.com/en/copilot/tutorials/customize-code-review)/en/copilot/tutorials/customize-code-review
4. [github.blog](https://github.blog/changelog/2026-06-12-copilot-code-review-new-configurations-and-controls/)/changelog/2026-06-12-copilot-code-review-new-configurations-and-contr

Referência independente para quem cria agentes de IA. Não temos vínculo com nenhum dos fornecedores mencionados aqui.

© 2026 DotsAgent · Fatos verificados em 1 de outubro de 2026