Claude Code حالا AGENTS.md رو هم میخونه
خلاصهٔ کاملتر
تو مخزن Claude Code یه پلاگین داخلی به اسم agents-md هست که فایلهای AGENTS.md رو همونجوری میخونه که Claude Code فایل CLAUDE.md رو میخونه. این فایلها دستورالعملهای پروژه برای ایجنتها هستن. یعنی اگه تیمت برای ابزارهای دیگه AGENTS.md نوشته، لازم نیست یه نسخهٔ جدا برای Claude Code نگه داری.
همهچی با یه گزینه به اسم instructionFiles کنترل میشه که چهار مقدار داره:
- claude-md: فقط CLAUDE.md لود میشه و پلاگین کاری نمیکنه
- claude-md-or-agents-md (پیشفرض): اگه پروژه هیچ CLAUDE.mdای از خودش نداشته باشه، AGENTS.mdها جاش لود میشن
- claude-md-and-agents-md: هر دو کنار هم لود میشن و فایل تکراری دو بار خونده نمیشه
- managed-only: فایلهای پروژه و کاربر حذف میشن و فقط فایل مدیریتشدهٔ سازمان میمونه
تو /config این گزینه با اسم «Project instructions» اومده. دستی هم میشه تو تنظیمات کاربر (~/.claude/settings.json) یا managed settings گذاشتش. ولی .claude/settings.json خود پروژه برای گزینههای پلاگین خونده نمیشه:
{
"pluginConfigs": {
"agents-md@builtin": {
"options": { "instructionFiles": "claude-md-and-agents-md" }
}
}
}نکتهٔ جالب اینه که پلاگین خودش فایلها رو به مدل نمیده. فقط از طریق هوک prompt.context فایلهای AGENTS.md رو بهعنوان فایل project به لیست موتور اضافه میکنه. پس از نظر جا تو context، قاببندی و قوانین حذف، دقیقاً مثل یه CLAUDE.md رفتار میشه. مثلاً subagentهایی مثل Explore و Plan که دستورالعمل پروژه رو نمیگیرن، این فایلها رو هم نمیگیرن. وقتی یه فایل تو یه زیرپوشه Read میشه، AGENTS.md اون پوشه هم ضمیمه میشه، مگه اینکه اون پوشه CLAUDE.md خودش رو داشته باشه.
مستندات صادقانه چند تا فرق باقیمونده رو هم گفته. مثلاً فایلهای تو در تو فقط با Read متنی ضمیمه میشن، نه با @-mention یا فایل باز تو IDE. پوشههای --add-dir هم AGENTS.md نمیدن و /memory این فایلها رو نمیشناسه. اسم قدیمی گزینه projectInstructions بوده که فعلاً هنوز خونده میشه. تلمتری هم فقط تعداد و حالت رو ثبت میکنه، نه مسیر یا متن فایل.
نکات کلیدی:
- گزینهٔ instructionFiles چهار حالت داره و پیشفرضش claude-md-or-agents-md هست
- تو /config با اسم «Project instructions» پیدا میشه
- تنظیمات پروژه (.claude/settings.json) برای این گزینه خونده نمیشه
- AGENTS.md بهعنوان فایل project اضافه میشه و همون قوانین CLAUDE.md روش اعمال میشه
- پوشههای --add-dir و دستور /memory هنوز AGENTS.md رو پشتیبانی نمیکنن




