‏خوندن کد با هوش مصنوعی، نه تولیدش

یه توسعه‌دهنده‌ی بک‌اند که آخر ژانویه‌ی ۲۰۲۶ به Spatie پیوست، بلافاصله وسط یه پروژه‌ی کلاینتِ بزرگ انداخته شد؛ کدبیسی که از ژوئن ۲۰۲۵ در حال توسعه بود و با بیش از ۱۵۰ هزار خط کد هنوز نصفه بود. این حجمِ زیادی کده برای جاافتادن.

ایده‌ی اصلی‌اش این بود: به‌جای اینکه AI رو سمت مسئله‌ی «کد بیشتر تولید کن» ببره، عکسش رو امتحان کرد و ازش کمک گرفت تا کدی که از قبل اونجا بود رو بفهمه.

خوشبختانه همکاراش یه workflow خوب چیده بودن: Laravel Boost، چند Claude Skill پروژه‌محور و سراسری، فایل‌های پروپیمونِ AGENTS.md و CLAUDE.md و یه فولدر docs/ (که البته چند هفته بعد رها شده بود). از اینا دوتاشون بیشترین کمک رو کردن. Laravel Boost ابزار دست‌کم‌گرفته‌شده‌ست؛ یه MCP server که به Claude دسترسی زنده به schema، routeها، config، artisan و tinker می‌ده. پس وقتی می‌پرسید «آیا سرویسی برای کار X هست؟» Claude به‌جای حدس‌زدن از روی اسم فایل‌ها، از Boost استفاده می‌کرد. تو سمت اسکیل‌ها هم بیشتر به php-guidelines-from-spatie برای قراردادهای PHP و لاراول، و laravel-inertia-react-structure برای فرانت‌اند تکیه کرد.

اما این پایه جای فهم واقعی سیستم رو نمی‌گیره. پس از Claude خواست یه طرح کلی سطح-بالا از کل کدبیس بده. توصیه‌ی اولش امتحان‌کردن یه codebase-onboarding skillه؛ نصبش کن، روی پروژه نشونه‌اش بگیر و دوتا فایل تحویل می‌گیری: یه راهنمای آنبوردینگ (شامل استک، معماری، نقاط ورود، چرخه‌ی حیات درخواست و کارهای رایج) و یه فایل CLAUDE.md مخصوص پروژه. جایگزین دیگه Repomixه که کل کدبیس رو به یه فایل دوست‌دار-AI تبدیل می‌کنه و با گزینه‌ی output.compress (که زیر کاپوت از Tree-sitter استفاده می‌کنه) حدود ۷۰٪ از تعداد توکن‌ها رو کم می‌کنه.

نکات کلیدی:

• به‌جای تولید کد، از AI برای فهمیدن کدبیس موجود استفاده کن
• Laravel Boost با دسترسی زنده به schema و routeها، Claude رو از حدس‌زدن نجات می‌ده
• یه codebase-onboarding skill راهنمای آنبوردینگ و فایل CLAUDE.md می‌سازه
• Repomix کل کدبیس رو فشرده و دوست‌دار-AI می‌کنه و تا ۷۰٪ توکن صرفه‌جویی می‌کنه