Introducing AI Agentic Framework 🚀

Build Smart Agents
with a Click

Use BMad Code AI Agent Framework to simulate AI behavior with task handling, context awareness, and reasoning.

🧭 User Guide 🛠 Start Building 📘 Documentation

🎥 Watch BMad Agent Framework

What is BMad Agent Framework?

BMad is a powerful natural language-driven AI Agent Framework that works in any domain—code, creativity, business, or wellness. It enables users to create modular, goal-oriented agents with planning, tool use, and memory.

🎥 Watch The BMad-Method

🔍 What Makes BMad Method Different?

The BMad Method is not just another agent framework—it's a groundbreaking shift in how AI collaborates with humans to build software (and beyond). At its core are two revolutionary innovations that address the biggest pain points in AI-assisted workflows:

🚀 BMad Method's Two Key Innovations

1. Agentic Planning

Dedicated planning agents — Analyst, Project Manager, and Architect — work together (and with you) to generate highly structured, context-rich:

These aren’t just generic AI task lists. Through advanced prompt engineering, iterative design, and human-in-the-loop refinement, BMad creates robust, real-world plans that align tightly with your goals.

2. Context-Engineered Development

Once your PRDs and Architecture are ready, the Scrum Master (SM) agent takes over to generate detailed story files for development.

Each story file includes:

This guarantees zero context loss and eliminates confusion for Dev and QA agents—two of the most common issues in traditional AI-assisted dev environments.

✅ Your Dev agent opens a story file that reads like a blueprint—no guessing, no digging, just building.

📚 Want to See It in Action?

Explore the entire flow in the User Guide: From agent roles to PRD creation to development cycles—it’s all documented for easy onboarding.

⚙️ Quick Navigation

🧭 What Would You Like to Do?

🎥 Watch How to Plan & Build Complex Apps with Free AI

Where Can You Use BMad?

Software Development

Use Dev, Architect, and Scrum agents to write, plan, and ship reliable software fast. Try Top Tools

Business Strategy

Collaborate with PM and Analyst agents to plan, evaluate, and align business goals.

Creative Content

From storyboarding to scripting—generate content with creative and editorial agents.

Personal Wellness

Use agents to assist in journaling, mood tracking, habit loops, and mindful reflection.

🎥 Watch Complete Step-by-Step Install, Upgrade and Execution

🔄 Keep Your BMad Installation Updated

Stay on the cutting edge of Agentic Agile with just one command! Whether you're maintaining an existing BMad setup or upgrading to the latest version, updating is seamless and safe.

🛠️ Update Existing Installation

npx bmad-method install
# OR
git pull
npm run install:bmad

Benefit instantly from the latest agents, features, performance improvements, and bug fixes—without losing your custom workflow!

🚀 Quick Start: One Command for Everything

npx bmad-method install
# OR if already installed:
git pull
npm run install:bmad

🔧 Prerequisite

Make sure you have Node.js v20+ installed.

⚡ Fastest Start: Web UI + Full Stack Agent Team (2-Min Setup)

💡 Talk to the BMad Orchestrator Anytime

Use the #bmad-orchestrator command in web chat to ask questions, explore workflows, or get help.

💻 When to Switch to the IDE

👉 See the User Guide for full IDE instructions.

🧬 Alternative Setup: Clone & Build Manually

git clone https://github.com/bmadcode/bmad-method.git
npm run install:bmad

This builds and installs BMad into your destination folder, ready for customization.

🎥 Watch Better Than Vibe Coding

🌍 Beyond Software Development – Expansion Packs

BMad isn't just for building software — it's a universal agentic framework that works across any domain. With Expansion Packs, you can transform how AI helps you in diverse fields like:

🧩 What Are Expansion Packs?

📖 Learn more: Check the Expansion Packs Guide to explore available packs or create your own custom expansions!

🛠️ Codebase Flattener Tool

BMad-Method includes a powerful Codebase Flattener Tool—built to convert your full project codebase into a structured format optimized for AI model consumption.

✨ Key Features

🧪 Usage Examples

🔹 Default use (flattens current directory):

npx bmad-method flatten

🔹 Flatten a custom input directory:

npx bmad-method flatten --input /path/to/source
npx bmad-method flatten -i /path/to/source

🔹 Specify custom output file:

npx bmad-method flatten --output my-code.xml
npx bmad-method flatten -o /custom/output/path/code.xml

🔹 Combine input and output:

npx bmad-method flatten --input /my/code --output /my/output/code.xml

📦 Example Output

📊 Completion Summary:
✅ Successfully processed 156 files into flattened-codebase.xml
📁 Output file: /path/to/your/project/flattened-codebase.xml
📏 Total source size: 2.3 MB
📄 Generated XML size: 2.1 MB
📝 Total lines of code: 15,847
🔢 Estimated tokens: 542,891
📊 File breakdown: 142 text, 14 binary, 0 errors

