GitHub Copilot custom instructions: lokasi dan cara tool membacanya

GitHub Copilot membaca satu file untuk seluruh repositori, .github/copilot-instructions.md, serta file .instructions.md khusus jalur. GitHub Copilot juga mengikuti AGENTS.md, atau satu file CLAUDE.md atau GEMINI.md di root.

Lokasi

• .github/copilot-instructions.md, berlaku untuk seluruh repositori.
• .github/instructions/**/NAME.instructions.md, berlaku untuk file yang cocok dengan applyTo.
• AGENTS.md di direktori mana pun dalam repositori; file terdekat yang berlaku.
• Satu file CLAUDE.md atau GEMINI.md di root sebagai alternatif.

Format

Markdown; spasi di antara instruksi diabaikan. Hanya file .instructions.md yang menggunakan frontmatter: applyTo berisi glob yang dipisahkan koma dan excludeAgent menerima "code-review" atau "cloud-agent". Batas 4,000 karakter untuk code review dihapus pada 2026-06-12, dan GitHub menyarankan maksimal sekitar 1,000 baris per file.

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

Prioritas dan penggabungan

Instruksi pribadi diterapkan lebih dulu, lalu instruksi repositori, kemudian organisasi; semua kumpulan instruksi yang relevan tetap dikirim. Jika file khusus jalur dan file untuk seluruh repositori sama-sama cocok, Copilot menggunakan keduanya. Code review membaca instruksi dari branch head pull request.

Tips

• Di github.com, file .instructions.md khusus jalur hanya berfungsi untuk Copilot cloud agent dan Copilot code review.
• Tambahkan excludeAgent: "code-review" agar file tidak digunakan dalam review, tetapi tetap digunakan oleh cloud agent.
• Copilot cloud agent dapat membuat draf copilot-instructions.md untuk Anda; batasi panjangnya hingga sekitar dua halaman dan jangan mengaitkannya dengan satu tugas tertentu.

File instruksi lainnya