🤖 توسعه نرم‌افزار با AI؛ از Spec تا کد آماده Production

🚀 این کتاب Spec-Driven Development را با استفاده از Breakthrough Method for Agile AI-Driven Development یا BMAD آموزش میده. یاد میگیری چطور با Agentهای تخصصی AI، نرم‌افزار را در پروژه‌های جدید و موجود تحلیل، طراحی، پیاده‌سازی و Test کنی.

✨ ویژگی‌های کلیدی

🔄 Workflow کامل Agentic در BMAD + TEA را از Upstream Planning تا Downstream Code Delivery پوشش میده.

📋 نحوه اجرای Spec-Driven Development را با BMAD v4 و BMAD v6 روی پروژه‌های Greenfield و Existing Codebaseها آموزش میده.

🧠 نشان میده چطور با Specificationها، Architecture Documentها و Context Engineering، نرم‌افزارهای قابل‌اعتماد با کمک AI بسازی.

🤝 نحوه هماهنگ‌کردن Agentهای تخصصی برای Analysis، Planning، Architecture، Development، QA و Sprint Management را توضیح میده.

📘 توضیح کتاب

⚠️ بیشتر Developerهایی که با AI Assistantها کار میکنن، نه به‌خاطر ضعف ابزار بلکه به‌دلیل Context نامناسب با مشکل روبه‌رو میشن. وقتی Agentها Instructionهای مبهم دریافت کنن، Code غیرقابل‌اعتماد تولید میکنن.

📋 Spec-Driven Development یا SDD این مشکل را با الزام به تهیه Specificationهای ساختاریافته، پیش از نوشته‌شدن حتی یک خط Code، حل میکنه. در این رویکرد، هدف‌ها، Requirementها، Architecture و محدودیت‌های پروژه قبل از Implementation به‌روشنی مشخص میشن.

🧩 BMAD یک Agentic Framework متن‌بازه که Development را در دو مرحله سازمان‌دهی میکنه. مرحله Upstream شامل Analysis، Planning و Solutioning و مرحله Downstream شامل Implementation و Testing است.

🤖 هر مرحله توسط Agentهای تخصصی AI اجرا میشه که با ترتیب مشخص در کنار یکدیگر کار میکنن و Input و Output روشنی دارن. این ساختار باعث میشه Context بین مراحل از بین نره و هر Agent براساس اطلاعات دقیق Agent قبلی کار خودش را ادامه بده.

🆕 کتاب توضیح میده BMAD v6 چطور نسخه‌های قبلی را با مفاهیمی مثل Progressive Disclosure، مدیریت بهتر Context، یکپارچه‌سازی TEA و فایل project-context.md گسترش داده است. این فایل در تمام فرایند Development به‌عنوان یک منبع حقیقت پایدار عمل میکنه.

🛠️ در طول کتاب Featureهای کاملی را با Orchestration چندین Agent و Workflow میسازی. BMAD را هم روی Existing Codebaseها و هم روی Greenfield Projectها اجرا میکنی و Sprint Cycleهای کامل را از Planning و Implementation تا Retrospective پیش میبری.

🔗 کتاب Prompt، Spec، Architecture Document و Project Context را به یک Workflow منسجم متصل میکنه. این فرایند کمک میکنه AI فقط Code تولید نکنه، بلکه براساس Requirementها، تصمیم‌های Architecture و نیازهای واقعی پروژه عمل کنه.

🎯 پس از مطالعه کتاب، یک Process تکرارپذیر و ساختاریافته برای توسعه Software با AI در اختیار داری که بدون توجه به اندازه یا پیچیدگی پروژه، نتایجی پایدار، قابل‌اعتماد و آماده Production تولید میکنه.

🎯 چیزهایی که یاد میگیری

🔄 یاد میگیری Workflow Agentic در BMAD را از مرحله Upstream تا Downstream به‌طور کامل اجرا کنی.

📋 میتونی با Agentهای Analyst، PM و Architect، Requirementها، Specificationها و Architecture Documentهای پروژه را آماده کنی.

💻 یاد میگیری Code را با Dev Agent پیاده‌سازی و با QA Agent آزمایش و ارزیابی کنی.

🏃 میتونی با Scrum Master Agent، Sprintها را برنامه‌ریزی و Retrospectiveها را اجرا کنی.

🏗️ یاد میگیری پروژه‌های جدید را با Full BMAD Cycle از ابتدا تا انتها بسازی.

🔧 میتونی BMAD را برای Featureهای کوچک و پیچیده در Existing Codebaseها به کار بگیری.

🧠 یاد میگیری Context موردنیاز AI را با Architecture Documentها و فایل project-context.md مهندسی کنی.

🧪 میتونی با استفاده از Module مربوط به TEA، فرایندهای ATDD، Automate و Test Design را اجرا کنی.

👤 این کتاب برای چه کسانیه؟

💻 این دوره برای Software Developerها و Engineerهاییه که میخوان با AI Coding Assistantها مؤثرتر Software بسازن.

🤖 مطالب برای Developerهایی که همین حالا از ابزارهایی مثل Cursor یا GitHub Copilot استفاده میکنن مناسبه؛ به‌خصوص کسانی که میخوان به‌جای درگیری مداوم با Hallucinationها، به نتایجی پایدار و باکیفیت در سطح Production برسن.

