‏Spatie گایدلاین‌هاشو به Claude Code یاد داد

تیم Spatie تو یه پست کوتاه توضیح داده چرا راهنمای کدنویسی‌شو برای هوش مصنوعی بازنویسی کرده. به گفتهٔ خودشون، سال‌هاست اپلیکیشن‌های بزرگ لاراول می‌سازن و سرمایه‌گذاری روی خوانایی کد در بلندمدت جواب پس داده. این دانش رو قبلاً هم تو دوره‌های PHP و Laravel Beyond CRUD و هم تو گایدلاین‌های عمومی‌شون منتشر کرده بودن.

مسئله از جایی شروع شد که با فراگیر شدن ایجنت‌هایی مثل Claude Code، بخش بیشتری از کد Spatie رو خود ایجنت می‌نویسه. اما ایجنت بدون هیچ تنظیماتی خبری از سبک کدنویسی تیم نداره و طبیعتاً کدی می‌ده که با بقیهٔ پروژه جور نیست.

راه‌حل‌شون این بود که گایدلاین‌ها رو به زبونی که یه مدل می‌فهمه بازنویسی کنن و تو صفحه‌ای به اسم «Using our guidelines with AI» بذارن. اونجا توضیح داده شده چطور Claude Code رو به این قواعد وصل کنی. Povilas هم ویدیویی ساخته که نصب و استفاده‌ش رو نشون می‌ده.

به گفتهٔ نویسنده، اگه از قبل این گایدلاین‌ها رو پذیرفته باشی، وقت خیلی کمتری صرف اصلاح خروجی Claude می‌شه. تیم تأکید کرده همهٔ کدها هنوزم دست آدم‌ها بازبینی و مرتب می‌شن و پیدا کردن تعادل درست بین آدم و ایجنت، موضوع یه پست جداست. قراره بعضی قواعد رو هم به مرور تغییر بدن تا ایجنت‌ها بهتر رفتار کنن.

نکات کلیدی:

• Spatie گایدلاین‌های PHP و لاراولش رو به شکلی درآورده که ایجنت‌های هوش مصنوعی بفهمن
• صفحهٔ «Using our guidelines with AI» طرز وصل کردن Claude Code به این قواعد رو توضیح می‌ده
• هدف اینه که خروجی اول ایجنت خواناتر باشه و وقت کمتری برای اصلاحش بره
• کدی که ایجنت می‌نویسه هنوزم بازبینی انسانی داره