# مشخصات درس‌نامه: از 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) و راهکارهای مهار آن ارائه شود.
- [ ] نقش دگرگون‌شده مهندس نرم‌افزار در ساختارهای سازمانی مدرن تحلیل گردد.