کتاب Spec-Driven Development with BMAD

کتاب Spec-Driven Development with BMAD: Master Agentic Workflows using Cursor, BMAD, and Context Engineering (توسعه مبتنی بر مشخصات با BMAD: تسلط بر گردش‌های کاری عامل‌محور با استفاده از Cursor، BMAD و مهندسی زمینه) به این مسئله می‌پردازد که چرا بسیاری از توسعه‌دهندگان در کار با دستیارهای هوش مصنوعی با شکست مواجه می‌شوند: مشکل اصلی ابزار نیست، بلکه دستورالعمل‌های مبهم و فاقد ساختار است که منجر به تولید کدهای غیرقابل‌اعتماد می‌شود.

در ادامه مقدمه‌ای از کتاب Spec-Driven Development with BMAD را از زبان نویسنده شرح خواهیم داد.

مقدمه‌ای بر کتاب Spec-Driven Development with BMAD:

لحظه‌ای وجود دارد که اغلب برنامه‌نویسان آن را به‌خوبی می‌شناسند؛ یک مدل هوش مصنوعی توانمند پیش روی شماست، ویژگی و تسک مشخصی برای توسعه دارید و پس از یک بعدازظهر تعامل رفت‌وبرگشتی، خروجی‌ای حاصل می‌شود که تا حد زیادی کار می‌کند. اما دو هفته بعد، در یک گفتگوی جدید (Fresh Conversation)، همان مدل همه‌چیز را فراموش کرده است. بافتار و بستر موضوع (Context) از دست رفته و تصمیمات قبلی ناپدید شده‌اند. مجبورید همان پروژه را مجدداً از صفر برای آن توضیح دهید و خروجی نهایی هم با آنچه قبلاً ساخته بودید، تفاوت دارد.

آن لحظه، همان نقطه‌ای بود که ایدهٔ کتاب Spec-Driven Development with BMAD برای من شکل گرفت.

من با همان ذهنیتی وارد توسعهٔ نرم‌افزار با کمک هوش مصنوعی شدم که اکثر برنامه‌نویسان دارند: شروع به نوشتن کن، سریع تکرار کن (Iterate) و اجازه بده مدل فاصله‌ها و جاهای خالی را پر کند. اما آنچه دریافتم این بود که هرچه سریع‌تر پیش می‌رفتم، نتیجهٔ نهایی شکننده‌تر و آسیب‌پذیرتر می‌شد. هر نشست (Session) کاری، به یک مذاکره و چانه‌زنیِ تازه تبدیل شده بود. هر تغییر، ناسازگاری‌های جدیدی ایجاد می‌کرد. هوش مصنوعی توانا بود، اما این فرایند هیچ ساختار مشخصی نداشت. نه حافظهٔ مشترکی وجود داشت و نه قراردادی میان آنچه من می‌خواستم و آنچه مدل می‌فهمید. من فقط داشتم «کد» دریافت می‌کردم، اما عملاً «نرم‌افزار» نمی‌ساختم.

اینجا بود که به دنبال رویکرد بهتری گشتم.

آشنایی با روش BMAD
متدولوژی BMAD چارچوبی برای توسعهٔ نرم‌افزار با کمک هوش مصنوعی است که بر پایهٔ یک فرض ساده بنا شده است: مشکل از مدل نیست، بلکه از فرایند است. بیشتر شکست‌ها در توسعهٔ مبتنی بر هوش مصنوعی، قبل از نوشته شدن حتی یک خط کد رخ می‌دهند؛ چرا که کارِ تعیین «چه چیزی ساخته شود»، «چرا ساخته شود» و «ساختار آن چگونه باشد» نادیده گرفته شده است. BMAD این مراحل را نادیده نمی‌گیرد، بلکه آن‌ها را صریح، ساختاریافته و مبتنی بر اسناد و دستاوردها (Artifact-driven) می‌کند.

من از طریق مسترکلاس یوتیوب برایان مدیسون با BMAD آشنا شدم. در زمان نگارش کتاب Spec-Driven Development with BMAD، آن دوره همچنان کامل‌ترین منبع ویدیویی درباره این روش به شمار می‌رود. فراتر از آن، مستندات اصلی‌ترین منبع یادگیری هستند؛ چرا که هیچ اکوسیستمی از آموزش‌ها و توضیحات جانبی متعدد وجود ندارد. یادگیری BMAD یعنی خواندن، آزمایش کردن و ساختن.

