AGENTS.mdAGENTS.md: konumu ve araçların dosyayı nasıl okuduğu
AGENTS.md, çoğu kodlama agent'ının ek yapılandırma gerektirmeden okuduğu, proje talimatlarını içeren düz bir Markdown dosyasıdır. OpenAI, bu dosya biçimini Linux Foundation bünyesindeki Agentic AI Foundation'a katkıda bulundu ve 60k'dan fazla açık kaynak projesi bunu kullanıyor.
Konumu
- Tüm proje için depo kök dizininde AGENTS.md.
- Alt dizinlerde veya paketlerde iç içe yer alan AGENTS.md dosyaları; agent'lar dizin ağacındaki en yakın dosyayı kullanır.
- OpenAI Codex: genel bir ~/.codex/AGENTS.override.md dosyası veya bu dosya boş ya da yoksa ~/.codex/AGENTS.md.
- Cline: genel bir ~/.agents/AGENTS.md dosyası.
- Claude Code, .claude/AGENTS.md dosyasını da kabul eder.
Biçim
Ön bilgi (frontmatter) veya zorunlu alan içermeyen düz Markdown; başlıklar serbesttir. Biçim bir boyut sınırı koymaz, ancak OpenAI Codex varsayılan olarak 32 KiB olan project_doc_max_bytes sınırında okumayı durdurur.
# Acme web app
Customer-facing web app with an admin area and a REST API.
## Commands
- Install: `pnpm install`
- Test: `pnpm test`
- Lint and type-check: `pnpm lint && pnpm tsc --noEmit`
## Code style
- TypeScript strict mode; no `any` in new code.
- Keep database access in `src/db/`.
## Never
- Never commit secrets or .env files.
- Never edit files under `src/generated/` by hand.
Öncelik ve birleştirme
Düzenlenen dosyaya en yakın AGENTS.md geçerlidir; sohbette verilen açık bir talimat ise tüm dosyaların önüne geçer. OpenAI Codex, proje kökünden çalışma dizinine kadar her dizinden bir dosyayı birleştirir; bu nedenle daha yakındaki dosyalar sona gelir ve önceliklidir. Claude Code, CLAUDE.md bulunduğunda varsayılan olarak AGENTS.md dosyalarını yok sayar.
Dosyayı okuyan araçlar
| Araç | Destek |
|---|---|
| OpenAI Codex | Yerel destek. Önce genel dosyayı, ardından kök dizinden çalışma dizinine kadar her dizinden en fazla bir dosyayı okur; varsayılan sınır 32 KiB'dir. |
| Claude Code | v2.1.277 sürümünden itibaren yerel destek sunar; ancak claude-md-and-agents-md olarak ayarlanmadığı sürece yalnızca CLAUDE.md veya CLAUDE.local.md yoksa kullanılır. |
| Cursor | Yerel destek sunar; kök ve iç içe dosyaları okur. İç içe dosyalar üst dosyalarla birleştirilir ve daha özelleşmiş dosya önceliklidir. |
| GitHub Copilot (cloud agent, code review, VS Code) | Depodaki her konumda yerel destek sunar; en yakın dosya geçerlidir. |
| Devin Desktop (formerly Windsurf) | Yerel destek sunar. Kök dizindeki dosya her zaman etkindir; alt dizindeki dosya yalnızca kendi dizini için geçerlidir. |
| Cline | Yerel desteğin yanı sıra genel ~/.agents/AGENTS.md dosyasını da kullanır; Rules panelinden etkinleştirip devre dışı bırakabilirsiniz. |
| Gemini CLI | İsteğe bağlı: .gemini/settings.json içindeki context.fileName alanına AGENTS.md ekleyin. |
| Aider | İsteğe bağlı: .aider.conf.yml dosyasına read: AGENTS.md ekleyin. |
| OpenClaw | Agent çalışma alanında gerekli işletim talimatları dosyası olarak yerel destek sunar. |
| Listed on agents.md (not individually re-verified) | Amp, Jules, Zed, Warp, goose, opencode ve JetBrains Junie dahil agents.md listesindeki 23 araçtan biri; bu araçları tek tek yeniden doğrulamadık. |
İpuçları
- Eski bir AGENT.md dosyasının adını mı değiştiriyorsunuz? agents.md, her iki adın da çalışmaya devam etmesi için mv AGENT.md AGENTS.md && ln -s AGENTS.md AGENT.md komutunu öneriyor.
- Test ve lint komutlarını listeleyin: agent'lar buldukları kontrolleri çalıştırıp bitirmeden önce hataları düzeltmeye çalışır.
- Monorepo'da tek bir uzun kök dosya oluşturmak yerine her paket için kısa bir AGENTS.md ekleyin.
- OpenAI Codex'te aynı dizindeki AGENTS.override.md, AGENTS.md dosyasından önceliklidir.
Tek bir formdan beş araç için AGENTS.md ve eşleşen kural dosyaları oluşturun. AGENTS.md oluşturucusunu açın →