What Is BMAD? The Agentic AI Framework for Production-Ready Development

Yuriy Butkevych (2)
Yuriy Butkevych
Co-founder and Technology Evangelist

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

Apply structured agents, workflows, and quality gates with BMAD
Talk to an Expert!

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.

      Related articles

      Your browser does not support the Canvas element.

      Tell us about your challenge!

      Use the contact form and we’ll get back to you shortly.

        Our marketing team will store your data to get in touch with you regarding your request. For more information, please inspect our privacy policy.

        thanks!

        We'll get in touch soon!

        contact us