‏AGENTS.md رو پاک کنیم یا نگهش داریم؟

نویسنده تو خبرنامهٔ پست‌هاگ می‌گه قاعدهٔ context engineering (یعنی همون کار آماده‌کردن اطلاعات و دستورها برای مدل) برعکس شده. قبلاً کار این بود که هرچی مدل نمی‌دونه رو بهش اضافه کنی، ولی حالا که مدل‌ها بهتر شدن همون توضیح‌های اضافه خروجی رو بدتر می‌کنن. به گفتهٔ نویسنده، انتروپیک هم به همین دلیل ۸۰ درصد سیستم‌پرامپت Claude Code رو حذف کرده و بوریس چرنی، سازندهٔ Claude Code، پیشنهاد می‌ده هر شش ماه فایل CLAUDE.md رو از صفر بنویسی.

راه اول ساده‌ترینه: دستور /doctor که تو بیشتر ایجنت‌های کدنویسی هست رو اجرا کن. این دستور پرامپت‌های تکراری رو پاک می‌کنه، تنظیم‌های خراب و پلاگین‌های بلااستفاده رو پیدا می‌کنه و می‌گه هر فایل چقدر توکن می‌گیره. برای فایل AGENTS.md سایت پست‌هاگ حدود ۱۷۸۰ توکن مقیم گزارش داده و گفته می‌شه ۳۵۰ توکنش رو کم کرد. در کل هم با خاموش‌کردن ۳ پلاگین و ۳ اسکیل، حدود ۶ هزار توکن در هر سشن صرفه‌جویی می‌شد.

ولی نویسنده تاکید داره که این ابزار درستی محتوا رو چک نمی‌کنه، فقط چیزی رو می‌بینه که از کد درمی‌آد. مثالش خود پست‌هاگه: یه خط تو AGENTS.md نوشته بودن که همهٔ مرج‌ها باید از صف مرج Trunk رد بشن، بعد صف رو موقتاً متوقف کردن و یادشون رفت اون خط رو عوض کنن. ۲۱ ساعت ایجنت‌ها دستور غلط داشتن، یه PR ده ساعت گیر کرد و یه مهندس ۴۵ دقیقه دنبال علتش گشت.

راه دوم اینه که کانتکست رو مثل کد تست کنی. هر بار که با تغییر کانتکست جلوی یه اشتباه رو گرفتی، همون پرامپتی که باعثش شده بود رو به عنوان eval نگه دار. پست‌هاگ ویزارد خودش رو روی حدود ۴۰ اپ نمونه اجرا می‌کنه و برای هرکدوم یه PR می‌سازه، بعد یه ایجنت دوم به اسم pr-evaluator از روی diff و لاگ سشن بهشون نمره می‌ده. نسخهٔ سبکش هم جواب می‌ده: پرامپت‌های خراب رو تو یه فایل failures.md جمع کن و بعد از هر ویرایش دوباره اجراشون کن.

راه سوم مستقیم‌ترینه: از خود ایجنت بازخورد بخواه. آخر پرامپت ویزارد پست‌هاگ ازش می‌پرسه چه اطلاعاتی کم داشته که جلوی خطاها و ویرایش‌های اشتباه رو می‌گرفت، و همین یه فید ارزون از باگ‌های واقعی می‌سازه. چون نمی‌شه حرف ایجنت رو همین‌جوری قبول کرد، این بازخوردها اول خوشه‌بندی و بعد با ساب‌ایجنت بازتولید و تایید می‌شن. توصیهٔ عملی نویسنده اینه: از ایجنت بخواه بگه از کدوم فایل‌های کانتکست استفاده کرده.

نکات کلیدی:

• انتروپیک ۸۰ درصد سیستم‌پرامپت Claude Code رو حذف کرده؛ جهت کانتکست‌انجینیرینگ از اضافه‌کردن به کم‌کردن چرخیده.

• گزارش /doctor برای AGENTS.md سایت پست‌هاگ ۱۷۸۰ توکن مقیم و امکان کم‌کردن ۳۵۰ توکن رو نشون داد.

• خاموش‌کردن ۳ پلاگین و ۳ اسکیل بلااستفاده، به طور میانگین ۶ هزار توکن در هر سشن آزاد می‌کرد.

• یه خط قدیمی دربارهٔ صف مرج، ۲۱ ساعت ایجنت‌ها رو گمراه کرد و یه PR رو ۱۰ ساعت گیر انداخت.

• معیار حذف: هر خطی که نمی‌تونی بگی جلوی کدوم خطا رو می‌گیره، باید پاک بشه.