فایل Claude.md رو چطور مرتب کنیم؟
هوش مصنوعیClaude Opus 5.5خلاصهٔ کامل‌تر
Claude.md فایلیه که Claude Code اول هر جلسه می‌خونه تا زمینهٔ ثابت پروژه رو داشته باشه. به گفتهٔ این مقاله، این فایل باید فقط چیزایی رو نگه داره که Claude خودش نمی‌تونه بفهمه: قراردادهای تیم، تصمیم‌هایی که قبلاً گرفته شده، عبارت‌هایی که مشتری ازشون بدش میاد، یا ابزارهایی که ممنوعه. نویسنده می‌گه این فایل قرار نیست دفترچهٔ همهٔ اشتباه‌های Claude باشه و بیشتر آدما دقیقاً همینجا اشتباه می‌کنن.
دلیل اینکه فایل بلند ضرر داره ساده‌ست. هر خط با prompt خودت و کدبیس سر توجه مدل رقابت می‌کنه. مستندات Anthropic می‌گه Claude.md رو زیر ۲۰۰ خط نگه دار، چون فایل بلندتر احتمال نادیده گرفتن قانون‌ها رو بالا می‌بره. یه تحقیق جدا هم نشون داده فایل‌های context که ابزارهای AI نوشتن، عملکرد agentها رو یه کم بدتر کرده و هزینهٔ هر اجرا رو حدود ۲۰٪ بالا برده. یعنی خط‌های کلی مثل «کد تمیز بنویس» فقط توکن اضافه‌ان.
قوی‌ترین شاهد مقاله کار خود Anthropic هست. وقتی مدل‌های Claude 5 اومدن، تیم بیشتر از ۸۰٪ system prompt داخلی Claude Code رو حذف کرد و هیچ افت قابل اندازه‌گیری‌ای تو تست‌های کدنویسی ندید. نویسنده معتقده اگه خود سازندهٔ مدل می‌تونه بیشتر prompt خودشو پاک کنه، احتمالاً بیشتر محتوای Claude.md شما هم قابل حذفه.
ولی پاک کردن کامل فایل هم به نظر نویسنده زیاده‌رویه. این کار یه مشکل کیفیت رو مثل مشکل مقدار حل می‌کنه و خط‌هایی که واقعاً کار می‌کردن هم از بین می‌رن. روش پیشنهادی Anthropic یه سؤال ساده برای هر خطه: اگه این خط رو حذف کنم، Claude اشتباه می‌کنه؟ اگه جواب «نه» یا «مطمئن نیستم» هست، اون خط جاش اونجا نیست.
روند عملی مقاله اینه: اول /doctor prompt audit رو اجرا کن که دستورهای نوشته‌شده برای مدل‌های قدیمی و ارجاع به فایل‌هایی که دیگه نیستن رو نشون می‌ده. بعد بقیه رو خط‌به‌خط بررسی کن و هر چیزی که مدل‌های فعلی خودشون پیش‌فرض انجام می‌دن (مثل برنامه‌ریزی قبل از کار یا چک کردن کار خودشون) رو حذف کن. هر چیزی که یه تصمیم یا محدودیت پنهان رو نشون می‌ده، نگه دار. اگه هم Claude.md داری هم agents.md، بدون که Claude Code وقتی Claude.md نباشه خودش agents.md رو می‌خونه.
به گفتهٔ مقاله، همین منطق برای پلاگین‌هایی مثل Superpowers هم صدق می‌کنه. تو یه تست غیررسمی، ۹ skill pack صدها بار در برابر یه فایل placebo با طول مشابه اجرا شدن و فقط ۲ تاشون بهتر بودن. دستورهایی که از Claude.md حذف می‌کنی هم بیشتر جاشون تو prompt همون کاره: چیزی که همیشه درسته تو Claude.md می‌مونه، چیزی که مخصوص یه کاره می‌ره تو prompt.
نکات کلیدی:
- مستندات Anthropic: Claude.md رو زیر ۲۰۰ خط نگه دار
- Anthropic با اومدن Claude 5 بیشتر از ۸۰٪ system prompt داخلی Claude Code رو حذف کرد بدون افت عملکرد
- فایل‌های context ساخت ابزارهای AI حدود ۲۰٪ هزینه رو بالا بردن
- سؤال اصلی audit: اگه این خط نباشه، Claude اشتباه می‌کنه؟
- دستور /doctor prompt audit دستورهای قدیمی و ارجاع‌های مرده رو نشون می‌ده
- Claude Code وقتی Claude.md نباشه، agents.md رو می‌خونه
