How bmad-code-org/bmad-method works
BMad Method is a skill-based AI-assisted software delivery method: users invoke skills in a coding tool to clarify work, plan as needed, build, review, and learn. The repository also contains BMad setup/configuration scripts, skill-evaluation runners, and an Astro documentation site. The README documents the delivery workflow; source excerpts show selected script behavior and explicit imports. Several skill workflows are not represented in the supplied tree, so their implementation links are limited to existing directories and documented relationships.
Main entry points: astro.config.mjs Site configuration · bmad Build and review · bmad-architecture Plan change · bmad-brainstorming Clarify work
Components 20
Delivery method
- Clarify work
skills/bmad-brainstorming - Recon codebase
skills/bmad-deep-recon - Plan change
skills/bmad-architecture - Build and review
skills/bmad - Retrospective
skills/bmad-retrospective
Setup and context
- Render skill snapshot
skills/bmad/scripts/render_skill.py - Project setup
skills/bmad/scripts/setup.py - Method knowledge
skills/bmad/scripts/knowledge.py
Skill evaluation
- Case evaluator
skills/bmad-eval/scripts/run_evals.py - Trigger evaluator
skills/bmad-eval/scripts/run_triggers.py - Evaluation harness
skills/bmad-eval/scripts/eval_common.py
Documentation site
- Site configuration
docs-site/astro.config.mjs - Inline diagrams
docs-site/src/rehype-inline-diagrams.js - Diagram cache
docs-site/src/integrations/diagrams.js - Markdown links
docs-site/src/rehype-markdown-links.js - Base paths
docs-site/src/rehype-base-paths.js - Site URL
docs-site/src/lib/site-url.mjs
Other components
- Developer
- Working software
- Documentation reader
Connections 22
- Developer → Clarify work: invokes when unclear
- Developer → Recon codebase: starts with existing code
- Developer → Plan change: plans larger work
- Developer → Build and review: invokes build
- Developer → Retrospective: adjusts from learning
- Clarify work → Plan change: informs planning
- Plan change → Build and review: guides implementation
- Build and review → Working software: delivers changes
- Build and review → Retrospective: feeds learning
- Developer → Project setup: runs setup
- Project setup → Render skill snapshot: refreshes skill snapshot
- Render skill snapshot → Method knowledge: uses configuration context
skills/bmad/scripts/render_skill.py - Developer → Case evaluator: runs case evaluations
skills/bmad-eval/scripts/run_evals.py - Developer → Trigger evaluator: runs trigger checks
skills/bmad-eval/scripts/run_triggers.py - Case evaluator → Evaluation harness: uses harness
skills/bmad-eval/scripts/run_evals.py - Trigger evaluator → Evaluation harness: uses harness
skills/bmad-eval/scripts/run_triggers.py - Site configuration → Site URL: resolves site URL
docs-site/astro.config.mjs - Site configuration → Inline diagrams: registers plugin
docs-site/astro.config.mjs - Site configuration → Markdown links: registers plugin
docs-site/astro.config.mjs - Site configuration → Base paths: registers plugin
docs-site/astro.config.mjs - Site configuration → Diagram cache: registers integration
docs-site/astro.config.mjs - Documentation reader → Site configuration: reads generated guidance