The flattened XML file is a fully structured, AI-readable representation of your code—perfect for:

⚡ Give your AI agents full project awareness in seconds—no manual zipping, no prep work.

🎥 Watch BMad Planning Workflow

🧠 BMad Planning Workflow

graph TD
    A["Start: Project Idea"] --> B{"Optional: Analyst Research"}
    B -->|Yes| C["Analyst: Brainstorming (Optional)"]
    B -->|No| G{"Project Brief Available?"}
    C --> C2["Analyst: Market Research (Optional)"]
    C2 --> C3["Analyst: Competitor Analysis (Optional)"]
    C3 --> D["Analyst: Create Project Brief"]
    D --> G
    G -->|Yes| E["PM: Create PRD from Brief (Fast Track)"]
    G -->|No| E2["PM: Interactive PRD Creation (More Questions)"]
    E --> F["PRD Created with FRs, NFRs, Epics & Stories"]
    E2 --> F
    F --> F2{"UX Required?"}
    F2 -->|Yes| F3["UX Expert: Create Front End Spec"]
    F2 -->|No| H["Architect: Create Architecture from PRD"]
    F3 --> F4["UX Expert: Generate UI Prompt for Lovable/V0 (Optional)"]
    F4 --> H2["Architect: Create Architecture from PRD + UX Spec"]
    H --> I["PO: Run Master Checklist"]
    H2 --> I
    I --> J{"Documents Aligned?"}
    J -->|Yes| K["Planning Complete"]
    J -->|No| L["PO: Update Epics & Stories"]
    L --> M["Update PRD/Architecture as needed"]
    M --> I
    K --> N["📁 Switch to IDE (If in a Web Agent Platform)"]
    N --> O["PO: Shard Documents"]
    O --> P["Ready for SM/Dev Cycle"]

    style A fill:#f5f5f5,color:#000
    style B fill:#e3f2fd,color:#000
    style C fill:#e8f5e9,color:#000
    style C2 fill:#e8f5e9,color:#000
    style C3 fill:#e8f5e9,color:#000
    style D fill:#e8f5e9,color:#000
    style E fill:#fff3e0,color:#000
    style E2 fill:#fff3e0,color:#000
    style F fill:#fff3e0,color:#000
    style F2 fill:#e3f2fd,color:#000
    style F3 fill:#e1f5fe,color:#000
    style F4 fill:#e1f5fe,color:#000
    style G fill:#e3f2fd,color:#000
    style H fill:#f3e5f5,color:#000
    style H2 fill:#f3e5f5,color:#000
    style I fill:#f9ab00,color:#fff
    style J fill:#e3f2fd,color:#000
    style K fill:#34a853,color:#fff
    style L fill:#f9ab00,color:#fff
    style M fill:#fff3e0,color:#000
    style N fill:#1a73e8,color:#fff
    style O fill:#f9ab00,color:#fff
    style P fill:#34a853,color:#fff

🎥 Watch The Complete IDE Workflow

💻 BMad Development Cycle

graph TD
    A["📁 PRD + Architecture Documents Ready"] --> B["PO: Shard Docs into Dev Stories"]
    B --> C["SM: Queue Story Files for Dev Agent"]
    C --> D["Dev Agent: Review Story Context"]
    D --> E["Dev Agent: Implement Code"]
    E --> F["Dev Agent: Write Tests"]
    F --> G["Dev Agent: Commit Code + Notes"]
    G --> H["SM: Review for Completion"]
    H --> I{"Tests Passed?"}
    I -->|Yes| J["SM: Forward to QA Agent"]
    I -->|No| K["Dev Agent: Rework + Fix"]
    J --> L["QA Agent: Run Tests + Review"]
    L --> M{"QA Passes?"}
    M -->|Yes| N["SM: Merge PR & Close"]
    M -->|No| O["QA Agent: Write Bug Report"]
    O --> P["Dev Agent: Fix Bugs"]
    P --> H

    style A fill:#f5f5f5,color:#000
    style B fill:#e3f2fd,color:#000
    style C fill:#c5cae9,color:#000
    style D fill:#e8f5e9,color:#000
    style E fill:#e0f7fa,color:#000
    style F fill:#e0f7fa,color:#000
    style G fill:#ffe0b2,color:#000
    style H fill:#f3e5f5,color:#000
    style I fill:#e3f2fd,color:#000
    style J fill:#fff9c4,color:#000
    style K fill:#ffcdd2,color:#000
    style L fill:#c8e6c9,color:#000
    style M fill:#e3f2fd,color:#000
    style N fill:#4caf50,color:#fff
    style O fill:#ffcdd2,color:#000
    style P fill:#ffecb3,color:#000