vibe-coding-college-specs/chapters/16-future-path/01-lesson-from-vibe-coding-to-agentic-engineering/spec.md

مشخصات درس‌نامه: از Vibe Coding تا Agentic Engineering؛ انضباط معماری و حاکمیت در سازمان‌ها

• شناسه در سیلابس: L16.2
• فصل: فصل ۱۶: ادامه راه (Ch 16)
• نوع محتوا: 📘 درس‌نامه متنی
• زمان تقریبی مطالعه: ۱۶ دقیقه
• پیش‌نیازهای مستقیم: L16.1 (اهداف فصل شانزدهم)

---

۱. اهداف یادگیری (Learning Objectives - Bloom's Taxonomy)

دانشجو پس از مطالعهٔ این درس‌نامه باید بتواند:

• درک کند (Understand): تفاوت ماهوی میان «وایب کدینگ تفریحی» (Vibe Coding: کدنویسی شهودی بر اساس حس و حال فردی) را با «مهندسی ایجنتیک صنعتی» (Agentic Engineering: رویکرد منضبط، مشخصات‌محور و پایدار در مقیاس تیمی) شرح دهد.
• تحلیل/ارزیابی کند (Evaluate): چهار ستون اصلی مهندسی ایجنتیک سازمانی (پایه‌گذاری بر پایه مشخصات SDD، دروازه‌های تست خودکار، حاکمیت امنیت و داده، و استانداردهای تیمی مشترک) را ارزیابی نماید.
• به‌کار ببندد (Apply): قوانین راهنمای ایجنت مشترک سازمانی (مانند فایل جامع .cursorrules یا تنظیمات تیمی) را برای تضمین یکپارچگی استایل و امنیت در یک تیم کاری شبیه‌سازی کند.
• ایجاد کند (Create): یک مانیفست استانداردهای مهندسی ایجنتیک برای پروژه‌های گروهی تنظیم کند تا از ورود کدهای شلخته (AI Slop) به مخزن اصلی جلوگیری شود.

---

۲. محدوده و مرزهای محتوا (Scope & Boundaries)

آنچه باید پوشش داده شود (In-Scope):

1. داستان دو دنیای متفاوت: هکرهای آخرهفته در برابر تیم‌های سازمانی:
   • وایب کدینگ برای ساخت سریع ایده عالی است؛ اما وقتی صدها هزار کاربر و میلیون‌ها تراکنش مالی در میان است، انضباط مهندسی حرف اول را می‌زند.
2. چهار ستون استوار مهندسی ایجنتیک (Enterprise Agentic Engineering):
   • ستون ۱: تقدم مشخصات بر کد (Spec-Driven Development): هرگز به ایجنت اجازه داده نمی‌شود پیش از تصویب سند معماری، دست به کد ببرد.
   • ستون ۲: دروازه‌های بازرسی خودکار (Automated Verification Gates): تست‌های پوشش کد، بررسی‌های امنیتی و ممیزی تایپ‌ها در پایپ‌لاین‌های CI/CD.
   • ستون ۳: حاکمیت و امنیت داده (Governance & Compliance): کنترل سطح دسترسی ایجنت‌ها به پایگاه داده پروداکشن و مهار نشت اسرار.
   • ستون ۴: همگام‌سازی استانداردهای تیمی: استفاده از راهنماهای اشتراکی استایل، قوانین پرامپت‌نویسی سازمانی و الگوهای تایید کد.
3. خطر بزرگ پدیده «کدهای شلخته و مهارنشده» (AI Slop in Codebases):
   • چگونه تولید بی‌رویه کدهای حجیم و ناخوانا توسط هوش مصنوعی می‌تواند بدهی فنی سازمان را منفجر کند؟
4. تکامل فرهنگ تیمی: از برنامه‌نویس انزواطلب تا معمار هدایت‌کننده:
   • تبدیل جلسات اسکرام به جلسات تدوین مشخصات دقیق و هماهنگی میان ایجنت‌ها.
5. کال‌اوت‌های آموزشی و هشدار کوئرا:
   • کال‌اوت بنفش (<details class="violet">): چرا مدیران فنی بزرگ (CTOها) عاشق مهندسانی هستند که هنر نوشتن اسناد مشخصات (Specs) شفاف دارند.
   • کال‌اوت سبز (<details class="green">): احساس اقتدار حرفه‌ای وقتی در مصاحبه شغلی، از متدولوژی منضبط هدایت ایجنت‌ها سخن می‌گویید.
   • کال‌اوت قرمز (<details class="red">): اشتباه رایج تکیه صرف به «حس خوب»؛ در کارهای جدی، حس جای خود را به متریک‌های خطاپذیری و تست‌های خودکار می‌دهد.

آنچه نباید وارد آن شویم (Out-of-Scope):

• استانداردها و گواهینامه‌های رسمی حسابرسی ISO 27001 سازمانی.
• متدولوژی‌های مدیریت پروژه سنتی نظیر Waterfall در پروژه‌های دولتی.

---

۳. مفاهیم کلیدی و کلمات تخصصی (Key Concepts & Terms)

اصطلاح انگلیسی	معادل فارسی مصوب	توضیح یک‌خطی ساده
Agentic Engineering	مهندسی ایجنتیک	رویکرد مهندسی ساختارمند برای هدایت، اعتبارسنجی و ارکستراسیون ایجنت‌های نرم‌افزاری
Vibe Coding	کدنویسی شهودی / وایب کدینگ	اصطلاح ابداعی آندری کارپاتی برای توسعه سریع و لذت‌بخش نرم‌افزار بر پایه احساس و هدایت هوش مصنوعی
Architectural Governance	حاکمیت معماری	فرآیند پایش و تضمین انطباق کدهای تولیدی با اصول امنیتی، کارایی و استانداردهای سازمان
Automated Gates	دروازه‌های بازرسی خودکار	فیلترهای خودکار پیش از ادغام کد که از پاس شدن تست‌ها و نبود باگ اطمینان حاصل می‌کنند
AI Code Slop	کدهای شلخته هوش مصنوعی	کدهای متورم، تکراری یا بیش‌ازحد پیچیده‌ای که بدون نظارت انسانی توسط مدل‌ها تولید می‌شوند

---

۴. جایگاه‌های تصاویر و نمودارها (Visual & Diagram Placeholders)

راهنمای ایجنت نویسنده: تمام تصاویر باید در پوشهٔ images/ ذخیره شده و در جدول تک‌خانه‌ای وسط‌چین درج شوند:

1. تصویر کاور درس: images/cover.png
   • موضوع: تقابل یک بوم نقاشی هنری پر از رنگ‌های حسی (وایب) در چپ با یک نقشه مهندسی دقیق و لیزری ساخت آسمان‌خراش دیجیتال در راست.
2. مقایسه وایب کدینگ در برابر مهندسی ایجنتیک سازمانی: images/vibe-vs-agentic-engineering.png
   • موضوع: جدول اینفوگرافیک مقایسه‌ای: رویکرد تک‌نفره، سرعت، تست‌ها، مستندسازی، و تاب‌آوری در مقیاس‌های بزرگ.
3. چهار ستون مهندسی ایجنتیک سازمانی: images/four-pillars-agentic-engineering.png
   • موضوع: تصویر گرافیکی ۴ ستون معبد مهندسی: اسناد مشخصات (SDD)، دروازه‌های تست خودکار، حاکمیت امنیت، و فرهنگ تیمی.
4. جریان بازرسی کدهای ایجنت در پایپ‌لاین CI/CD سازمانی: images/enterprise-agent-guardrails-flow.png
   • موضوع: فلوچارت: کد تولیدشده توسط ایجنت \rightarrow ممیزی امنیتی \rightarrow اجرای ۱۰۰ تست واحد \rightarrow بررسی مطابقت با رولز \rightarrow تایید توسط مهندس ارشد.

---

۵. بخش‌بندی و ساختار محتوایی پیشنهادی درس‌نامه (README.md)

1. تیتر اصلی: # از Vibe Coding تا Agentic Engineering؛ انضباط معماری و حاکمیت در سازمان‌ها
2. مقدمه: وایب کدینگ به شما سرعت ۱۰ برابری داد؛ اما چگونه این سرعت را به موفقیتی پایدار در شرکت‌های بزرگ و تیم‌های حرفه‌ای تبدیل کنیم؟
3. جدول کاور درس
4. استعاره پرواز با پاراگلایدر در برابر هدایت بوئینگ مسافربری:
   • پرواز انفرادی هیجان‌انگیز است؛ اما وقتی جان و سرمایه مسافران در میان است، نیازمند پروتکل‌های سخت‌گیرانه هستید.
5. مرزهای مشخص میان کدنویسی شهودی و مهندسی ایجنتیک:
   • چرا مهندسی ایجنتیک هنرِ کنترل کیفیت، مرزبندی و معماری دقیق است.
6. چهار ستون مهندسی ایجنتیک در شرکت‌های فناوری پیشرو:
   • مشخصات‌محوری (SDD)، تست‌های ضدپس‌رفت، امنیت و انضباط تیمی.
7. شکار و مهار پدیده AI Code Slop:
   • چرا نباید اجازه دهیم کدهای پروژه متورم و غیرقابل نگهداری شوند؟
8. فرهنگ تیمی جدید: ارتقای استانداردهای همکاری:
   • استفاده از فایل‌های کانفیگ مشترک (.cursorrules) برای کل تیم.
9. باکس نکته Quera (<details class="violet">): تغییر بازی در استخدام؛ شرکت‌های تراز اول به دنبال افرادی نیستند که فقط کد تایپ کنند، بلکه معمارانی را می‌خواهند که بتوانند ۱۰ ایجنت را به درستی رهبری کنند.
10. باکس هشدار Quera (<details class="red">): خطر کدهای حل‌المسائلی بدون درک؛ هرگز کدی را که منطق آن را درک نمی‌کنید در محیط پروداکشن سازمانی ادغام نکنید.
11. باکس رضایت‌بخش Quera (<details class="green">): احساس آرامش از اینکه کدهای شما نه تنها سریع نوشته شده‌اند، بلکه در سطح استانداردهای جهانی مهندسی تمیز و پایدار هستند.
12. جمع‌بندی درس‌نامه: بلوغ دیدگاه مهندسی؛ ورود به دنیای واقعی و بررسی نمونه‌های زنده استفاده از AI در شرکت‌های بزرگ ایران و جهان در درس بعدی.

---

۶. معیارهای پذیرش (Acceptance Criteria for Reviewer)

• تمایز میان Vibe Coding فردی و Agentic Engineering سازمانی تبیین شود.
• ستون‌های چهارگانه مهندسی ایجنتیک با مثال‌های ملموس تشریح گردند.
• خطرات کدهای متورم و شلخته (AI Slop) و راهکارهای مهار آن ارائه شود.
• نقش دگرگون‌شده مهندس نرم‌افزار در ساختارهای سازمانی مدرن تحلیل گردد.