mrkeyoor.com_
Fri 16 Oct 18:53 UTC
Dev Toolsevaluationupdated 10 Oct 2026

BMAD-METHOD review

BMAD-METHOD adds planning, implementation, and review skills to an AI coding tool you already use. It keeps product decisions and technical constraints in written project context so you can carry them into later coding sessions.

+178stars / 7d
Verdict

Our BMAD-METHOD run installed 36 packages in 10 seconds and built successfully, but its test command exited with code 4 after pytest rejected -n. Try it when preserving decisions across assistant sessions is worth maintaining written project context. Require independent verification before trusting review output: the current code-review prompt can return its clean response for unreadable content.

We ran it

Lab card: what happened when we ran BMAD-METHODScreenshot of BMAD-METHOD (github.com/bmad-code-org/BMAD-METHOD)
Install✓ · 10s36 packages · 38 MB
Build✓ · 1s
Tests✗ · 1sran, no count parsed
Known vulns0(pip-audit)
Repo605 files~28,933 lines of source · 5.2 MB · 5 CI workflows

Answers from our run

Does BMAD-METHOD build from source?

Dependencies installed in 10 seconds (36 packages), and the build succeeded in 1 seconds. We cloned commit 8f2c13d into a clean Debian container with 3 CPUs and no project-specific setup.

Do BMAD-METHOD's tests pass?

The test command failed in our container, and its output did not report a pass or fail count.

Does BMAD-METHOD have known vulnerabilities in its dependencies?

pip-audit found none in the dependency tree at the time of our run.

Who should not use BMAD-METHOD?

Teams that require a green fresh-container test command before adoption: our test step exited with code 4 because pytest rejected -n.

What are the alternatives to BMAD-METHOD?

Spec Kit, OpenSpec. Our BMAD-METHOD run installed 36 packages in 10 seconds and built successfully, but its test command exited with code 4 after pytest rejected -n.

Setup3/510-second install passed; assistant setup remains a separate check
Docs4/5Clear entry points and optional planning, with an input-size warning
Community5/554,016 stars and October 10 push plus issue activity
Maturity3/5Failed test command and an open clean-review prompt defect

Discussed on

  1. hnBMad-Method: Universal AI Agent Framework4 points

Who it’s for

Developers whose coding assistants keep losing agreed requirements between sessions.
Teams that need shared product or architecture decisions before splitting work into stories.
Claude Code users who want selectable workflow skills and a plugin installation route.
Maintainers of existing codebases who want to carry verified project context into changes.

Who it’s NOT for

Teams that require a green fresh-container test command before adoption: our test step exited with code 4 because pytest rejected -n.
Release pipelines that treat an agent's clean review as approval: open issue 3066 and the current code-review prompt give unreadable input the clean-result response.
Developers who want a standalone coding service: the README requires an existing skill-capable AI coding tool and uv, with Node.js, npm, and Git for the skills-CLI route.
Teams expecting to hand bmad-spec an unedited document archive: the planning guide warns that oversized input can silently lose relevant material and tells users to condense it first.

Setup reality

Our sandbox installed commit 8f2c13d on 2026-10-06 in 10 seconds, adding 36 packages and using 38 MB on disk. The build passed in 1 second. Tests failed in 1 second with exit code 4: pytest rejected -n, with /work/repo/pyproject.toml named as its configuration file. Pip-audit reported 0 known vulnerabilities.

The README requires a skill-capable AI coding tool and uv. The skills-CLI route also needs Node.js, npm, and Git. Choose the bmad hub and module records with your workflow skills, then ask bmad to run setup inside your project. Your assistant supplies model access and any provider credentials it requires.

Our unprivileged Debian container had 3 CPUs, 8 GB of RAM, and Python 3.12, without secrets. The run establishes repository setup results, not an end-to-end assistant workflow. The scan found 5 CI workflow files, no Dockerfile, and no tests directory. Verify skill discovery and project configuration separately before relying on generated work.

BMAD runs inside your existing coding tool

Run BMAD-METHOD's bmad-build inside your AI coding tool to start a change with its delivery workflow. The method gives work named skills and written context, so product choices and technical constraints can survive the next chat. That matters when an assistant fills in decisions you haven't made. You'll still need to judge the decisions it records. That's the job this method is worth trying for.

The Python checkout we measured contained 605 files, roughly 28,933 lines of source, and occupied 5.2 MB. That is a substantial collection to maintain even though the installed environment was only 38 MB. The breadth includes planning and review workflows, plus optional modules listed separately in the project README. Start with a concrete change you understand well enough to review. Adding every available perspective would make it harder to tell which part helped.

What happened when we ran it

Our sandbox installed BMAD-METHOD commit 8f2c13d in 10 seconds on 2026-10-06, adding 36 packages and using 38 MB on disk. The build succeeded in 1 second. Our measurement setup was an unprivileged Debian container using ghcr.io/astral-sh/uv:python3.12-bookworm, with 3 CPUs, 8 GB of RAM, and no secrets. These results establish that the repository's install and build steps completed in that environment.

