Rehber
AGENTS.md: birçok kodlama ajanı için tek talimat dosyası
Her kodlama ajanı kendi talimat dosyasını istiyordu. AGENTS.md tek bir dosyada buluşma denemesi — insanlar için değil, ajanlar için yazılmış bir README.
Ahmet Karaca ·
Nedir
AGENTS.md açık bir biçim: deponun kökünde duran ve kodlama ajanlarına o depoda nasıl çalışılacağını anlatan bir Markdown dosyası — nasıl derlenip sınanacağı, korunacak kurallar, dokunulmayacak yerler. Linux Foundation bünyesindeki Agentic AI Foundation yürütüyor; agents.md onu okuyan yirmi beşten fazla ajanı listeliyor, aralarında OpenAI Codex, GitHub Copilot, Cursor, Gemini CLI ve Jules var.
Zorunlu bir yapısı yok. Düz başlıklar ve kısa listeler en iyi çalışıyor, çünkü ajan dosyanın tamamını her seferinde okuyor.
İç içe dosyalar ve senin olan dosya
- Bir monorepoda her paketin kendi AGENTS.md'si olabilir. Düzenlenen yere en yakın dosya geçerli oluyor; sohbette yazdığın ise hepsinin önüne geçiyor.
- Codex dosyaları deponun kökünden bulunduğun klasöre doğru okuyup bu sırayla birleştiriyor; yani yakındaki dosya son sözü söylüyor. Varsayılan olarak 32 KiB'ta yeni dosya eklemeyi bırakıyor.
- Codex proje dosyalarından önce kişisel bir dosya da okuyor: ev dizinindeki
~/.codex/AGENTS.md. Projenin değil, senin nasıl çalıştığın oraya yazılıyor.
Claude Code AGENTS.md yerine kendi CLAUDE.md dosyasını okuyor; bir CLAUDE.md başka bir dosyayı @ ile başlayan bir satırla içine alabiliyor, bu da ikisinin birbirinden ayrılmasını önlüyor.
Yazmaya değer olan
Ajanın tahmin edemeyeceği komutlar, başka türlü bozacağı kurallar ve senin sürekli düzelttiğin şeyler. Bir cümle, ajanın yaptığını değiştiriyorsa yerini hak ediyor; genel olarak iyi uygulamayı tekrar eden bir cümle her istekte okunma süresi harcıyor ve hiçbir şeyi değiştirmiyor.
# Nasıl çalışıyorum - Yeni bir dosya önermeden önce var olanı oku. - Dosya silmeden ya da yıkıcı bir komut çalıştırmadan önce sor. - Üçten fazla dosyaya dokunacaksan önce birkaç satırlık plan yaz. - Commit mesajını deponun zaten kullandığı dilde yaz.
Proje bilgilerini deponun dosyasında, kendinle ilgili tercihleri kişisel dosyanda tut. Paylaşılan bir depoya commit'lenen kişisel bir tercih, herkesin kuralına dönüşüyor.
Coredence nerede devreye giriyor
Yazması zor olan kişisel kısım, çünkü kullandığın her asistana dağılmış aylarca süren düzeltmelerden geliyor. Coredence onu ölçüyor: kendi oturumlarını, commit'lerini ve notlarını okuyor, onları nasıl çalıştığını anlatan anılara dönüştürüp pekiştiriyor ve her birini doğduğu izlere bağlı tutuyor. Açarsan zihnini ~/.codex/AGENTS.md dosyasına yazıyor ve her döngüde tazeliyor — kendi işaretli bölümünde; dosyaya senin yazdıklarına dokunmuyor. Claude Code, Copilot ve Gemini aynı zihni kendi dosyalarında alıyor.
Gerçek uygulamayı uydurma bir kişinin zihniyle, tarayıcında, hiçbir şey kurmadan deneyebilirsin.
Tarayıcında dene