Breakthrough Method for Agile Ai Driven Development
Go to file
forcetrainer c0f6401902 docs: add token usage FAQ and fix broken links
- Add "Why does BMad use so many tokens?" FAQ explaining design tradeoff
  (decision quality over code velocity)
- Fix stale anchor #adversarial-review-general → #adversarial-review
- Remove link to archived customize-workflows.md

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-12 00:31:54 -05:00
.github feat(docs): Diataxis restructure + Astro/Starlight migration (#1263) 2026-01-07 14:42:15 +08:00
.husky chore: added CC PR review (#871) 2025-11-05 14:14:31 -06:00
.vscode doc cleanup round 1 2025-12-27 18:29:35 +08:00
docs docs: add token usage FAQ and fix broken links 2026-01-12 00:31:54 -05:00
samples/sample-custom-modules Workflow Creator and Validator Tools with Sub Process Support and PRD Validation Step now available! 2026-01-11 11:13:38 +08:00
src fix: add missing review menu and HALT to quick-spec step 4 (#1305) 2026-01-11 17:04:52 +08:00
test agents all indicate hasSidecar true or false, validation requires it, agent builder and validator and editor use the field. Added a better brownfield doc 2025-12-31 21:30:19 +08:00
tools release: bump to v6.0.0-alpha.23 2026-01-11 13:16:49 +08:00
website Add link auditor, reorganize documentation, and README update (#1277) 2026-01-10 02:55:33 +08:00
.coderabbit.yaml chore: enable CodeRabbit auto-review on new PRs (#1276) 2026-01-08 07:59:30 +08:00
.gitignore feat(docs): Diataxis restructure + Astro/Starlight migration (#1263) 2026-01-07 14:42:15 +08:00
.markdownlint-cli2.yaml folder rename from .bmad to _bmad 2025-12-13 16:22:34 +08:00
.npmrc feat: v6.0.0-alpha.0 - the future is now 2025-09-28 23:17:07 -05:00
.nvmrc feat: v6.0.0-alpha.0 - the future is now 2025-09-28 23:17:07 -05:00
.prettierignore folder rename from .bmad to _bmad 2025-12-13 16:22:34 +08:00
CHANGELOG.md release: bump to v6.0.0-alpha.23 2026-01-11 13:16:49 +08:00
CNAME Add CNAME file 2026-01-07 18:18:12 +08:00
CONTRIBUTING.md docs: add how-to guide for getting BMAD answers + fix Discord channels (#1265) 2026-01-07 16:05:05 +08:00
LICENSE quick update output modified 2025-12-15 17:30:12 +08:00
README.md docs: fix year typo in README (2025 -> 2026) 2026-01-11 12:01:37 -05:00
eslint.config.mjs feat(docs): Diataxis restructure + Astro/Starlight migration (#1263) 2026-01-07 14:42:15 +08:00
package-lock.json fix: add missing review menu and HALT to quick-spec step 4 (#1305) 2026-01-11 17:04:52 +08:00
package.json fix: add missing review menu and HALT to quick-spec step 4 (#1305) 2026-01-11 17:04:52 +08:00
prettier.config.mjs feat: v6.0.0-alpha.0 - the future is now 2025-09-28 23:17:07 -05:00

README.md

BMad Method

Version License: MIT Node.js Version Discord

Build More, Architect Dreams — An AI-driven agile development framework with 21 specialized agents, 50+ guided workflows, and scale-adaptive intelligence that adjusts from bug fixes to enterprise systems.

100% free and open source. No paywalls. No gated content. No gated Discord. We believe in empowering everyone, not just those who can pay.

Why BMad?

Traditional AI tools do the thinking for you, producing average results. BMad agents act as expert collaborators who guide you through structured workflows to bring out your best thinking.

  • Scale-Adaptive: Automatically adjusts planning depth based on project complexity (Level 0-4)
  • Structured Workflows: Grounded in agile best practices across analysis, planning, architecture, and implementation
  • Specialized Agents: 12+ domain experts (PM, Architect, Developer, UX, Scrum Master, and more)
  • Complete Lifecycle: From brainstorming to deployment, with just-in-time documentation

Quick Start

Prerequisites: Node.js v20+

npx bmad-method@alpha install

Follow the installer prompts to configure your project. Then run:

*workflow-init

This analyzes your project and recommends a track:

Track Best For Time to First Story
Quick Flow Bug fixes, small features ~5 minutes
BMad Method Products and platforms ~15 minutes
Enterprise Compliance-heavy systems ~30 minutes

Modules

Module Purpose
BMad Method (BMM) Core agile development with 34 workflows across 4 phases
BMad Builder (BMB) Create custom agents and domain-specific modules
Creative Intelligence Suite (CIS) Innovation, brainstorming, and problem-solving

Documentation

Full Documentation — Tutorials, how-to guides, concepts, and reference

For v4 Users

Community

  • Discord — Get help, share ideas, collaborate
  • YouTube — Tutorials, master class, and podcast (launching Feb 2025)
  • GitHub Issues — Bug reports and feature requests
  • Discussions — Community conversations

Support BMad

BMad is free for everyone — and always will be. If you'd like to support development:

  • Star us on GitHub — Helps others discover BMad
  • 📺 Subscribe on YouTube — Master class launching Feb 2026
  • Buy Me a Coffee — Fuel the development
  • 🏢 Corporate sponsorship — DM on Discord
  • 🎤 Speaking & Media — Available for conferences, podcasts, interviews (Discord)

Contributing

We welcome contributions! See CONTRIBUTING.md for guidelines.

License

MIT License — see LICENSE for details.


BMad and BMAD-METHOD are trademarks of BMad Code, LLC.

Contributors