GitHub Copilot custom instructions : emplacement et lecture par les outils

GitHub Copilot lit un fichier pour tout le dépôt, .github/copilot-instructions.md, ainsi que des fichiers .instructions.md spécifiques à certains chemins. Il prend également en compte AGENTS.md, ou un seul fichier CLAUDE.md ou GEMINI.md à la racine.

Emplacement

• .github/copilot-instructions.md, appliqué à l'ensemble du dépôt.
• .github/instructions/**/NAME.instructions.md, appliqués aux fichiers correspondant à applyTo.
• AGENTS.md où qu'il se trouve dans le dépôt ; le fichier le plus proche prévaut.
• Un seul fichier CLAUDE.md ou GEMINI.md à la racine, en guise d'alternative.

Format

Markdown ; les espaces entre les instructions sont ignorés. Seuls les fichiers .instructions.md acceptent du frontmatter : applyTo contient des globs séparés par des virgules et excludeAgent accepte "code-review" ou "cloud-agent". La revue de code n'est plus limitée à 4,000 caractères depuis le 2026-06-12, et GitHub recommande de ne pas dépasser environ 1,000 lignes par fichier.

Clés du 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.

Priorité et fusion

Les instructions personnelles sont prioritaires, suivies de celles du dépôt, puis de l'organisation ; tous les ensembles pertinents sont néanmoins transmis. Si un fichier spécifique à un chemin et le fichier applicable à tout le dépôt correspondent, Copilot utilise les deux. La revue de code lit les instructions de la branche source de la pull request.

Conseils

• Sur github.com, les fichiers .instructions.md spécifiques à un chemin ne fonctionnent qu'avec l'agent cloud Copilot et la revue de code Copilot.
• Ajoutez excludeAgent: "code-review" pour exclure un fichier des revues tout en le laissant accessible à l'agent cloud.
• L'agent cloud Copilot peut rédiger votre fichier copilot-instructions.md ; limitez-le à environ deux pages et évitez de le lier à une seule tâche.

Autres fichiers d’instructions