GitHub Copilot custom instructions: dónde se encuentra y cómo lo leen las herramientas

GitHub Copilot lee un archivo para todo el repositorio, .github/copilot-instructions.md, además de archivos .instructions.md específicos para determinadas rutas. También tiene en cuenta AGENTS.md o un único archivo CLAUDE.md o GEMINI.md en la raíz.

Dónde se encuentra

• .github/copilot-instructions.md, aplicado a todo el repositorio.
• .github/instructions/**/NAME.instructions.md, aplicado a los archivos que coincidan con applyTo.
• AGENTS.md en cualquier lugar del repositorio; se aplica el más cercano.
• Un único archivo CLAUDE.md o GEMINI.md en la raíz, como alternativa.

Formato

Markdown; se ignoran los espacios en blanco entre instrucciones. Solo los archivos .instructions.md admiten frontmatter: applyTo contiene patrones glob separados por comas y excludeAgent acepta "code-review" o "cloud-agent". El 2026-06-12, la revisión de código eliminó el límite de 4,000 caracteres, y GitHub recomienda no superar aproximadamente 1,000 líneas por archivo.

Claves del 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.

Precedencia y combinación

Primero se aplican las instrucciones personales, después las del repositorio y, por último, las de la organización; aun así, se envían todos los conjuntos pertinentes. Si coinciden un archivo específico para una ruta y el archivo para todo el repositorio, Copilot usa ambos. La revisión de código lee las instrucciones de la rama de origen del pull request.

Consejos

• En github.com, los archivos .instructions.md específicos para determinadas rutas solo funcionan con Copilot cloud agent y Copilot code review.
• Añade excludeAgent: "code-review" para excluir un archivo de las revisiones y permitir que cloud agent siga usándolo.
• Copilot cloud agent puede redactar copilot-instructions.md por ti; limita el archivo a unas dos páginas y evita que dependa de una tarea concreta.

Otros archivos de instrucciones