این محدودیت در عمل بسیار مفید واقع شد؛ چرا که مرا مجبور کرد از آشنایی سطحی فراتر بروم و درکی کاربردی از این پیدا کنم که چرا هر فاز وجود دارد و خروجی آن دقیقاً چیست.

به‌کارگیری آن در عمل
ابتدا پیاده‌سازی BMAD را روی پروژه‌های شخصی‌ام آغاز کردم. نتایج اولیه آن‌قدر با تجربیات قبلی‌ام در کار بدون‌ساختار با هوش مصنوعی تفاوت داشت که تصمیم گرفتم آن را ادامه دهم. خروجی‌ها و اسناد (Artifacts) تولیدشده در فازهای تحلیل و برنامه‌ریزی، بستر و زمینه‌ای واقعی (Context) در اختیار ایجنت‌های پیاده‌سازی قرار می‌دادند تا بر اساس آن کار کنند. دیگر با شروع هر نشست کاری، همه‌چیز از اول ریست نمی‌شد و تصمیمات به‌جای اینکه از بین بروند، روی هم انباشته و تثبیت می‌شدند.

در شرکت فعلی‌ام، یعنی TELUS Digital، این رویکرد را به پروژه‌های سازمانی و حرفه‌ای تعمیم دادم. شرایط در آنجا بسیار حساس‌تر بود: دامنهٔ وسیع‌تر، ذی‌نفعان واقعی و محدودیت‌های محیط پروداکشن (Production). با این حال، BMAD با موفقیت پاسخگوی نیازها بود. این متد مقیاس‌پذیر است، زیرا تفکیک وظایف و دغدغه‌ها (Separation of Concerns) را به شکلی شفاف انجام می‌دهد: تحلیل با برنامه‌ریزی یکی نیست، برنامه‌ریزی با طراحی راهکار (Solutioning) تفاوت دارد و طراحی راهکار نیز با پیاده‌سازی یکسان نیست. هر فاز، اسناد و خروجی‌هایی تولید می‌کند که فاز بعدی به آن‌ها وابسته است. این زنجیره از وابستگی‌ها همان چیزی است که توسعه با هوش مصنوعی را به‌جای یک فرایند تصادفی، به رویکردی «تکرارپذیر و قابل اتکا» تبدیل می‌کند.

کار کردن روی این پروژه‌ها اعتمادبه‌نفس کافی برای آموزش این متد را به من داد و کتاب Spec-Driven Development with BMAD، حاصل همان آموزش‌هاست.

کتاب Spec-Driven Development with BMAD برای چه کسانی است؟
این کتاب برای توسعه‌دهندگانی است که در حال حاضر از ابزارهای هوش مصنوعی استفاده می‌کنند و می‌خواهند این کار را هدفمندتر و سنجیده‌تر انجام دهند. فرض بر این است که شما سابقهٔ کار با ابزارهای کدنویسی مبتنی بر هوش مصنوعی را داشته‌اید و با محدودیت‌های آن‌ها مواجه شده‌اید. نیازی به تجربهٔ قبلی با BMAD ندارید؛ تنها پیش‌نیاز، تمایل به صرف زمان در فازهای برنامه‌ریزی است تا بتوانید در فاز پیاده‌سازی، سریع‌تر و با قابلیت اطمینان بیشتری پیش بروید.

کتاب Spec-Driven Development with BMAD برای مخاطبانی که به دنبال مقایسهٔ ابزارهای مختلف کدنویسی هوش مصنوعی یا یک مقدمهٔ کلی درباره توسعه به کمک هوش مصنوعی هستند، مناسب نیست. تمرکز کتاب کاملاً مشخص و هدفمند است: متدولوژی BMAD، نحوه کارکرد آن و نحوه استفاده از آن.

سرفصل‌های کتاب Spec-Driven Development with BMAD
کتاب حاضر، ساختار خودِ این روش را دنبال می‌کند و از مفاهیم بنیادین تا هر یک از فازهای توسعه را پوشش می‌دهد:

