feat: add chapter 02-vibe-coding-mindset specs

chapters/02-vibe-coding-mindset/06-lesson-ai-software-methodologies/spec.md

@@ -0,0 +1,96 @@
+# مشخصات درس‌نامه: متودولوژی‌های توسعه نرم‌افزار با AI (AI Software Methodologies & SDD)
+- **شناسه در سیلابس:** `L2.7`
+- **فصل:** فصل ۲: شروع مسیر Vibe Coding (Ch 2)
+- **نوع محتوا:** 📘 درس‌نامه متنی
+- **زمان تقریبی مطالعه:** ۱۲ دقیقه
+- **پیش‌نیازهای مستقیم:** `L2.6` (اصول مهندسی پرامپت)
+
+---
+
+## ۱. اهداف یادگیری (Learning Objectives - Bloom's Taxonomy)
+دانشجو پس از مطالعهٔ این درس‌نامه باید بتواند:
+- [ ] **تحلیل/ارزیابی کند (Evaluate):** رویکرد غیرحرفه‌ای «پرامپت و دعا» (Prompt & Pray) را با رویکرد مهندسی و پایدار «توسعه مشخصات‌محور» (Spec-Driven Development - SDD) مقایسه کند.
+- [ ] **درک کند (Understand):** چرخهٔ چهار مرحله‌ای SDD شامل: **۱. مشخصات (Specify) $\rightarrow$ ۲. برنامه‌ریزی (Plan) $\rightarrow$ ۳. اجرای ایجنت (Execute) $\rightarrow$ ۴. راستی‌آزمایی انسان (Verify)** چگونه کار می‌کند.
+- [ ] **درک کند (Understand):** چرا ثبت تصمیمات در قالب اسناد شفاف (سند مشخصات یا PRD) مانع از سردرگمی هوش مصنوعی در پروژه‌های بزرگ می‌شود.
+- [ ] **به‌کار ببندد (Apply):** نقش خود به عنوان ناظر و معمار نهایی در حلقه بازخورد را بپذیرد؛ کدهای تغییریافته (Git Diffs یا تغییرات ایجنت) را پیش از تایید، مرور و راستی‌آزمایی کند.
+
+---
+
+## ۲. محدوده و مرزهای محتوا (Scope & Boundaries)
+
+### آنچه باید پوشش داده شود (In-Scope):
+1. **بیماری شایع توسعه شتاب‌زده با هوش مصنوعی (Prompt & Pray):**
+   * پرامپت‌نویسی تصادفی و تکراری به این امید که شانس بیاوریم و باگ حل شود!
+   * چرا این روش بعد از رسیدن پروژه به بیش از ۳ صفحه به یک فاجعه و قفل کامل پروژه تبدیل می‌شود.
+2. **تولد پارادایم توسعه مشخصات‌محور (Spec-Driven Development):**
+   * در دنیای وایب کدینگ حرفه‌ای، ارزان‌ترین و سریع‌ترین بخش کار تولید کد است (توسط هوش مصنوعی انجام می‌شود).
+   * گران‌ترین و مهم‌ترین بخش، **روشن کردن دقیق نیت و رفتار مورد انتظار نرم‌افزار** است.
+   * نوشتن مشخصات شفاف (چه کارهایی باید انجام شود، داده‌ها چه ساختاری دارند، سناریوهای کاربر چیست).
+3. **چرخهٔ چهار مرحله‌ای حلقه SDD:**
+   * **گام ۱: تدوین مشخصات (Specify):** نوشتن سند یا تعریف مرزهای تسک قبل از درخواست کد.
+   * **گام ۲: طرح اقدام و برنامه‌ریزی (Plan):** ایجنت مراحل انجام تسک را می‌چیند و گام‌ها را برای بررسی ارائه می‌دهد.
+   * **گام ۳: اجرای هوشمند توسط ایجنت (Execute):** ایجنت فایل‌ها را ویرایش و کدهای لازم را اضافه می‌کند.
+   * **گام ۴: آزمایش و راستی‌آزمایی انسان (Verify):** کاربر خروجی را در مرورگر یا با تست می‌بیند، بررسی می‌کند و سپس تایید یا اصلاح می‌کند.
+4. **نقش حیاتی انسان در صندلی تایید نهایی:**
+   * هوش مصنوعی کد را پیشنهاد می‌دهد؛ شما مسئول بازبینی، تست و کلیک دکمه قبولی هستید.
+5. **پیش‌درآمدی بر فصول بعدی دوره:**
+   * در فصل ۴ نحوه نوشتن PRD واقعی با هوش مصنوعی را یاد خواهید گرفت؛ در فصل‌های ۶ و ۷ کدها با همین چرخه تولید می‌شوند و در پروژه‌های ۸ و ۱۴ پیاده‌سازی کامل محصول را تجربه خواهید کرد.
+6. **کال‌اوت‌های Quera:**
+   * `<details class="violet">`: چرا شرکت‌های پیشروی جهان و تیم‌های مدرن هوش مصنوعی در سال‌های ۲۰۲۵ و ۲۰۲۶ متدولوژی SDD را جایگزین روش‌های سنتی کرده‌اند؟
+   * `<details class="green">`: مژده به دانشجویان: با این متدولوژی شما هرگز در میان صدها خط کد سردرگم نخواهید شد، زیرا نقشه همیشه مشخص است.
+
+### آنچه نباید وارد آن شویم (Out-of-Scope):
+- ورود تفصیلی به نگارش تمپلیت‌های PRD، فیچربک‌لاگ یا ابزارهای مدیریت پروژه مثل Jira/Notion (فصل ۴).
+- تشریح تست‌های خودکار نرم‌افزاری با فریم‌ورک‌های Jest یا Pytest (فصل ۹).
+
+---
+
+## ۳. مفاهیم کلیدی و کلمات تخصصی (Key Concepts & Terms)
+
+| اصطلاح انگلیسی | معادل فارسی مصوب | توضیح یک‌خطی ساده |
+| :--- | :--- | :--- |
+| Prompt & Pray | پرامپت و دعا | رویکرد غیرعلمی و تصادفی فرستادن پرامپت‌های کورکورانه به امید درست شدن خودکار کد |
+| Spec-Driven Development (SDD) | توسعه مشخصات‌محور | متدولوژی مهندسی که در آن تولید نرم‌افزار بر پایه اسناد مشخصات و برنامه اقدام شفاف استوار است |
+| Feedback Loop | چرخهٔ بازخورد | فرایند پیوستهٔ آزمایش خروجی ایجنت، مشاهده نتیجه و ارائه راهنمایی تکمیلی به هوش مصنوعی |
+| Verification | راستی‌آزمایی | بررسی و تست واقعی عملکرد نرم‌افزار توسط انسان پیش از پذیرش تغییرات ایجنت |
+| Product Requirements Document (PRD) | سند نیازمندی‌های محصول | سندی جامع که چرایی، اهداف و رفتار دقیق فیچرهای یک نرم‌افزار را پیش از ساخت توصیف می‌کند |
+
+---
+
+## ۴. جایگاه‌های تصاویر و نمودارها (Visual & Diagram Placeholders)
+> **راهنمای ایجنت نویسنده:** تمام تصاویر باید در پوشهٔ `images/` قرار گرفته و در قالب جدول تک‌خانه‌ای وسط‌چین با کپشن تفصیلی درج شوند:
+
+1. **تصویر کاور درس:** `images/cover.png`
+   * **موضوع:** کاور مدرن نمایش‌دهنده نقشهٔ معماری دیجیتال (Blueprint) که توسط دست انسان هدایت شده و هوش مصنوعی در حال اجرای خطوط آن است.
+2. **مقایسه پرامپت و دعا در برابر توسعه مشخصات‌محور:** `images/prompt-and-pray-vs-sdd.png`
+   * **موضوع:** تصویر مقایسه‌ای: سمت چپ آشفتگی، آزمون‌وخطای بی‌پایان و سرخوردگی (Prompt & Pray) در برابر سمت راست ریل‌گذاری منظم و گام‌به‌گام با سند مشخصات (SDD).
+3. **چرخهٔ چهار مرحله‌ای حلقه SDD:** `images/sdd-four-step-loop.png`
+   * **موضوع:** دیاگرام چرخشی ۴ مرحله: ۱. مشخصات (Specify) $\rightarrow$ ۲. برنامه (Plan) $\rightarrow$ ۳. اجرای ایجنت (Execute) $\rightarrow$ ۴. بررسی انسان (Verify).
+4. **جایگاه انسان در فرماندهی بازخورد:** `images/human-in-the-loop.png`
+   * **موضوع:** اینفوگرافیک مفهوم Human-in-the-Loop که انسان را در نقطه آغاز (تعیین هدف) و نقطه پایان (تایید کیفیت خروجی) نشان می‌دهد.
+5. **نقشه راه SDD در امتداد فصول دوره:** `images/sdd-course-application.png`
+   * **موضوع:** فلوچارت اتصال فصول دوره: فصل ۴ (طراحی سند و تسک) $\rightarrow$ فصل‌های ۶ تا ۸ (پیاده‌سازی مرحله‌ای) $\rightarrow$ پروژه‌های عملی ۱ و ۲.
+
+---
+
+## ۵. بخش‌بندی و ساختار محتوایی پیشنهادی درس‌نامه (`README.md`)
+
+1. **تیتر اصلی:** `# متودولوژی‌های توسعه نرم‌افزار با AI و ورود به دنیای SDD`
+2. **مقدمه ملموس:** چرا توسعه‌دهندگان مبتدی با هوش مصنوعی در بن‌بست گیر می‌کنند؟
+3. **جدول کاور درس**
+4. **پدیده خطرناک «پرامپت و دعا» (Prompt & Pray):** تحلیل آسیب‌شناسانه سردرگمی در پروژه‌ها.
+5. **ظهور متدولوژی توسعه مشخصات‌محور (SDD):** ارزش مشخصه‌نویسی شفاف در عصر هوش مصنوعی.
+6. **چهار گام طلایی چرخه SDD:** تشریح مراحل Specify، Plan، Execute و Verify با یک سناریوی زنده.
+7. **باکس نکته پیشرفته Quera (`<details class="violet">`):** چرا غول‌های فناوری متدولوژی SDD را قلب آینده مهندسی نرم‌افزار می‌دانند؟
+8. **انسان در حلقه فرماندهی (Human-in-the-Loop):** تفاوت ناظر فعال با تماشاگر منفعل.
+9. **ارتباط SDD با مسیر شما در این دوره:** چگونه این متدولوژی ستون فقرات پروژه‌های کوئرا کالج خواهد بود.
+10. **باکس اطمینان‌بخش Quera (`<details class="green">`):** آرامش ذهن و تسلط کامل با اتکا به ریل‌گذاری مشخصات.
+11. **جمع‌بندی درس‌نامه و آماده‌سازی برای آزمون پایانی فصل:** مرور کلیدی‌ترین اصول پیش از ورود به کوئیز.
+
+---
+
+## ۶. معیارهای پذیرش (Acceptance Criteria for Reviewer)
+- [ ] تفاوت شفاف رویکرد «پرامپت و دعا» با متدولوژی «توسعه مشخصات‌محور» شرح داده شده باشد.
+- [ ] چرخه ۴ مرحله‌ای SDD (مشخصات، برنامه، اجرا، راستی‌آزمایی) همراه با دیاگرام به خوبی مستند شده باشد.
+- [ ] نقش نظارتی انسان در پذیرش یا رد کدهای ایجنت به صراحت تاکید شده باشد.
+- [ ] پل ارتباطی این درس با فصول بعدی (به‌ویژه فصل ۴ و پروژه‌های عملی) برقرار شده باشد.