BMAD-RAVEN
Orchestration Framework for Enterprise AI Development
BMAD-RAVEN — An enterprise-grade AI-driven agile development framework with true scale-adaptive intelligence that adjusts from bug fixes to regulated enterprise systems.
100% free and open source. No paywalls. No gated content. No gated Discord.
Why BMAD-RAVEN?
Traditional AI tools do the thinking for you, producing average results. BMAD-RAVEN agents and facilitated workflows act as expert collaborators who guide you through a structured process — from brainstorming through governance-compliant deployment.
- AI Intelligent Help — Ask
/bmad-helpanytime for guidance on what's next - Scale-Domain-Adaptive — Automatically adjusts planning depth based on project complexity
- Enterprise Governance — Constitution-based policy management with multi-layer config (org > team > project)
- Dual Execution Model — SYNC (human-in-the-loop) and ASYNC (agent-delegated with macro-review) modes
- Structured Workflows — 40+ workflows grounded in agile best practices across analysis, planning, architecture, and implementation
- Specialized Agents — 10 domain experts with distinct personas and deep specialization
- Session Tracing — Structured decision trails for audit, learning, and compliance
- Spec-Code Sync — Automated drift detection between specifications and codebase
- Compliance Ready — SOC 2, HIPAA, ISO 27001, GDPR checklist mapping out of the box
- Party Mode — Bring multiple agent personas into one session to collaborate and discuss
- Complete Lifecycle — From brainstorming to deployment to retrospective and knowledge capture
Learn more at docs.bmad-method.org
Agent Roster
BMAD-RAVEN ships with 10 specialized agents, each with a distinct persona, domain expertise, and curated workflow menu.
| Icon | Name | Role | Key Capabilities |
|---|---|---|---|
| 📊 | Mary — Business Analyst | Strategic Analysis + Requirements | Brainstorming, market/domain/technical research, product briefs, knowledge extraction |
| 📋 | John — Product Manager | Product Strategy + Requirements | PRD creation/validation/editing, UX design guidance, epics & stories |
| 🏗️ | Winston — Architect | System Design + Technical Leadership | Architecture creation, implementation readiness checks, spec-code sync |
| 🏃 | Bob — Scrum Master | Agile Ceremonies + Story Preparation | Sprint planning, story creation, retrospectives, course correction, multi-repo setup |
| 💻 | Amelia — Developer Agent | Senior Implementation Engineer | Story execution, strict AC adherence, test-driven implementation |
| 🎨 | Sally — UX Designer | User Experience + UI Design | User research, interaction design, wireframes, usability testing |
| 📚 | Paige — Technical Writer | Documentation + Knowledge Curation | Document creation, validation, Mermaid diagrams, concept explanations |
| 🚀 | Barry — Quick Flow Solo Dev | Full-Stack + Rapid Delivery | Quick specs, rapid implementation, unified quick flow for one-off tasks |
| 🏛️ | Victoria — Governance Officer | Enterprise Policy + Compliance | Constitution management, quality gates, compliance mapping, policy evolution |
| 🔬 | QA Agent | Quality Assurance + Test Automation | E2E test generation, API test suites, framework-aware test creation |
Lifecycle Phases & Workflows
Phase 1 — Analysis
| Code | Workflow | Description |
|---|---|---|
| BP | Brainstorm Project | Expert-guided facilitation through brainstorming techniques |
| MR | Market Research | Market analysis, competitive landscape, customer needs |
| DR | Domain Research | Industry domain deep dive, subject matter expertise |
| TR | Technical Research | Technical feasibility, architecture options |
| CB | Create Brief | Guided experience to nail down your product idea |
Phase 2 — Planning
| Code | Workflow | Description |
|---|---|---|
| CP | Create PRD | Expert-led facilitation to produce your Product Requirements Document |
| VP | Validate PRD | Validate PRD is comprehensive, lean, and cohesive |
| EP | Edit PRD | Improve and enhance an existing PRD |
| CU | Create UX | Guidance through realizing the plan for your UX |
Phase 3 — Solutioning
| Code | Workflow | Description |
|---|---|---|
| CA | Create Architecture | Guided workflow to document technical decisions |
| CE | Create Epics & Stories | Create the epics and stories listing |
| IR | Implementation Readiness | Ensure PRD, UX, Architecture, and Epics are aligned |
Phase 4 — Implementation
| Code | Workflow | Description |
|---|---|---|
| SP | Sprint Planning | Generate sprint plan for development tasks |
| SS | Sprint Status | Summarize sprint status and route to next workflow |
| CS | Create Story | Prepare a story with full context for implementation |
| VS | Validate Story | Validate story readiness before development |
| DS | Dev Story | Execute story implementation tasks and tests |
| CR | Code Review | Review implementation against acceptance criteria |
| QA | QA Automation Test | Generate automated API and E2E tests |
| ER | Retrospective | Review completed work, lessons learned |
Anytime Workflows
| Code | Workflow | Description |
|---|---|---|
| QS | Quick Spec | Quick one-off spec for simple tasks |
| QD | Quick Dev | Rapid implementation without extensive planning |
| CC | Correct Course | Navigate significant mid-implementation changes |
| DP | Document Project | Analyze existing project to produce documentation |
| GPC | Generate Project Context | Scan codebase for LLM-optimized project context |
| WD | Write Document | Create documentation following best practices |
| VD | Validate Document | Review documents against standards |
| MG | Mermaid Generate | Create Mermaid diagrams |
| EC | Explain Concept | Technical explanations with examples and diagrams |
Enterprise Capabilities
Governance Layer
BMAD-RAVEN introduces a constitution-based governance framework managed by Victoria, the Governance Officer.
| Code | Workflow | Description |
|---|---|---|
| GI | Initialize Constitution | Bootstrap project constitution with policies and AI directives |
| GV | Validate Constitution | Validate completeness, alignment, and internal consistency |
| GE | Evolve Constitution | Propose and track changes based on lessons learned |
| GQ | Quality Gates | Define and configure quality gate thresholds for SYNC/ASYNC modes |
The constitution supports multi-layer configuration (organization > team > project) and integrates with implementation workflows — dev stories, code reviews, and sprint planning all reference the constitution for policy enforcement.
Dual Execution Model
Every workflow can run in one of three execution modes:
- SYNC — Human-in-the-loop review at each step. Higher quality threshold (default 80%). Full interactive control.
- ASYNC — Agent-delegated execution with macro-review at completion. Lower threshold (default 60%). Generates delegation context for consolidated review.
- Adaptive — Agent evaluates task complexity and auto-selects the appropriate mode.
| Code | Workflow | Description |
|---|---|---|
| DLR | Delegation Review | Review delegated async workflow results in consolidated macro-review |
Session Tracing
Automated 3-part narrative traces capture every workflow execution:
- Problem/Context — Trigger, project state, inputs loaded
- Key Decisions — Decision table with category, choice, alternatives, rationale, evidence
- Final Solution — Artifacts produced, evidence trail, affected files, quality gate results
| Code | Workflow | Description |
|---|---|---|
| GST | Generate Session Trace | Generate a structured session trace from the most recent workflow |
Knowledge Extraction
Close the learning loop by extracting reusable patterns from session traces and retrospectives.
| Code | Workflow | Description |
|---|---|---|
| LU | Knowledge Extraction | Extract reusable learnings for organizational knowledge |
Spec-Code Synchronization
Detect drift between your specifications (PRD, architecture, epics) and the actual codebase.
| Code | Workflow | Description |
|---|---|---|
| SC | Spec-Code Sync | Generate drift report with severity scoring and recommended actions |
Additional Enterprise Tools
| Code | Workflow | Description |
|---|---|---|
| MRS | Multi-Repo Setup | Initialize multi-repo coordination manifest for microservices |
| CD | Cost Dashboard | View LLM token usage, costs, and manage budget alerts |
Compliance Certification Mapping
Built-in checklists for regulatory frameworks, mapped to BMAD artifacts:
- SOC 2 Type II — 12 requirements covering security, availability, and confidentiality
- HIPAA — 14 requirements for health information protection
- ISO 27001 — 14 controls for information security management
- GDPR — 14 requirements for data protection and privacy
Checklists are loaded during constitution initialization and tracked through the governance lifecycle.
Modules
BMAD-RAVEN extends with official modules for specialized domains. Available during installation or anytime after.
| Module | Purpose |
|---|---|
| BMad Method (BMM) | Core framework with 40+ workflows |
| BMad Builder (BMB) | Create custom BMad agents and workflows |
| Test Architect (TEA) | Risk-based test strategy and automation |
| Game Dev Studio (BMGD) | Game development workflows (Unity, Unreal, Godot) |
| Creative Intelligence Suite (CIS) | Innovation, brainstorming, design thinking |