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