توضیحات درس
🎥 این ویدیو قسمت ششم از پلیلیست تخصصی Vibe Coding است. 📚 در این جلسه به سراغ یکی از مهمترین اسناد و پایههای ساخت هر محصول نرمافزاری پیش از کدنویسی میرویم: سند PRD (Product Requirements Document). در این ویدیو به طور کامل بررسی میکنیم که سند نیازمندیهای محصول چیست و چگونه به عنوان راهنمای اصلی در توسعه نرمافزار با ابزارهای هوش مصنوعی عمل میکند. داشتن یک PRD دقیق و ساختاریافته به شما کمک میکند محدوده پروژه را مشخص کرده و ایدههای خود را به شکلی شفاف به مدلهای هوش مصنوعی منتقل کنید. در طول ویدیو ابتدا با مفاهیم پایه و راهنماهای ابزارهایی مثل Lovable آشنا میشویم، سپس محدوده پروژه و اسناد ضروری پیش از ساخت را بررسی میکنیم و در نهایت مراحل تولید، بررسی، اصلاح و نهاییسازی سند PRD را قدم به قدم پیادهسازی میکنیم. لینک فایل ارائه در گیتهاب: https://github.com/farzadafi/Teaching/blob/master/vibe_conding/06_PRD_DOC/index.html در این جلسه یاد میگیریم: ⚙️ آشنایی با مفاهیم پایه و راهنماهای ساخت محصول در وایب کدینگ 📋 بررسی دقیق محدوده پروژه (Scope Of Project) و اسناد ضروری پیش از ساخت 📄 نحوه تولید و نگارش سند جامع نیازمندیهای محصول یا همان PRD Generation 🔍 فرآیند بررسی، پالایش و نهاییسازی مستندات PRD برای توسعه نرمافزار 🧠 در پایان نیز یک جمعبندی کامل از اهمیت مستندسازی پیش از کدنویسی با هوش مصنوعی خواهیم داشت اگر به توسعه نرمافزار با هوش مصنوعی علاقه دارید، یادگیری نحوه نگارش PRD یکی از مهارتهای کلیدی برای موفقیت در پروژههایتان است. 📌 یوتیوب: youtube.com/@farzadafi 📌 آپارت: aparat.com/farzadafi 📌 وبسایت: https://farzadafi.ir 📌 گروه پرسش و پاسخ تلگرام: @programmingByFarzadAfi 💬 گروه پرسش و پاسخ بله: @programming_by_farzadafi وب سایت: https://farzadafi.ir هر سوالی داشته باشید میتوانید در گروه بپرسید تا من یا مربیهای گروه کمکتان کنیم 💬
جزوه درسبرای مشاهده کلیک کنید
این جزوه بر اساس مفاهیم «Vibe Coding» و مستندات مدیریت دستورالعملهای هوش مصنوعی تدوین شده است تا به عنوان راهنمای همکاری موثر با ابزارهای AI (مانند Lovable، Cursor و Cline) مورد استفاده قرار گیرد.
مفاهیم کلیدی
- Vibe Coding
رویکردی در توسعه نرمافزار مبتنی بر انرژی بالا و چرخههای سریع توسعه؛ در این مدل، برنامهنویس با تکیه بر ابزارهای AI، به جای درگیری با جزئیات سینتکس، بر روی پیادهسازی سریع ویژگیها، تست و بازخورد فوری تمرکز میکند.
- Prompt Requirements Document (PRD)
سندی ساختاریافته که به عنوان پل ارتباطی بین انسان و AI عمل میکند. برخلاف مستندات سنتی، این سند دستورالعملها را به گونهای مدیریت میکند که ماشین قادر به تحلیل دقیق و اجرای آنها باشد و فرآیند همکاری را بهینهسازی کند.
- G3 Framework
چارچوب پیشنهادی برای تدوین مستندات دستورالعمل (PRD) که شامل سه بخش اصلی است:
- Guideline: دانش پایه برای ایجاد درک مشترک از پروژه و معماری.
- Guidance: روششناسی برای تبدیل ایدههای انتزاعی به پرامپتهای دقیق و اجرایی.
- Guardrails: استانداردهای خودکار برای ارزیابی کد و کنترل کیفیت پیش از بازبینی انسانی.
- Instructions (Lovable)
دستورالعملهای ماندگاری که برای هدایت هوش مصنوعی تعریف میشوند. این دستورالعملها در سه سطح تعریف میگردند:
-
Workspace: قوانین کلی و مشترک برای تمام پروژههای یک فضای کاری (مانند استانداردهای کدنویسی).
-
Project: اطلاعات تخصصی مربوط به یک پروژه خاص (مانند مدل دیتابیس یا اهداف بیزینسی).
-
Personal: ترجیحات و سبک کاری اختصاصی هر توسعهدهنده که فقط برای خود او اعمال میشود.
-
Skills vs. Instructions
تفاوت عملکردی میان دستورالعملهای دائمی (Instructions) که همیشه در زمینه (Context) قرار دارند و مهارتها (Skills) که فقط در هنگام نیاز و برای وظایف خاص بارگذاری میشوند.
اصول کلیدی در نگارش دستورالعملها
برای دستیابی به خروجیهای باکیفیت و پایدار از هوش مصنوعی، رعایت نکات زیر در مستندسازی الزامی است:
- ساختارمندسازی قوانین: به جای توضیحات پراکنده، قوانین را در دستههای مشخص مانند «استانداردهای کدنویسی»، «نامگذاری»، «معماری» و «تست» دستهبندی کنید.
- وضوح و صراحت: دستورالعملها باید به صورت ایجابی یا سلبیِ دقیق بیان شوند (مثلاً: «هرگز از
anyدر تایپاسکریپت استفاده نکن» یا «همیشه ازTailwind CSSبرای استایلدهی استفاده کن»). - سلسلهمراتب اولویت: در صورت بروز تضاد بین دستورالعملها، اولویت معمولاً با تنظیمات شخصی، سپس پروژه و در نهایت فضای کاری است.
- تکاملی بودن (Evolving): دستورالعملها نباید ایستا باشند. بهترین روش، استفاده از چرخه «پیادهسازی -> بازنگری -> بهروزرسانی قوانین» است تا دانش کسب شده از هر مرحله به مستندات اضافه شود.
- محیطمحور بودن: از مستندات برای تعریف «آنچه باید اجتناب شود» (مثل
console.log) به همان اندازه «آنچه باید انجام شود» استفاده کنید.
نکات مدیریتی در Lovable
- تغییرات دستورالعملها بلافاصله اعمال میشوند و در پیامهای بعدی لحاظ میگردند.
- دستورالعملهای فضای کاری (
Workspace) برای تیمها حیاتی هستند؛ زیرا مدیران میتوانند «خطوط قرمز» و استانداردهای فنی را برای تمام پروژههای تیم یکسانسازی کنند. - در مکالمات بسیار طولانی، به دلیل محدودیتهای
Context Window، ممکن است رعایت دقیق دستورالعملها با افت مواجه شود؛ در این مواقع بازبینی و خلاصهسازی روند پروژه به هوش مصنوعی توصیه میشود.
