AGENTS.md oluşturucu
Tek bir formu doldurarak komutlarınızı, kurallarınızı ve kesin sınırlarınızı içeren bir AGENTS.md oluşturun. Ayrıca Cursor, GitHub Copilot, Claude Code, Cline ve Devin Desktop için yazılmış yol kapsamlı bir kuralın yanı sıra AGENTS.md dosyasını varsayılan olarak okumayan araçlar için köprü dosyaları da elde edin.
Her aracın yönerge dosyalarını aradığı konumlar →
# Acme web uygulaması
Yönetim alanı ve küçük bir REST API içeren, müşterilere yönelik bir web uygulaması.
## Teknoloji yığınını belirt
Next.js, React, TypeScript, pnpm
## Komutları belirt
- Kurulum komutunu belirt: `pnpm install`
- Yerel çalıştırma komutunu belirt: `pnpm dev`
- Test komutunu belirt: `pnpm test`
- Lint ve tür denetimi komutlarını belirt: `pnpm lint && pnpm tsc --noEmit`
- Derleme komutunu belirt: `pnpm build`
## Kod stilini uygula
- Linter'ın uyguladığı biçimlendirme kurallarına uy ve değiştirilmemiş dosyalara dokunma.
- Girdileri ve çıktıları net, küçük fonksiyonları tercih et; yan etkileri sınırda tut.
- Yeni bir bağımlılık eklemeden önce sor.
- Her satırın ne yaptığını değil, açıkça anlaşılmayan kodun nedenini yorumla.
## Testler
- Değiştirdiğin her davranış için bir test ekle veya mevcut testi güncelle.
- İşin bittiğini söylemeden önce test komutunu çalıştır ve hataları düzelt.
- Test paketinin başarılı görünmesi için başarısız bir testi silme veya atlama.
## Commit'ler ve pull request'ler
- Commit başlıklarını emir kipinde ve 72 karakterden kısa yaz.
- Her pull request'i tek bir değişiklikle sınırla ve açıklamasında nasıl test ettiğini belirt.
- Her commit'ten önce lint ve testleri çalıştır.
## Asla
- Gizli bilgileri, API anahtarlarını veya .env dosyalarını asla commit etme.
- src/generated/ altındaki oluşturulmuş dosyaları asla elle düzenleme; bunun yerine yeniden oluştur.
- Production veritabanında asla yıkıcı komutlar çalıştırma.
- main dalına asla force-push yapma veya paylaşılan geçmişi yeniden yazma.
Beş araç için aynı kural
---
description: Bu glob ile eşleşen dosyalara ilişkin kurallar
globs: app/**/*.tsx
alwaysApply: false
---
Bu klasördeki yakındaki dosyalarda kullanılan kalıpları izle. Dışa aktarılan her fonksiyona bir docstring ve eşleşen test dosyasında bir test ekle.
---
applyTo: "app/**/*.tsx"
---
Bu klasördeki yakındaki dosyalarda kullanılan kalıpları izle. Dışa aktarılan her fonksiyona bir docstring ve eşleşen test dosyasında bir test ekle.
---
paths:
- "app/**/*.tsx"
---
Bu klasördeki yakındaki dosyalarda kullanılan kalıpları izle. Dışa aktarılan her fonksiyona bir docstring ve eşleşen test dosyasında bir test ekle.
---
paths:
- "app/**/*.tsx"
---
Bu klasördeki yakındaki dosyalarda kullanılan kalıpları izle. Dışa aktarılan her fonksiyona bir docstring ve eşleşen test dosyasında bir test ekle.
---
trigger: glob
globs: app/**/*.tsx
---
Bu klasördeki yakındaki dosyalarda kullanılan kalıpları izle. Dışa aktarılan her fonksiyona bir docstring ve eşleşen test dosyasında bir test ekle.
Bir talimat dosyasını etkili kılan nedir?
Kesin komutları dosyanın başına yakın yazın
Gerçek kurulum, test ve lint komutlarını bayraklarıyla birlikte dosyanın başlarında listeleyin. Teknoloji yığınını ve sürümleri tam olarak belirtin; açıklamanın muğlak kalacağı yerlerde kısa bir kod örneği verin.
Yapılmaması gerekenleri açıkça belirtin
Agent'ın sırlar, vendored kod veya production ortamı gibi konulara dokunmaması gerektiğini açıkça yazın. GitHub'ın incelediği dosyalarda en sık rastlanan yararlı kısıtlama, sırları asla commit etmemekti.
Her talimatı doğrulanabilir kılın
Commit etmeden önce npm test komutunu çalıştır ifadesi doğrulanabilir; değişikliklerini test et ise değildir. Çelişkileri giderin; çünkü iki satır birbiriyle çeliştiğinde model ikisinden birini izleyebilir.
Kısa tutun ve kuralları dosya yoluna göre ayırın
Anthropic dosya başına 200 satırın, Cursor ise kural başına 500 satırın altında kalmayı öneriyor. Tek bir alanla ilgili yönergeleri, yalnızca o dosyalar üzerinde çalışılırken yüklenecek şekilde dosya yolu kapsamlı bir kurala taşıyın. Import'lar dosyayı düzenli tutar ancak bağlam maliyetini düşürmez.
Agent'ın zaten bildiklerini atlayın
Dört kodlama agent'ıyla yapılan bir çalışmada, bağlam dosyaları görev başarısını tutarlı biçimde artırmadı ve çıkarım maliyetini %20'den fazla yükseltti. LLM tarafından yazılan dosyalar başarıyı bir miktar düşürdü, depo genel bakışları ise fayda sağlamadı. Bu nedenle dosyada yalnızca belirli araçlar gibi bariz olmayan gereksinimlere yer verin.
Hatalar tekrarlandıkça kural ekleyin
Az sayıda kuralla başlayın ve agent'ın aynı hatayı birden fazla kez yaptığını gördüğünüzde bir kural ekleyin. Tüm stil kılavuzunu yapıştırmak yerine örnek olarak mevcut bir dosyaya işaret edin.
AGENTS.md hakkında sorular
Claude Code, AGENTS.md dosyasını okur mu?
Evet, v2.1.277 sürümünden itibaren. Varsayılan olarak çalışma dizininde veya üst dizinlerinde CLAUDE.md, .claude/CLAUDE.md ya da CLAUDE.local.md yoksa yalnızca AGENTS.md veya .claude/AGENTS.md dosyasını okur. claude-md-and-agents-md ayarı her iki dosyanın da yüklenmesini sağlar. @AGENTS.md içeren bir CLAUDE.md ise her sürümde çalışır.
AGENTS.md dosyasında frontmatter veya belirli başlıklar bulunması gerekir mi?
Hayır. AGENTS.md, zorunlu alanları olmayan ve istediğiniz başlıkları kullanabileceğiniz düz bir Markdown dosyasıdır. agents.md sitesi; proje genel bakışı, build ve test komutları, kod stili, test, güvenlik notları ve pull request yönergeleri gibi bölümler öneriyor.
Monorepo'da AGENTS.md dosyasını nasıl kullanırım?
Kök dizine bir AGENTS.md, ayrıca kendi kurallarına ihtiyaç duyan her paketin içine bir tane koyun. Agent'lar düzenlenen koda en yakın dosyayı okur; çakışma varsa bu dosyadaki kurallar geçerli olur. agents.md bu bilgiyi belgelediğinde OpenAI ana deposunda 88 tane AGENTS.md dosyası vardı.
Gemini CLI'ın AGENTS.md dosyasını okumasını nasıl sağlarım?
Gemini CLI varsayılan olarak GEMINI.md dosyasını kullanmaya devam ediyor. .gemini/settings.json içindeki context.fileName alanına AGENTS.md dosyasını ekleyin; örneğin ["AGENTS.md", "GEMINI.md"]. Hangi dosyaların yüklendiğini görmek için /memory show komutunu çalıştırın.
Hangi kodlama agent'ları AGENTS.md dosyasını destekliyor?
Belgelerini incelediğimiz OpenAI Codex, Claude Code, Cursor, GitHub Copilot, Devin Desktop, Cline ve OpenClaw dosyayı yerel olarak okuyor; Gemini CLI ve Aider içinse tek satırlık bir yapılandırma gerekiyor. agents.md sitesi, Zed, Warp, goose, opencode, Jules ve JetBrains Junie dâhil toplam 23 uyumlu araç listeliyor.
AGENTS.md biçimini kim sürdürüyor?
OpenAI, AGENTS.md'yi 2025-12-09 tarihinde MCP ve goose ile birlikte duyurulan, Linux Foundation tarafından yönetilen Agentic AI Foundation'a katkıda bulundu. agents.md sitesine göre 60k'dan fazla açık kaynak proje bu biçimi kullanıyor.