Copilot Code Review’a AGENTS.md Desteği: Ne İşe Yarayacak?
Eh, Şöyle başlayayım: GitHub’ın Copilot tarafında bir süredir kafamı kurcalayan bir gerilim vardı. Bir yanda “Copilot kodumu incelesin” diyen ekipler, öbür yanda “ya bu Copilot bizim repo’nun konvansiyonlarını bilmiyor, ben buna nasıl güveneyim?” diye homurdananlar. Yanı review geliyor ama bağlam eksik kalıyor. Sanki dışarıdan biri gelmiş, ilk gün ilk PR’ı açıp yorum bırakıyor.
Peki ilk gün ne yapmalı?
Eğer bugün denemeye karar verdiyseniz ben sıralamayı şöyle yapardım:
- Repository köküne boş bir AGENTS.md oluşturun. Henüz hiçbir şey yazmadan commit etmeyin.
- Ekipten 2-3 senior geliştiriciyi 30 dakika toplayın. “Yeni gelen biri en sık hangi hatayı yapıyor?” diye sorun; cevaplar iskeleti verir.
- İlk versiyonu yazın ve yarım sayfayı geçmeyin.
- Bir test PR’ı açıp Copilot review isteyin.
- İki hafta sonra dosyayı revize edin.
- Neyin işe yaradığını ayıklayın.
- Neyin gürültü ürettiğini kırpın.
“`
Eksik bulduğum yanlar
Açık konuşayım: Her şey toz pembe değil.
Birkaç sınırlı tarafı var bu güncellemenin.
Birincisi, AGENTS.md sadece repository kökünden okunuyor.
Monorepo kullananlar için bu biraz sıkıntı; frontend ve backend’in farklı konvansiyonları olabilir, hepsini tek dosyaya tıkıştırmak çirkin oluyor.
İdeal olan, alt klasörlerde de AGENTS.md desteği olması.
Umarım önümüzdeki sürümlerde gelir.
Öncesinde “üçüncü” paragraf yine kaotik şekilde devam ediyor.
İkincisi, Copilot’un AGENTS.md’yi ne kadar “ciddiye aldığı” hâlâ deterministik değil.
Yanı aynı kuralı 10 PR’ın 9’unda hatırlıyor, 1’inde unutuyor.
Bu LLM’lerin doğası gereği normal ama “AGENTS.md koydum, artık her şey otomatik” beklentisine girmeyin.
Hâlâ insan review’ı şart.
Üçüncüsü; UI iyileştirmeleri güzel ama timeline collapse mantığı bazen aşırı sıkıştırıyor.
Bir Copilot dismissed olayı kayboluyor, sonra “bu yorum nereye gitti?” diye arıyorsunuz.
Bence bir genişletme tuşu daha belirgin olabilirdi.
Sıkça Sorulan Sorular
AGENTS.md dosyam varsa Copilot code review için ayrıca bir şey ayarlamam gerekiyor mu?
Hayır, gerekmiyor. Copilot, repository kökündeki AGENTS.md’yi zaten otomatik olarak okuyor. Yanı ekstra bir ayar açmanıza, planınızı yükseltmenize ya da özel izin tanımlamanıza hiç gerek yok. Dosyayı koyup commit ettiğiniz an, sonraki review’larda hemen devreye giriyor.
AGENTS.md ile CONTRIBUTING.md arasındaki fark ne?
CONTRIBUTING.md aslında insanlar için yazılıyor — hani katkı sağlayan geliştiricilere yol gösteriyor, açıklayıcı bir dil kullanıyor. AGENTS.md işe AI ajanlarının rahatça parse edebileceği, net ve direktif bir dille yazılmalı. İkisi bir arada bulunabilir, dahası önerilen de bu zaten. Sonuçta CONTRIBUTING.md’yi okuyan insan, AGENTS.md’yi okuyan ajan.
Evet, doğru duydunuz.
Başka ajanlar için yazdığım AGENTS.md’yi Copilot da kullanır mı?
Evet, kullanır. AGENTS.md formatı belirli bir araca özgü değil; markdown tabanlı genel bir konvansiyon bu. Mesela Cursor ya da Aider için yazdığınız dosyayı Copilot da okuyabiliyor. Ama şunu söyleyeyim: farklı ajanlar farklı bölümlere farklı ağırlık verebiliyor, o yüzden çıktıları ara sıra gözlemleyip dosyayı sadeleştirmek faydalı oluyor.
AGENTS.md’ye yazdığım her kural review’da uygulanacak mı?
Açıkçası, garanti veremem. LLM tabanlı bir sistem olduğu için Copilot bazen bazı kuralları gözden kaçırabiliyor — özellikle dosya çok uzunsa bu daha sık oluyor. Bence kritik kuralları kısa, net ve dosyanın üst kısmında tutmak en mantıklısı. Bir de tecrübeme göre “yapma” listesi, “yap” listesinden genelde çok daha etkili oluyor.
Draft PR’da Copilot review istemek ücretlendirmemi etkiler mi?
Şimdi, copilot code review zaten planınıza dahil, yanı draft PR olması ekstra bir ücret çıkarmıyor. Ama şunu bilmekte fayda var: her review bir kullanım sayılıyor. Dolayısıyla taslakta defalarca review istemek toplam tüketimi artırabilir. Bu yüzden draft aşamasında önce ciddi bir self-review yapıp ondan sonra Copilot’a göndermek hem daha verimli hem de daha temiz bir feedback üretiyor bence.
Kaynaklar ve İleri Okuma
Araya gireyim: GitHub Changelog: Copilot code review AGENTS.md support and UI improvements
20+ yıl deneyimli Azure Solutions Architect. Microsoft sertifikalı bulut mimari ve DevOps danışmanı. Azure, yapay zekâ ve bulut teknolojileri üzerine Türkçe teknik içerikler üretiyor.
4 comments