Agent talimat dosyaları
Her kodlama agent'ı işe başlamadan önce kalıcı talimatları içeren bir proje dosyası yükler. Her aracın hangi dosyaya baktığını, hangi frontmatter alanlarını anladığını ve global, proje düzeyindeki ve iç içe kopyaların nasıl birleştirildiğini burada bulabilirsiniz. Bilgiler, 2026-10-01 tarihinde sağlayıcıların belgeleriyle karşılaştırılarak doğrulandı.
Hangi araç hangi dosyayı okuyor?
| Araç | Okuduğu dosyalar | AGENTS.md |
|---|---|---|
| OpenAI Codex | AGENTS.mdAGENTS.override.md~/.codex/AGENTS.md | Yerel |
| Claude Code | CLAUDE.mdCLAUDE.local.md.claude/rules/*.md~/.claude/CLAUDE.mdAGENTS.md | Yerel |
| Cursor | .cursor/rules/*.mdcAGENTS.md | Yerel |
| GitHub Copilot | .github/copilot-instructions.md.github/instructions/*.instructions.mdAGENTS.mdCLAUDE.mdGEMINI.md | Yerel |
| Gemini CLI | GEMINI.md~/.gemini/GEMINI.md.gemini/settings.json | Yapılandırmayla |
| Devin Desktop (önceden Windsurf) | .devin/rules/*.md.windsurf/rules/*.md.windsurfrules~/.codeium/windsurf/memories/global_rules.mdAGENTS.md | Yerel |
| Cline | .clinerules/*.md.cline/rules/*.mdAGENTS.md.cursorrules.windsurfrules | Yerel |
| Aider | .aider.conf.yml | Yapılandırmayla |
| OpenClaw | AGENTS.mdSOUL.mdIDENTITY.mdUSER.mdMEMORY.md | Yerel |
Tek bir AGENTS.md dosyasını doğruluk kaynağı olarak kullanın ve diğer araçları bu dosyaya yönlendirin. Yukarıdaki dokuz araçtan yedisi dosyayı ek ayar gerektirmeden okur; Gemini CLI ve Aider için birer yapılandırma satırı gerekir. Yalnızca @AGENTS.md yazan bir CLAUDE.md dosyası da eski Claude Code sürümlerinin güncel kalmasını sağlar. AGENTS.md ile ifade edilemeyen, belirli yollarla sınırlı kurallar için her aracın kendi kural biçimini kullanın.
Tüm talimat dosyaları
AGENTS.mdAGENTS.md
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.
CLAUDE.mdCLAUDE.md (Claude Code)
CLAUDE.md, Claude Code'un başlatılırken ana dizininizden, projeden ve tüm üst dizinlerden yüklediği bellek dosyasıdır. .claude/rules/ içindeki yola bağlı kurallar, yalnızca eşleşen dosyalar okunduğunda yüklenen ek yönergeler sağlar.
GEMINI.mdGEMINI.md (Gemini CLI)
GEMINI.md, Gemini CLI'ın her prompt ile gönderdiği bağlam dosyasıdır. context.fileName içinde ayarladığınız AGENTS.md dosyasını veya başka bir adı da okuyabilir.
.cursor/rules/*.mdcCursor Project Rules (.cursor/rules/*.mdc)
Cursor Project Rules, her kuralın ne zaman ekleneceğini frontmatter ile belirlediğiniz .cursor/rules/ içindeki .mdc dosyalarıdır. Cursor ayrıca AGENTS.md dosyalarını, depodan ayrı olarak tanımlanan User Rules ve Team Rules kurallarını da okur.
.github/copilot-instructions.mdGitHub Copilot custom instructions
GitHub Copilot, depo genelinde geçerli tek bir dosyayı (.github/copilot-instructions.md) ve yola özgü .instructions.md dosyalarını okur. Ayrıca AGENTS.md dosyalarını veya kök dizindeki tek bir CLAUDE.md ya da GEMINI.md dosyasını da dikkate alır.
.devin/rules/*.mdDevin Desktop (Windsurf) rules
2026-06-02 tarihinden beri Windsurf'ün yeni adı olan Devin Desktop, kural dosyalarını .devin/rules/ konumundan okur; .windsurf/rules/ konumunu ve eski .windsurfrules dosyasını da kabul eder. Her kuralın ne zaman devreye gireceğini tetikleyicisi belirler: her zaman, glob eşleşmesiyle, modelin seçimiyle veya elle çağrılarak.
.clinerules/Cline Rules (.clinerules/)
Cline Rules, Cline'ın genel kurallar ve AGENTS.md ile birleştirdiği .clinerules/ içindeki Markdown dosyalarıdır. İsteğe bağlı paths frontmatter'ı, bir kuralı eşleşen dosyalarla sınırlar.
~/.openclaw/workspace/AGENTS.mdOpenClaw workspace bootstrap files
OpenClaw, her ajanın bağlamını çalışma alanındaki Markdown başlangıç dosyalarından oluşturur. Bu dosyaların başında zorunlu AGENTS.md gelir. Dosyalar, her yeni oturumun ilk turunda system prompt'a eklenir.