AGENTS.md mi CLAUDE.md mi GEMINI.md mi? Hangi dosya ne zaman?

Birden fazla kodlama ajanı kullanıyorsanız ortak kuralları AGENTS.md içinde tutun. Codex bunu doğrudan okur; Claude Code için kısa bir CLAUDE.md dosyasından @AGENTS.md içe aktarımı yapın; Gemini CLI'da context.fileName ayarına AGENTS.md ekleyin. Yalnız tek araca bağlı özellikleri vendor dosyasında bırakın.

Kısa karar tablosu

• Yalnız Codex: kökte AGENTS.md; monorepo paketlerinde gerekirse iç içe dosyalar.
• Yalnız Claude Code: CLAUDE.md; yol bazlı ayrıntılar için .claude/rules/.
• Yalnız Gemini CLI: varsayılan GEMINI.md veya ayarlarda seçtiğiniz dosya adı.
• Codex + Claude Code + Gemini CLI: AGENTS.md ortak kaynak; iki vendor için ince adaptör dosyaları.

AGENTS.md, ajanlara kurulum, test ve kodlama kurallarını veren açık bir Markdown biçimi olarak tanımlanıyor; zorunlu alanı yok ve iç içe dosyalarda düzenlenen dosyaya en yakın kural öncelik kazanıyor.[1] Bu özellikler onu taşınabilir ortak taban için iyi bir aday yapıyor.

Araçlar aynı dosyayı aynı biçimde okumuyor

Codex, oturum başında global dosyadan proje köküne ve çalışma dizinine kadar bir talimat zinciri kuruyor. OpenAI dokümanına göre daha yakın dosyalar zincire daha sonra ekleniyor ve önceki kuralları geçersiz kılabiliyor; varsayılan birleşik sınır 32 KiB.[2] Bunlar OpenAI'nin kendi ürün davranışı açıklamalarıdır.

Claude Code doğrudan AGENTS.md okumuyor. Anthropic, CLAUDE.md içine @AGENTS.md yazmayı veya sembolik bağlantı kullanmayı öneriyor; Claude'a özgü kurallar içe aktarımın altına eklenebiliyor.[3] Anthropic ayrıca bu talimatların zorunlu güvenlik politikası değil, modele verilen bağlam olduğunu söylüyor.[3]

Gemini CLI varsayılan olarak GEMINI.md kullanıyor. Google dokümanına göre global, çalışma alanı ve gerektiğinde yüklenen dizin bağlamlarını birleştiriyor; context.fileName ayarıyla AGENTS.md, CONTEXT.md ve GEMINI.md gibi adlar seçilebiliyor.[5] Bunlar Google'ın kendi ürün davranışı açıklamalarıdır.

Taşınabilir kurulum

Depo kökündeki AGENTS.md yalnız ortak ve doğrulanabilir kuralları taşısın:

• Kurulum: npm ci
• Kontrol: npm run check
• Build: npm run build
• Sınır: dist/ altındaki üretilmiş dosyaları düzenleme; .env dosyalarını commit etme.
• Tamamlandı ölçütü: check ve build çalıştır; değişen dosyaları ve başarısız kontrolleri bildir.

Claude adaptörü kısa kalabilir: ilk satıra @AGENTS.md yazın, altına yalnız Claude Code'a özel kuralları ekleyin. Gemini CLI'da tek kaynak istiyorsanız context.fileName listesinde yalnız AGENTS.md kullanın.

Birden çok dosya adını aynı anda açmak mümkündür, fakat aynı kuralı üç dosyada tekrar etmek çelişki ve eski bilgi riskini büyütür. Vendor dosyaları ortak kuralın kopyası değil, küçük bir uyumluluk katmanı olmalı.

Hangi bilgi nereye yazılmalı?

AGENTS.md içine kurulum komutlarını, testleri, dizin sınırlarını ve tamamlandı ölçütünü yazın. Secret, geçici görev notu, uzun ürün tarihi ve koddan zaten kolayca çıkarılabilen ayrıntıları eklemeyin.

Araç seçimini henüz yapmadıysanız Codex CLI, Claude Code ve Gemini CLI karşılaştırması daha doğru başlangıç noktasıdır. Talimat dosyası model seçiminin yerine de geçmez; GPT-5.6 Sol, Terra ve Luna ana rehberi bu kararı ayrı ele alır.

Talimat dosyası davranışı yönlendirir, sonucu garanti etmez. Erişim sınırını izin modu rehberiyle belirleyin; değişikliği kodlama ajanı çıktısı doğrulama listesiyle bağımsız kontrol edin.