The test step failed in 1 second with exit code 4. Its log says python -m pytest: error: unrecognized arguments: -n and identifies /work/repo/pyproject.toml as the configuration file. Pytest rejected the command arguments. The supplied log contains no passing-test count or assertion failure, so there's no basis for describing this as a partially passing suite or assigning a cause beyond the rejected option. None of these measurements establishes how well an assistant follows BMAD's instructions or whether its generated application works.

Small changes can skip the planning documents

The planning guide lets a clear change go directly to Build and says an obvious, low-risk edit may not need BMAD at all. Larger work can use bmad-spec and bmad-ticket to define an outcome and divide it into stories. A PRD is useful when several people need to agree on the product. It isn't a mandatory entrance fee for changing a button.

With 36 packages and 38 MB in our installed environment, storage wasn't the main adoption burden. Reading and maintaining the resulting documents is the more consequential commitment. I'd use the planning path when separate sessions keep contradicting an agreed requirement, then check whether the written constraint actually reaches implementation. If a short issue already captures the change, adding a product brief needs a specific reason.

Setup needs uv and a skill-capable assistant

The README requires an AI coding tool that supports skills and uv for setup and Python scripts. Its skills-CLI route also uses Node.js, npm, and Git. Select the bmad hub and the module records alongside the skills you want, then run setup inside the project. Claude Code has a plugin route. Access to the assistant and any provider credentials remains your responsibility.

The 1-second successful build is reassuring about the repository step we ran, but it doesn't establish a completed coding workflow. The README's next action happens inside an assistant, with your project open and a change request supplied. Treat that as a separate acceptance check: can the selected tool find the installed skills, retain your constraint, and produce a diff you can explain?

The review prompt can report clean without reading content

Open issue 3066 concerns the current bmad-code-review verification-gap prompt. The reporter found the instruction by inspecting files and explicitly says they hadn't reproduced it in a live run. The prompt itself directs unreadable or absent input to the same response used for a clean review. Its sibling under bmad-build instead tells the reviewer to report missing content.

Pip-audit reported 0 known vulnerabilities in our run, which doesn't address that instruction-level defect. A dependency audit checks a different surface from an agent's decision to declare a review clean. Teams using review output to approve changes should require evidence that the target was read and run their own application checks. Until that boundary is dependable, I wouldn't give BMAD's clean-review response authority to approve a merge.

October activity shows maintenance across changing workflows

GitHub reported a last push on 2026-10-10, 54,016 stars, and 55 open issues and PRs combined. The latest release, v6.12.1, shipped on October 4 with fixes for merged configuration and draft status after failed document validation. Issue 3066 remained open and had October 10 activity. The project is being maintained, though that leaves a relevant review problem unresolved.

Our scan found 5 CI workflow files, no Dockerfile, and no tests directory. Inspect the checks those workflows run before treating them as evidence of reliability. The directory scan doesn't prove that checks are absent elsewhere. Also keep the release notes separate from the measured commit and current skills: a fix documented for v6.12.1 doesn't settle the later issue about a different review prompt.

Spec Kit and OpenSpec organize specification work differently

Spec Kit carries a specification through a prescribed planning, tasks, implementation, and convergence sequence. Choose it if that sequence matches the process you want. OpenSpec keeps proposals and requirements alongside design and tasks in individual change folders. That suits a team organizing decisions around each feature. Neither comparison establishes better output quality, which our sandbox didn't measure.

BMAD's 38 MB installed footprint makes storage a modest part of the trial we measured. The useful trial is a change whose acceptance criteria you already know, with a constraint the assistant must preserve across sessions. Read its diff against that constraint. Keep the documents that help you catch a wrong decision, and insist on readable evidence before accepting a clean review.

Alternatives

ProjectWhat it isPick it when
Spec Kit gh↗A toolkit that carries specifications through planning, tasks, implementation, and convergence.pick this instead when you want a prescribed specification-to-implementation sequence as your starting process.
OpenSpec gh↗A specification workflow that keeps proposals, requirements, design, and tasks in change folders.pick this instead when change-by-change specification folders suit your workflow better than BMAD's wider planning and specialist skills.

What people are saying

  1. [github-trending] bmad-code-org/BMAD-METHOD

Sources

  1. BMAD-METHOD README and repository
  2. README at measured commit 8f2c13d
  3. Choose a planning path
  4. Issue 3066: unreadable review content reported as clean
  5. Current code-review verification-gap prompt
  6. BMAD-METHOD v6.12.1 release notes
  7. Spec Kit
  8. OpenSpec

More dev tools reviews

compose-samples · librepods · sqlmap · coucou · world-execute-me-dsh-pv · mcp-extensions · the whole board →