GitHub Copilot custom instructions: konumu ve araçların dosyayı nasıl okuduğu

GitHub Copilot, depo genelinde geçerli tek bir dosyayı (.github/copilot-instructions.md) ve yola özgü .instructions.md dosyalarını okur. Ayrıca AGENTS.md dosyalarını veya kök dizindeki tek bir CLAUDE.md ya da GEMINI.md dosyasını da dikkate alır.

Konumu

• .github/copilot-instructions.md, deponun tamamına uygulanır.
• .github/instructions/**/NAME.instructions.md, applyTo ile eşleşen dosyalara uygulanır.
• Deponun herhangi bir yerindeki AGENTS.md dosyaları; en yakındaki dosya önceliklidir.
• Alternatif olarak, kök dizindeki tek bir CLAUDE.md veya GEMINI.md dosyası.

Biçim

Markdown; talimatlar arasındaki boşluklar yok sayılır. Yalnızca .instructions.md dosyalarında frontmatter kullanılır: applyTo, virgülle ayrılmış glob'ları; excludeAgent ise "code-review" veya "cloud-agent" değerlerini alır. Code review için 4,000 karakter sınırı 2026-06-12 tarihinde kaldırıldı. GitHub, dosya başına yaklaşık 1,000 satırı aşmamayı öneriyor.

Frontmatter anahtarları: 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.

Öncelik ve birleştirme

Önce kişisel talimatlar, ardından depo ve kuruluş talimatları gelir; ilgili tüm talimat kümeleri yine de gönderilir. Yola özgü bir dosya ile depo genelindeki dosya aynı anda eşleşirse Copilot ikisini de kullanır. Code review, talimatları pull request'in head branch'inden okur.

İpuçları

• github.com'da yola özgü .instructions.md dosyaları yalnızca Copilot cloud agent ve Copilot code review ile çalışır.
• Bir dosyanın incelemelerde kullanılmasını engellerken cloud agent'ın dosyayı kullanmasını sağlamak için excludeAgent: "code-review" ekleyin.
• Copilot cloud agent sizin için bir copilot-instructions.md taslağı hazırlayabilir; dosyayı yaklaşık iki sayfayla sınırlayın ve tek bir göreve özgü hâle getirmeyin.

Diğer talimat dosyaları