p:: AI f:: Claude Code, Cursor
Universal AI agent framework for agile AI-driven development — installs specialised agents and guided workflows into your project. Requires Node.js v20+ and npx.
v6 installs everything under _bmad/ (core/ framework, plus one folder per module) and writes generated docs to _bmad-output/. Configuration lives in a config.yaml per module rather than by editing files directly.
Install
npx bmad-method installNon-interactive install
Full flagged install used for the Ogdoad project:
npx --yes [email protected] install \
--yes --directory . --action install --all-stable \
--modules bmm,bmb,cis,tea,bmad-loop,gds \
--tools claude-code,cursor \
--user-name Adithya \
--communication-language English \
--document-output-language English \
--set core.project_name=Ogdoad \
--set 'core.output_folder={project-root}/_bmad-output' \
--set 'tea.test_artifacts={project-root}/_bmad-output/test-artifacts' \
--set tea.test_design_output=_bmad-output/test-artifacts/test-design \
--set tea.test_review_output=_bmad-output/test-artifacts/test-reviews \
--set tea.trace_output=_bmad-output/test-artifacts/traceability \
--set 'gds.planning_artifacts={project-root}/_bmad-output/planning-artifacts' \
--set 'gds.implementation_artifacts={project-root}/_bmad-output/implementation-artifacts'Note --set values containing {project-root} must be single-quoted so the shell doesn’t try to brace-expand them.
Flags
| Flag | Purpose |
|---|---|
--directory <path> | Installation directory |
--modules <ids> | Comma-separated module IDs (e.g. bmm,bmb) |
--tools <ids> | Comma-separated IDE/tool IDs, or none to skip |
--custom-content <paths> | Comma-separated paths to custom modules (each needs a module.yaml) |
--action <type> | install (default), update, quick-update, compile-agents |
--user-name <name> | Name the agents address you by (defaults to system username) |
--communication-language <lang> | Agent communication language |
--document-output-language <lang> | Generated document language |
--output-folder <path> | Output folder (defaults to _bmad-output) |
-y, --yes | Accept all defaults, skip prompts |
-d, --debug | Debug output for manifest generation |
Invalid module or tool IDs only warn; an invalid --directory or --action errors and exits.
Modules
| ID | Module |
|---|---|
bmm | BMad Method — the core agile workflow module |
bmb | BMad Builder — build your own agents, workflows, and modules |
cis | Creative Intelligence Suite |
tea | Test Architect — enterprise test strategy and automation |
bmad-loop | Registry module |
gds | Registry module (game design/dev studio) |
--all-stable pulls the stable set rather than naming each module by hand.
Test Architect (TEA)
Standalone module with an expert agent (Murat) and nine workflows: Test Design, ATDD, Automate, Test Review, Traceability, NFR Assessment, CI Setup, Framework Scaffolding, and Release Gate. Supports P0–P3 risk-based prioritisation, with optional Playwright Utils and MCP integrations.
Use TEA over the built-in QA workflow when you need requirements traceability, compliance documentation, or formal quality gates. The built-in QA workflow is the faster, happy-path option for small-to-medium projects.