██████╗ ███╗ ███╗ █████╗ ██████╗
██╔══██╗████╗ ████║██╔══██╗██╔══██╗
██████╔╝██╔████╔██║███████║██║ ██║
██╔══██╗██║╚██╔╝██║██╔══██║██║ ██║
██████╔╝██║ ╚═╝ ██║██║ ██║██████╔╝
╚═════╝ ╚═╝ ╚═╝╚═╝ ╚═╝╚═════╝
E N H A N C E D
BMAD Method enhanced by domain-specialized agents
BMAD-Enhanced extends the BMAD Method with domain-specialized agents. First batch of agents covers the Innovation Vortex pattern from unFIX model by Jurgen Appelo. Seven specialized agents will guide teams through full product discovery validation before building anything.
VORTEX PATTERN — 7 Streams · 7 Agents
┌──────────┐ HC1 ┌──────────┐ HC2 ┌──────────┐ HC3 ┌──────────┐
│ Isla 🔍 │─────▶│ Mila 🔬 │─────▶│ Liam 💡 │─────▶│ Wade 🧪 │
│ Empathize│ │Synthesize│ │Hypothesiz│ │Externaliz│
└──────────┘ └──────────┘ └──────────┘ └──────────┘
▲ ▲ │
│ HC6 HC4
│ │ ▼
┌──────────┐ HC8 ┌──────────┐ HC5 ┌──────────┐ │
│ Emma 🎯 │◀─────│ Max 🧭 │◀─────│ Noah 📡 │◀────────────┘
│Contextual│ │Systematiz│ │ Sensitize│
└──────────┘ └──────────┘ └──────────┘
│ │ │
└──────────────────┴──────────────────┘
HC7 · HC9 · HC10 ▶ Isla 🔍
| Agent | Stream | What they do |
|---|---|---|
| Emma 🎯 | Contextualize | Frame the right problem — lean personas, product vision, scope decisions |
| Isla 🔍 | Empathize | Understand users — empathy maps, interviews, discovery research |
| Mila 🔬 | Synthesize | Converge research into problem definitions — JTBD, pains & gains analysis |
| Liam 💡 | Hypothesize | Engineer testable hypotheses — assumption mapping, experiment design |
| Wade 🧪 | Externalize | Test assumptions — MVPs, experiments, proof-of-concept/value |
| Noah 📡 | Sensitize | Interpret production signals — behavior analysis, monitoring |
| Max 🧭 | Systematize | Capture learnings — learning cards, pivot/persevere decisions, stream navigation |
Every workflow ends with a Vortex Compass — evidence-driven routing that creates non-linear loops across all streams. Ten handoff contracts (HC1-HC10) ensure structured information flows between agents.
- Node.js 18+ or Bun
- Git
- Claude Code or Claude.ai
npm install bmad-enhanced && npx bmad-install-vortex-agentsAll 7 agents with 22 workflows are installed and ready to use.
# Read an agent file to activate it
cat _bmad/bme/_vortex/agents/contextualization-expert.md # Emma 🎯
cat _bmad/bme/_vortex/agents/discovery-empathy-expert.md # Isla 🔍
cat _bmad/bme/_vortex/agents/research-convergence-specialist.md # Mila 🔬
cat _bmad/bme/_vortex/agents/hypothesis-engineer.md # Liam 💡
cat _bmad/bme/_vortex/agents/lean-experiments-specialist.md # Wade 🧪
cat _bmad/bme/_vortex/agents/production-intelligence-specialist.md # Noah 📡
cat _bmad/bme/_vortex/agents/learning-decision-expert.md # Max 🧭Each agent presents a menu-driven interface. Pick a workflow and follow the guided steps.
your-project/
├── _bmad/bme/_vortex/
│ ├── agents/ # 7 agent definition files
│ ├── workflows/ # 22 workflows
│ ├── contracts/ # 5 artifact contract schemas (HC1-HC5)
│ ├── guides/ # User guides (all 7 agents)
│ └── config.yaml # Configuration
└── _bmad-output/
└── vortex-artifacts/ # Generated artifacts
npx bmad-version # Check current version
npx bmad-update --dry-run # Preview changes
npx bmad-update # Apply update (auto-backup)
npx bmad-doctor # Diagnose issuesYour data in _bmad-output/ is never touched. Automatic backups are created before every update.
Tip: If
npx bmad-updatereports "Already up to date" but you know a newer version exists, npx may be serving a cached copy. Force the latest with:npx -p bmad-enhanced@latest bmad-update
See UPDATE-GUIDE.md for migration paths and troubleshooting.
Each agent can be used independently or as part of the full Vortex flow:
- Emma (Contextualize) — Start here when defining a new product or problem space
- Isla (Empathize) — Start here when you need to understand users better
- Mila (Synthesize) — Start here when you have research to converge into a problem definition
- Liam (Hypothesize) — Start here when you have a problem definition and need testable hypotheses
- Wade (Externalize) — Start here when you have hypotheses ready to test
- Noah (Sensitize) — Start here when experiments have graduated to production
- Max (Systematize) — Start here when you have results and need to decide next steps
Max's Vortex Navigation workflow helps identify which stream needs attention based on evidence gaps — you don't have to follow a linear path. Every workflow ends with a Vortex Compass that routes you to the right next agent based on what you learned.
For detailed workflow descriptions and usage examples, see the Agent Guide and the individual user guides:
- Emma User Guide
- Isla User Guide
- Mila User Guide
- Liam User Guide
- Wade User Guide
- Noah User Guide
- Max User Guide
BMAD-Enhanced handles pre-implementation validation. BMAD Core handles implementation.
BMAD-Enhanced (Vortex) BMAD Core
┌──────────────────────────────────────┐ ┌──────────────────────┐
│ Isla → Mila → Liam → Wade → Noah │ ───> │ PM → Architect → Dev │
│ ↑ ↓ │ │ "Let's build it" │
│ └──── Max ◀── Noah Max ↻ │ └──────────────────────┘
│ Emma provides context at any point │
│ "Should we build this?" │
└──────────────────────────────────────┘
BMAD-Enhanced works standalone or as an extension — no BMAD Method installation required.
| Document | Description |
|---|---|
| Agent Guide | Detailed agent descriptions, workflows, and positioning |
| Testing | Automated test suite, CI pipeline, and agent test results |
| Development Guide | Architecture, building agents, and contributing |
| FAQ | Common questions about the framework |
| CHANGELOG | Complete version history |
| UPDATE-GUIDE | Migration paths and update troubleshooting |
- v1.1.0–v1.5.x — Waves 1-2: Foundation (Emma, Isla, Wade, Max — agent definitions, workflows, update system, CI/CD)
- v1.6.x — Wave 3: Complete 7-stream Vortex (added Mila, Liam, Noah — 7 agents, 22 workflows, handoff contracts, Compass routing)
- v2.0.0+ — Multi-agent collaboration, cross-agent workflows, analytics
We welcome contributions in these areas:
- Agents — New domain-specialized agents, workflow improvements
- Testing — Edge cases, performance testing
- Documentation — Tutorials, translations, video walkthroughs
- Integration — IDE plugins, third-party tools
See the Development Guide for architecture details and agent development patterns.
MIT License — see LICENSE
- BMAD Method v6.0.0 — Foundation for agent architecture
- Innovation Vortex — Pattern from the unFIX model by Jurgen Appelo
- Claude (Anthropic) — AI reasoning and agent development
Every agent below contributed to the design, implementation, testing, or documentation of this release.
Core
- BMad Master 🧙 — Orchestration and agent coordination
BMM — BMAD Method Module
- Mary 📊 Analyst — Requirements analysis and product briefs
- Winston 🏗️ Architect — Architecture decisions and technical design
- Amelia 💻 Dev — Implementation and code delivery
- John 📋 PM — Product management and PRD creation
- Barry 🚀 Quick Flow — Rapid solo development
- Quinn 🧪 QA — Quality assurance and test validation
- Bob 🏃 SM — Sprint management and retrospectives
- Paige 📚 Tech Writer — Documentation and editorial review
- Sally 🎨 UX Designer — User experience design
BME — Vortex Pattern Agents
- Emma 🎯 Contextualize — Problem framing and product vision
- Isla 🔍 Empathize — User research and empathy mapping
- Mila 🔬 Synthesize — Research convergence and problem definition
- Liam 💡 Hypothesize — Hypothesis engineering and assumption mapping
- Wade 🧪 Externalize — Lean experiments and MVP testing
- Noah 📡 Sensitize — Production intelligence and signal interpretation
- Max 🧭 Systematize — Learning capture and pivot/persevere decisions
CIS — Creative & Innovation Strategies
- Carson 🧠 Brainstorming Coach — Creative ideation facilitation
- Dr. Quinn 🔬 Problem Solver — Systematic problem-solving
- Maya 🎨 Design Thinking Coach — Human-centered design
- Victor ⚡ Innovation Strategist — Business model innovation
- Caravaggio 🎨 Presentation Master — Visual communication
- Sophia 📖 Storyteller — Narrative and storytelling
BMB — BMAD Builder Module
- Bond 🤖 Agent Builder — Agent creation and configuration
- Morgan 🏗️ Module Builder — Module architecture
- Wendy 🔄 Workflow Builder — Workflow design and validation
TEA — Test Engineering & Architecture
- Murat 🧪 Test Architect — Test framework, CI pipeline, and quality gates
Innovation Vortex Pattern — Discover what has to be disovered, deliver what has to be delivered
Get Started | Agents | Docs | Roadmap