از V1.0 به V2.0: بازنگری در خط لوله Vibe Coding

اخیراً یک غلط تایپی کوچک را در پروژه متن‌باز خود، vibe-coding-universal، اصلاح کردم. یک برچسب را از v2.0 (قدیمی) به v1.0 (قدیمی) تغییر دادم.

این تغییر کوچک، مشکل بزرگی را آشکار کرد. حتی خود من هم نام نسخه خودم را نمی‌دانستم. اگر من گیج شوم، کاربران شما هم سردرگم خواهند شد.

نسخه اول من ساده بود. از ۷ سوال برای کمک به هوش مصنوعی جهت درک نیازمندی‌ها استفاده می‌کرد. یک فایل راهنما برای ابزارهایی مانند Claude Code یا Cursor تولید می‌کرد. کار می‌کرد، اما نقص‌هایی داشت:

  • هوش مصنوعی باید رنگ‌ها، فونت‌ها و فاصله‌گذاری‌ها را حدس می‌زد.
  • طراحی و وظایف (tasks) در یک فایل واحد قرار داشتند.
  • هوش مصنوعی به جای سیستم‌های طراحی واقعی، به حافظه خودش متکی بود.

نسخه 2.0 فقط یک به‌روزرسانی نیست؛ بلکه یک روش جدید برای کار کردن است.

V1.0 در مقابل V2.0:

V1.0:

  • ۷ مرحله پرسش درباره نیازمندی‌ها.
  • بدون قوانین طراحی.
  • یک فایل راهنمای واحد.
  • بدون مراجع خارجی.

V2.0:

  • ۷ مرحله نیازمندی‌ها + ۷ مرحله ترجیحات طراحی.
  • یک فایل کامل DESIGN_SPEC.md شامل رنگ‌ها، فونت‌ها و قوانین چیدمان (layout).
  • یک بسته کامل مشخصات ساخت (Build Spec) شامل (PRD، طراحی، معماری، وظایف).
  • دسترسی به ۷۱ سیستم طراحی برند مانند Stripe، Linear و Apple.
  • توکن‌های CSS دقیق برای استفاده هوش مصنوعی.

بیشتر مردم پرامپت‌های (prompts) بدی برای هوش مصنوعی می‌نویسند. آن‌ها می‌پرسند: «چه سبک طراحی را دوست داری؟» این سوال خیلی کلی است.

نسخه 2.0 در عوض از حالت چندگزینه‌ای استفاده می‌کند. در هر مرحله، یک سوال با ۴ تا ۶ گزینه پرسیده می‌شود.

  • مرحله ۱: نوع پروژه (SaaS، داشبورد، ابزار هوش مصنوعی و غیره).
  • مرحله ۲: مرجع بصری (Stripe، Apple، Vercel و غیره).
  • مرحله ۳: مود رنگی (سرد، گرم، خنثی).

پس از ۷ مرحله، سیستم توکن‌های طراحی را از ۷۱ سیستم برند استخراج می‌کند. خروجی آن یک لیست از متغیرهای CSS است. این کار دستورالعمل‌های دقیقی را در اختیار هوش مصنوعی قرار می‌دهد.

خطای نسخه به این دلیل رخ داد که فاصله بین V1.0 و V2.0 بسیار زیاد بود. من هر دو را به عنوان نسخه «فعلی» می‌دیدم.

اگر پروژه شما دچار تغییرات گسترده‌ای می‌شود، از برچسب‌های نسخه شفاف استفاده کنید. کاربران ۵ دقیقه وقت صرف مطالعه ساختار شما نمی‌کنند؛ آن‌ها فقط ۱۰ ثانیه به شما فرصت می‌دهند.

قبل از به‌روزرسانی بعدی، از خود بپرسید:

آیا یک کاربر جدید می‌تواند این مقایسه را در ۳ ثانیه درک کند؟

اگر پاسخ منفی است، قبل از اصلاح کد، متن خود را اصلاح کنید.

منبع: https://dev.to/manoir_yantai_f22f01340f0/cong-v10-dao-v20-ge-vibe-coding-guan-xian-de-jia-gou-ji-fan-si-591h

انجمن یادگیری اختیاری: https://t.me/GyaanSetuAi