GitHub Copilot custom instructions: dove si trova e come lo leggono gli strumenti

GitHub Copilot legge un file per l'intero repository, .github/copilot-instructions.md, oltre ai file .instructions.md specifici per percorso. Rispetta anche AGENTS.md oppure un unico CLAUDE.md o GEMINI.md nella root.

Dove si trova

• .github/copilot-instructions.md, applicato all'intero repository.
• .github/instructions/**/NAME.instructions.md, applicato ai file individuati da applyTo.
• AGENTS.md in qualsiasi punto del repository; prevale il file più vicino.
• Un unico CLAUDE.md o GEMINI.md nella root, in alternativa.

Formato

Markdown; gli spazi tra le istruzioni vengono ignorati. Solo i file .instructions.md supportano il frontmatter: applyTo contiene glob separati da virgole ed excludeAgent accetta "code-review" o "cloud-agent". Il code review ha rimosso il limite di 4,000 caratteri il 2026-06-12 e GitHub consiglia di non superare circa 1,000 righe per file.

Chiavi 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.

Priorità e unione

Prima vengono applicate le istruzioni personali, poi quelle del repository e infine quelle dell'organizzazione; tutti i gruppi pertinenti vengono comunque inviati. Se corrispondono sia un file specifico per percorso sia quello per l'intero repository, Copilot li usa entrambi. Il code review legge le istruzioni dal branch head della pull request.

Suggerimenti

• Su github.com, i file .instructions.md specifici per percorso funzionano solo con Copilot cloud agent e Copilot code review.
• Aggiungi excludeAgent: "code-review" per escludere un file dalle revisioni, lasciandolo disponibile al cloud agent.
• Copilot cloud agent può creare una bozza di copilot-instructions.md; mantienila intorno alle due pagine e non legarla a una singola attività.

Altri file di istruzioni