What Is BMAD? The Agentic AI Framework for Production-Ready Development
Most teams are letting AI write their code with no plan, no structure, and no guardrails. The BMAD Method — Breakthrough Method for Agile AI-Driven Development — is the open-source framework that changes that. Here’s everything you need to know.
In February 2025, Andrej Karpathy — former Director of AI at Tesla and co-founder of OpenAI — coined a term that instantly resonated with thousands of developers: vibe coding. His definition was disarmingly honest:
“I just see things, say things, run things, and copy-paste things, and it mostly works.” — Andrej Karpathy, Feb 2025
That phrase “mostly works” is doing a lot of heavy lifting. For a solo experiment or a weekend hack, “mostly works” is fine. For a production system serving real users, “mostly works” is technical debt, security holes, and 3 a.m. incidents waiting to happen.
The BMAD Method was built to answer a simple question: What does AI-assisted development look like when you actually want it to work every time?
What Is AI-Assisted Development and Where Does It Actually Stand Today?
AI-assisted development is software engineering in which AI tools actively participate in writing, reviewing, and improving code — not just autocompleting a variable name, but also generating entire modules, suggesting architectural decisions, and catching logic errors before compilation.
The honest capability snapshot in 2025 looks like this:
Capability
Status
Write simple functions
Solved
Fix compilation / functional errors
Good
Refactor code
Good
Understand a full codebase
Limited by context window
Maintain consistency across a project
Requires structure
Replace a developer entirely
No — it amplifies, not replaces
Capability
Write simple functions
Status
Solved
Capability
Fix compilation / functional errors
Status
Good
Capability
Refactor code
Status
Good
Capability
Understand a full codebase
Status
Limited by context window
Capability
Maintain consistency across a project
Status
Requires structure
Capability
Replace a developer entirely
Status
No — it amplifies, not replaces
The key insight: AI-assisted development equals human creativity plus AI execution speed. The developer’s role shifts from writing every line to directing and reviewing AI output. That shift in role is exactly what BMAD is designed to support.
Build AI-assisted software the right way
The Context Window Problem: Why AI “Forgets” Your Codebase
To understand why unstructured AI coding fails at scale, you need to understand the context window — the amount of text, code, and conversation an AI model can hold in its working memory at one time.
Model
Context Window
Roughly Equals
GPT-4o
128K tokens
~100 pages / ~300 files
Claude 3.5 Sonnet
200K tokens
~150 pages / ~500 files
Claude Opus 4.5
200K tokens
~150 pages / ~500 files
Gemini 1.5 Pro
1M tokens
~750 pages
Claude Sonnet 4.5 / 5
1M tokens
~750 pages
GPT-4o
Context Window: 128K tokens
Roughly Equals: ~100 pages / ~300 files
Claude 3.5 Sonnet
Context Window: 200K tokens
Roughly Equals: ~150 pages / ~500 files
Claude Opus 4.5
Context Window: 200K tokens
Roughly Equals: ~150 pages / ~500 files
Gemini 1.5 Pro
Context Window: 1M tokens
Roughly Equals: ~750 pages
Claude Sonnet 4.5 / 5
Context Window: 1M tokens
Roughly Equals: ~750 pages
When you exceed the context window — which happens quickly on a real codebase — the consequences compound fast:
- The AI “forgets” code from other files
- Naming conventions become inconsistent across modules
- Duplicate functions get created
- Architecture decisions established early in the session get ignored
The core insight: Larger context windows are helpful, but the real solution is to use the available context more efficiently. That’s exactly what BMAD’s structured approach delivers.
What Is the BMAD Method?
BMAD stands for Breakthrough Method for Agile AI-Driven Development. It is an open-source methodology and framework that structures how AI agents assist throughout the entire software development lifecycle — from initial analysis and requirements, through architecture, implementation, and quality assurance.
Think of it as the missing project management layer for AI coding tools. Rather than treating an LLM as a single generalist assistant, BMAD assigns specialized AI agent roles that mirror a real development team
The BMAD Agent List
Each agent operates with a tightly scoped context: it receives only the artifacts it needs to do its job. This isn’t just organizational tidiness — it’s a deliberate strategy to use the context window efficiently and keep each LLM call focused, relevant, and high-quality.
- BMAD master: Orchestrate the workflow
- Product manager: write the PRD
- Analyst: requirements and research
- Architect: system design
- UX Designer: user flow and ui specs
- Scrum Master: sprint story generation
- Developer: implementation
- QA Engineer: testing and validation
- Tech writer: documentation
Vibe Coding vs. The BMAD Method: A Structural Comparison
The difference between ad hoc AI coding and BMAD isn’t a matter of tools — it’s a matter of process. Here’s how they compare:
BMAD Method
Vibe Coding
Structured specs written before code
“Just make it work” prompts
PRD → Architecture → Stories → Implementation
Requirements scattered in chat history
Context preserved in persistent artifacts
AI forgets context between sessions
Specialized agents for each development role
Duplicate code, inconsistent structure
Quality gates at every stage transition
No handoff between roles (design → dev → QA)
Deterministic, reviewable outputs
Works… until it doesn’t
Result: Production-ready from the start
Result: Technical debt from day 1
BMAD Method
Structured specs written before code
Vibe Coding
“Just make it work” prompts
BMAD Method
PRD → Architecture → Stories → Implementation
Vibe Coding
Requirements scattered in chat history
BMAD Method
Context preserved in persistent artifacts
Vibe Coding
AI forgets context between sessions
BMAD Method
Specialized agents for each development role
Vibe Coding
Duplicate code, inconsistent structure
BMAD Method
Quality gates at every stage transition
Vibe Coding
No handoff between roles (design → dev → QA)
BMAD Method
Deterministic, reviewable outputs
Vibe Coding
Works… until it doesn’t
BMAD Method
Result: Production-ready from the start
Vibe Coding
Result: Technical debt from day 1
What Makes a BMAD Prompt Different?
BMAD prompts aren’t “build me a login page.” They’re engineered specifications that answer five critical questions the AI needs to produce correct, consistent code:
- System context: What’s the architecture? What patterns are already in use? What are the constraints?
- Requirements clarity: Not “build a login” but “JWT-based auth with refresh tokens, 24h expiry, rate limiting at 5 requests/min.”
- Examples and anti-examples: Show what good looks like in your codebase. Show what to avoid.
- Acceptance criteria: How will you know it’s done? What tests should pass?
- Edge cases: What happens when the user does X? What if the service is down?
BMAD Tracks: Choosing the Right Scale for Your Project
BMAD is designed to scale with your project’s complexity. Rather than forcing every task through the same heavyweight process, it offers three distinct tracks:
- Quick Flow — Bug Fixes & Small Features: A technical spec only. You can start coding in under 5 minutes. Ideal for day-to-day development work where full planning overhead isn’t justified.
- Standard (BMAD Method) — Products & MVPs: Full PRD, architecture, and UX planning. The sweet spot for greenfield projects, MVPs, and platform prototypes. Structured without being bureaucratic.
- Enterprise — Compliance-Heavy & Large Scale: Full governance suite with extended documentation, audit trails, and compliance-ready artifacts. For regulated industries and large engineering organizations.
Greenfield vs. Brownfield: BMAD’s Two Core Workflows
One of BMAD’s most practical design decisions is treating new projects and existing codebases as fundamentally different problems that require different workflows.
Greenfield Workflow (New Projects)
A sequential, artifact-driven pipeline: Greenfield Pipeline
Setup → Analysis (Analyst creates brief) → Planning (PM creates PRD) → Architecture (Architect designs system) → UX Design (user flows) → Stories (Scrum Master generates sprint stories) → Development (implementing stories) → Validation (QA) → Iteration (back to stories for the next sprint).
Brownfield Workflow (Existing Codebases)
For brownfield projects, BMAD offers two approaches: Code-First (analyze existing code, then plan changes) and PRD-First (define what you want to change, then map it onto existing architecture). A Flattener tool is also available to help onboard the AI into an existing codebase efficiently.
MCP Integration: Connecting AI Agents to Your Real Dev Stack
BMAD is designed to work with the Model Context Protocol (MCP) — an open-source standard for connecting AI applications to external systems. Rather than asking your AI to work in a vacuum, MCP integrations let it query real data from the tools your team already uses.
Integration
Example Queries
SonarQube MCP
“What are the critical issues in this PR?” / “Show security hotspots in UserService”
Atlassian MCP
“What’s the context on PROJ-1234?” / “Find architecture docs for the auth module”
Azure MCP
“What’s the status of the prod deployment?” / “Generate an ARM template for App Service”
Playwright MCP
“Generate E2E tests for the checkout flow”
GitHub MCP
“Summarize changes in PR #42” / “Why did the last workflow fail?”
Figma MCP
“Generate a React component from this design”
Integration
SonarQube MCP
Example Queries
“What are the critical issues in this PR?” / “Show security hotspots in UserService”
Integration
Atlassian MCP
Example Queries
“What’s the context on PROJ-1234?” / “Find architecture docs for the auth module”
Integration
Azure MCP
Example Queries
“What’s the status of the prod deployment?” / “Generate an ARM template for App Service”
Integration
Playwright MCP
Example Queries
“Generate E2E tests for the checkout flow”
Integration
GitHub MCP
Example Queries
“Summarize changes in PR #42” / “Why did the last workflow fail?”
Integration
Figma MCP
Example Queries
“Generate a React component from this design”
This integration layer transforms the AI from a code autocomplete tool into a genuine teammate that can read your Jira tickets, check code quality scores, inspect CI/CD failures, and scaffold components directly from your design system — all within a structured, auditable workflow.
Quality Gates: The Safety Net That Vibe Coding Never Had
AI can write code fast. But fast code isn’t always good code. The goal of BMAD’s quality gates is simple: catch AI-induced issues before they reach production.
Quality gates in BMAD operate at every stage transition in the workflow. Before the Architect hands off to the Developer, the architecture document must satisfy specific criteria. Before QA signs off a story, test coverage and acceptance criteria must be met. These gates aren’t bureaucratic checkboxes — they’re the feedback loop that prevents the “mostly works” problem from compounding across sprints.
Key principle: Every agent in BMAD produces a verifiable artifact, not just a chat response. PRDs, architecture diagrams, test plans, and sprint stories are all persistent documents that can be reviewed, revised, and versioned — just like real software deliverables.
Your BMAD Agentic Toolset: What to Install
Getting up and running with BMAD requires a lightweight stack of widely-used developer tools:
Tool
Purpose
Git
Version control for your artifacts and code
VS Code
Primary IDE for agentic development
Node.js (LTS)
Runtime for CLI tools
GitHub Copilot or ClaudeCode subscription
In-editor AI assistance
OpenCode
npm install -g opencode — terminal-based AI coding
BMAD
Install using “npx bmad-method install.”
Read more here:
https://github.com/bmad-code-org/BMAD-METHOD
Tool
Git
Purpose
Version control for your artifacts and code
Tool
VS Code
Purpose
Primary IDE for agentic development
Tool
Node.js (LTS)
Purpose
Runtime for CLI tools
Tool
GitHub Copilot or ClaudeCode subscription
Purpose
In-editor AI assistance
Tool
OpenCode
Purpose
npm install -g opencode — terminal-based AI coding
Tool
BMAD
Purpose
Install using “npx bmad-method install.”
Read more here:
https://github.com/bmad-code-org/BMAD-METHOD
Compatible LLMs and Tools
One of BMAD’s biggest practical advantages is that you’re not forced into a specific AI ecosystem. The methodology has been tested across all the major models and coding environments that teams are actually using today.
On the model side, that includes Anthropic’s Claude Opus 4.5 and Sonnet, Google’s Gemini 2.5/3 Pro and Flash, OpenAI’s GPT-5.2 and Codex, and xAI’s Grok Code Fast 1.
For coding environments, BMAD works equally well whether your team is on Cursor, Windsurf, VS Code, JetBrains IDEs, Claude Code, GitHub Copilot, or OpenCode.
The bottom line: you can adopt BMAD without renegotiating your tooling stack. Pick the model that fits your budget, performance needs, and compliance requirements — BMAD works either way.
Why This Matters Now: The Inflection Point in AI Development
We are at an inflection point. AI coding tools have crossed the threshold from novelty to necessity for competitive software teams. But the tooling has outpaced the methodology. Most teams are using frontier-model AI assistants with no more structure than they’d bring to a chat conversation.
The teams that win the next five years won’t be the ones with the most tokens. They’ll be the ones that figured out how to structure human-AI collaboration at every layer of the stack — requirements, architecture, implementation, testing, and documentation.
BMAD is one of the first serious open-source attempts to answer that question systematically. Whether you adopt it wholesale or borrow its most valuable ideas — structured prompting, specialized agents, artifact-driven handoffs, quality gates — the underlying principles point toward a more mature practice of AI-assisted engineering.
Don’t just experiment with AI – Deliver it!
Reenbit is your AI-driven software development partner—from architecture to delivery, we bring structure, quality, and scalability to every solution. Talk to our team!
FAQ
What does BMAD stand for?
BMAD stands for Breakthrough Method for Agile AI-Driven Development. It is an open-source framework for structuring AI agent collaboration across the software development lifecycle.
Is BMAD free to use?
Yes. BMAD is an open-source project available on GitHub at github.com/bmad-code-org/BMAD-METHOD. It is free for individual developers and teams.
What is the difference between vibe coding and BMAD?
Vibe coding is an informal, prompt-as-you-go approach to AI coding where requirements are ad hoc and context is easily lost. BMAD replaces this with structured specs, specialized agents, persistent artifacts, and quality gates — resulting in production-ready code rather than “mostly working” experiments
Which AI models work with BMAD?
BMAD is model-agnostic. It has been validated with Anthropic Claude, Google Gemini, OpenAI GPT, and xAI Grok models. It works with any frontier LLM capable of following detailed structured prompts.
What is a BMAD quality gate?
A quality gate is a stage-transition checkpoint in the BMAD workflow that verifies each artifact meets defined criteria before the next agent begins work. It catches AI-induced issues — inconsistencies, missing requirements, coverage gaps — before they propagate downstream.
What is MCP and why does BMAD use it?
MCP (Model Context Protocol) is an open-source standard for connecting AI applications to external systems. BMAD uses MCP integrations (SonarQube, Atlassian, GitHub, Figma, etc.) to give AI agents access to real-world project data — replacing assumptions with facts from your actual development stack.
Do I need to use all BMAD agents for every project?
No. BMAD’s track system scales from a Quick Flow (tech spec only, under 5 minutes) for small tasks, to the full Standard workflow for MVPs and greenfield products, to an Enterprise track for compliance-heavy projects. You choose the appropriate scale.