ازت یه تغییر کوچیک خواستی، ایجنت ۳۰۰ خط عوض کرده، دو تا کامنت قدیمی رو پاک کرده و یه لایه‌ی انتزاعی جدید هم «برای انعطاف‌پذیری» اضافه کرده. آشناست؟
Andrej Karpathy توی یه پست در X دقیقاً همین‌ها رو گفته بود: مدل‌ها به جای تو فرض می‌کنن و ادامه میدن، سؤال نمی‌پرسن، کد رو بی‌دلیل پیچیده می‌کنن و به چیزهایی که بهشون مربوط نیست دست می‌زنن. این ریپو همون مشاهدات رو کرده یه فایل CLAUDE.md و الان بیشتر از ۲۲۸ هزار ستاره داره.
چهار اصل این فایل
- اول فکر، بعد کد: فرض‌هات رو بگو، اگه چند تا برداشت ممکنه همه رو بگو و اگه گیج شدی، بپرس.
- سادگی اول: فقط کمترین کدی که مسئله رو حل می‌کنه. نه فیچر اضافه، نه انتزاع برای کدی که یه بار استفاده میشه.
- تغییر جراحی‌وار: فقط چیزی رو عوض کن که لازمه. کد مرده‌ی قبلی رو گزارش بده، پاکش نکن.
- هدف‌محور: به جای «درستش کن» بگو «یه تست بنویس که باگ رو نشون بده، بعد پاسش کن».
نصب
راه پیشنهادی README، نصب به شکل پلاگین داخل Claude Code هست:
/plugin marketplace add forrestchang/andrej-karpathy-skills
/plugin install andrej-karpathy-skills@karpathy-skills
اگه فقط برای یه پروژه می‌خوایش، محتوای CLAUDE.md ریپو رو به فایل CLAUDE.md پروژه‌ت اضافه کن. برای Cursor هم یه rule آماده داخل ریپو هست.
اگه از Codex یا ابزار دیگه‌ای استفاده می‌کنی، همین چهار اصل رو بذار توی AGENTS.md. برای نوشتنش پرامپت AGENTS.md رو آماده کردم. ریشه‌ی این حرف‌ها رو هم توی سخنرانی کارپاتی درباره‌ی نرم‌افزار ۳.۰ می‌بینی.
یه نکته‌ی منصفانه: راهنمای رسمی Claude Code میگه CLAUDE.md رو کوتاه نگه دار و فقط چیزی بنویس که ایجنت از خود کد نمی‌فهمه. این فایل کوتاهه و به سبک کار ربط داره، نه ساختار پروژه، پس با اون توصیه جور درمیاد.
ایجنت خوب، کمتر می‌نویسه و بیشتر می‌پرسه.