فصل ۱: معرفی توسعه مشخصات‌محور (Spec-Driven Development) و متد BMAD
به معرفی مفهوم توسعه مشخصات‌محور و متدولوژی BMAD می‌پردازد. ایدهٔ اصلی پشت توسعهٔ مبتنی بر سند/آرتیفکت با هوش مصنوعی را شرح می‌دهد و تبیین می‌کند که چرا این روش خروجی‌های متفاوتی نسبت به پرامپت‌نویسی بدون ساختار به همراه دارد.

فصل ۲: فاز بالادستی (Upstream): تحلیل، برنامه‌ریزی و طراحی راهکار

فازهای تحلیل، برنامه‌ریزی و راهکارمحوری را پوشش می‌دهد. این‌ها فازهای بالادستی هستند که در آن‌ها کارهای مربوط به تعریف محصول، شناخت دامنه (Domain) و معماری راهکار، پیش از نوشته شدن هرگونه کدی انجام می‌گیرد. هر فاز ایجنت‌ها و جریان‌های کاری (Workflows) اختصاصی خود را دارد که فرایند را هدایت می‌کنند.

فصل ۳: فاز پایین‌دستی (Downstream): پیاده‌سازی و اجرای اسپرینت
فاز پیاده‌سازی را بررسی می‌کند؛ جایی که داستان‌ها (Stories) توسعه داده می‌شوند، کدها نوشته می‌شوند، تست‌ها تولید شده و میزان پیشرفت رصد می‌شود. اینجا همان جایی است که خروجی‌ها و اسناد فازهای بالادستی به بار می‌نشینند.

فصل ۴: به‌کارگیری BMAD در پروژه‌های موجود (Legacy/Existing)

به کار با نرم‌افزارها و کدهای از پیش موجود می‌پردازد. اجرای BMAD روی پروژه‌ای که از صفر آغاز می‌شود (Greenfield) با پیاده‌سازی آن روی یک کدبیس موجود متفاوت است. این فصل از کتاب Spec-Driven Development with BMAD به اصلاحات و تطبیق‌های ویژه‌ای می‌پردازد که این روش در مواجهه با پروژه‌های از پیش ساخته‌شده نیاز دارد.

فصل ۵: به‌کارگیری BMAD در پروژه‌های جدید
فرایند کار با نرم‌افزارهای جدید را از نخستین جلسهٔ طوفان فکری تا رسیدن به پیاده‌سازی عملیاتی پوشش می‌دهد. این فصل از کتاب Spec-Driven Development with BMAD جریان کاریِ توصیه‌شده را گام‌به‌گام و سرتاسری، همراه با مثال‌هایی از پروژه‌های واقعی دنبال می‌کند.

فصل ۶: BMAD در عمل: پاسخ به پرسش‌های دنیای واقعی

به پرسش‌های متداول و سناریوهای واقعی می‌پردازد؛ شرایطی که به‌راحتی در قالب چارچوب استاندارد جای نمی‌گیرند: تغییرات دامنهٔ پروژه (Scope) در حین پیاده‌سازی، کار بدون دسترسی به مجموعهٔ کاملی از اسناد، ادغام BMAD در محیط‌های تیمی و مدیریت موارد استثنا و لبه‌ای (Edge Cases) که در هر استفادهٔ جدی از این متد رخ می‌دهند.

این روش کاملاً قابل یادگیری و این فرایند تکرارپذیر است. این ادعایی است که کتاب Spec-Driven Development with BMAD مطرح می‌کند و هر فصل تلاشی است برای اثبات آن.

سرفصل‌های کتاب Spec-Driven Development with BMAD:

• Preface
• Chapter 1: Introducing Spec-Driven Development and BMAD Method
• Chapter 2: Upstream Phase: Analysis, Planning and Solutioning
• Chapter 3: Downstream Phase: Implementing and Sprinting
• Chapter 4: Applying BMAD to an Existing Project
• Chapter 5: Applying BMAD to a New Project
• Chapter 6: BMAD in Practice: Answers to Real-World Questions
• Chapter 7: Unlock the Code Bundle and the PDF Version
• Other Books You May Enjoy
• Index

جهت دانلود کتاب Spec-Driven Development with BMAD می‌توانید پس از پرداخت، دریافت کنید.