🏢 Tech Leadها و Engineering Managerهایی که قصد دارن Workflowهای ساختاریافته توسعه با کمک AI را وارد Teamهای خودشون کنن هم میتونن از این رویکرد استفاده کنن.

📌 برای مطالعه کتاب، درک پایه‌ای از Software Development لازمه؛ اما به تجربه قبلی در BMAD یا Prompt Engineering نیازی نیست.

📖 فهرست مطالب

فصل ۱. معرفی Spec-Driven Development و BMAD Method

فصل ۲. مرحله Upstream؛ Analysis، Planning و Solutioning

فصل ۳. مرحله Downstream؛ Implementation و Sprinting

فصل ۴. اجرای BMAD روی یک پروژه موجود

فصل ۵. اجرای BMAD روی یک پروژه جدید

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

👤 درباره نویسنده

💼 مارلون ویدال یک مدیر حوزه Technology با پانزده سال سابقه حرفه‌ای و بیش از هفت سال تجربه در Digital Marketing است؛ ترکیبی منحصربه‌فرد از تخصص فنی و دیدگاه تجاری.

🏢 او درحال‌حاضر Engineering Manager در TELUS Digital است.

🤖 مارلون به‌عنوان Cursor Ambassador رسمی در برزیل برای شهرهای Belo Horizonte, MG و Porto Alegre, RS فعالیت میکنه.

📢 او همچنین مالک یک Digital Marketing Agency با تمرکز بر Online Advertising است.

⚙️ مسیر حرفه‌ای او شامل فعالیت در شرکت‌هایی مثل Banco BS2، Avenue Code، Gap، Fanatics، BMG Money، Grupo Fácil، Minds Digital و Grupo Boticário میشه. او در طول این مسیر از Developer به Head of Technology رسیده است.

🚀 مارلون در کنار فعالیت‌های حرفه‌ای خود، دو شرکت نیز تأسیس کرده که دیدگاه کارآفرینانه او را تقویت کرده‌اند.

Learn Spec-Driven Development with the Breakthrough Method for Agile AI-Driven Development (BMAD) and use specialized AI agents to analyze, architect, implement, and test software for both new and existing projects.

Key Features

• Master BMAD + TEA complete agentic workflow, from upstream planning to downstream code delivery
• Apply Spec-Driven Development to both new and existing projects using BMAD v4 and v6
• Build reliable AI-assisted software by engineering context with specs and architecture docs

Book Description

Most developers using AI assistants struggle not because of the tool, but because of poor context. When agents receive vague instructions, they produce unreliable code. Spec-Driven Development (SDD) solves this by requiring structured specifications before a single line of code is written.

BMAD is an open-source agentic framework that organizes development into two phases: upstream (analysis, planning, and solutioning) and downstream (implementation and testing). Each phase is handled by specialized AI agents working in sequence, with clear inputs and outputs.

You'll learn how BMAD v6 extends earlier versions through concepts such as Progressive Disclosure, improved context management, TEA integration, and the project-context.md file, which provides a persistent source of truth throughout development. You'll build complete features by orchestrating multiple agents and workflows, applying BMAD to both existing codebases and greenfield projects while running full sprint cycles from planning through implementation and retrospective.

By the end, you'll have a repeatable, structured process for building software with AI that produces consistent, production-ready results regardless of project size or complexity.

What you will learn

• Master BMAD's upstream-to-downstream agentic workflow
• Use Analyst, PM, and Architect agents to create specs
• Implement and test code using the Dev and QA agents
• Plan sprints and perform retrospectives with the Scrum Master agent
• Build new projects end-to-end using the full BMAD cycle
• Work with existing codebases for small and complex features
• Engineer AI context with architecture docs and project-context.md
• Run ATDD, Automate and Test Design using TEA module

Who this book is for

This course is designed for software developers and engineers who want to build more effectively with AI coding assistants. It is ideal for developers already using tools like Cursor or GitHub Copilot who want to stop fighting hallucinations and start getting consistent, production-quality results. It also suits tech leads and engineering managers who want to introduce structured AI-assisted workflows into their teams. A basic understanding of software development is required; no prior experience with BMAD or prompt engineering is needed.

Table of Contents

1. Introducing Spec-Driven Development and BMAD Method
2. Upstream Phase: Analysis, Planning and Solutioning
3. Downstream Phase: Implementing and Sprinting
4. Applying BMAD to an Existing Project
5. Applying BMAD to a New Project
6. BMAD in Practice: Answers to Real-World Questions

About the Author

Marlon Vidal is a technology executive with a 15-year career and more than 7 years of experience in digital marketing, a unique combination of technical expertise and business vision. He is currently an Engineering Manager at TELUS Digital, an official Cursor Ambassador in Brazil for the cities of Belo Horizonte, MG, and Porto Alegre, RS, and the owner of a digital marketing agency focused on online advertising. His career includes stints at companies such as Banco BS2, Avenue Code, Gap, Fanatics, BMG Money, Grupo Fácil, Minds Digital, and Grupo Boticário, progressing from developer to Head of Technology. Along the way, he also founded two companies, further strengthening his entrepreneurial vision.