Skip to content
Back to search

bmad-method

Breakthrough Method for Agile Ai Driven Development

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today

Check it deeper on your machine

It has changed since its scan on 11 Nov 2026.

As a Claude Code plugin, install it and then ask Claude Code:

/plugin marketplace add keithmackay/mackayi/plugin install scanskillsafety@mackayiDo a deep scan of https://github.com/bmad-code-org/bmad-method with scanskillsafety

Or from a terminal, clone it and run it:

git clone https://github.com/keithmackay/scanskillsafety-skill ~/.claude/skills/scanskillsafetynode ~/.claude/skills/scanskillsafety/cli.cjs --deep 'https://github.com/bmad-code-org/bmad-method'

It checks the exact commit: every file, its packages against OSV (api.osv.dev), how it compares with this page's scan (findsafeskills.com receives the repository's address), and, if you agree, Claude reading every file with your own Claude subscription. It never runs the code.

Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/bmad-code-org-bmad-method/badge.svg)](/listings/bmad-code-org-bmad-method)

HTML

<a href="/listings/bmad-code-org-bmad-method"><img src="/api/listings/bmad-code-org-bmad-method/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 120 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

This file has changed since it was scanned, so this is not exactly the text that was scanned, and no line is marked. The findings are listed with the safety scan above.

  1. ![BMad Method](banner-bmad-method.png)
  2. [![Version](https://img.shields.io/github/v/tag/bmad-code-org/BMAD-METHOD?color=blue&label=version)](https://github.com/bmad-code-org/BMAD-METHOD/tags)
  3. [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)
  4. [![Discord](https://img.shields.io/badge/Discord-Join%20Community-7289da?logo=discord&logoColor=white)](https://discord.gg/gk8jAdXWmj)
  5. **Agile Ai Driven Development — turn an idea or change request into working software without giving up the thinking.**
  6. Ai Driven Development (AiDD) covers the whole effort, not only the code: what to build, how it holds together, and how it changes as you learn. BMad Method is the agile way to do it — decisions stay explicit, context carries forward, and the process sizes itself to the work. Small changes go straight to build. Complex work gets the depth it needs. The same method covers a weekend prototype and a system with years of history behind it.
  7. ![The BMad delivery loop: a vague notion starts at Clarify, a big clear idea at Plan, and a small change at Build and verify; Learn and adjust loops back to Plan](docs/images/bmad-delivery-loop.svg)
  8. _Start anywhere. Use BMad end to end, or carry its briefs, specifications, and architecture into your existing delivery workflow._
  9. ## Start Building
  10. BMad ships on two lines. The stable release is **v6.12**, installed by the npm installer and frozen aside from bug fixes. **V7** is in preview alpha on this branch: its skills, install path, and docs change often. The v7 release ETA is mid-November 2026, and it might be sooner. Both routes need [uv](https://docs.astral.sh/uv/) for BMad setup and Python scripts.
  11. ### Stable: v6.12 (recommended if stability is needed until v7 is finalized for release)
  12. With [Node.js](https://nodejs.org) 20.12+ and [Python](https://www.python.org) 3.10+, run in your project:
  13. ```bash
  14. npx bmad-method install
  15. ```
  16. Open your project in your AI coding tool, invoke `bmad-build` with what you want to change, and run `bmad-help` whenever you want guidance on what comes next. The v6.12 source and documentation live on the [V6.12 branch](https://github.com/bmad-code-org/BMAD-METHOD/tree/V6.12).
  17. ### V7 Preview Alpha (recommended for solo or small teams that can pivot as things will change before beta)
  18. Expect breaking changes between updates. You need an AI coding tool that supports skills.
  19. With [Node.js and npm](https://nodejs.org) and Git, run in your project to install core tools and BMad Method:
  20. ```bash
  21. npx skills add bmad-code-org/BMAD-METHOD/skills/core-tools --skill '*'
  22. npx skills add bmad-code-org/BMAD-METHOD/skills/method --skill '*'
  23. ```
  24. Each command installs one module whole and asks which coding tools to install to. Core tools hold the `bmad` skill for setup and help, so every install needs them.
  25. Optional modules install the same way:
  26. | Module | What it adds | Install |
  27. | --- | --- | --- |
  28. | Toolsmith | Smithy builds, converts, reviews and packages skills, agents and modules; `bmad-eval` measures them | `npx skills add bmad-code-org/BMAD-METHOD/skills/toolsmith --skill '*'` |
  29. | Founder | Nadia the Founder Advisor coaches the business side of a startup, from idea and pricing to fundraising | `npx skills add bmad-code-org/BMAD-METHOD/skills/founder` |
  30. To pick single skills instead, run `npx skills add bmad-code-org/BMAD-METHOD` and include `bmad` plus the record of each module you take skills from, such as `bmod-core-tools` and `bmod-method`.
  31. Open your coding tool in the project and ask the `bmad` skill to run
  32. `bmad setup`. Then invoke `bmad-build` with what you want to change. Ask
  33. `bmad` whenever you want guidance on what comes next or what is optional.
  34. Ask for `bmad status` to check versions and see what to run next. Ask for `bmad setup` to install updates: it runs `npx skills update`, then refreshes the project and cleans up renamed and removed skills.
  35. Report preview problems in [GitHub Issues](https://github.com/bmad-code-org/BMAD-METHOD/issues) or on [Discord](https://discord.gg/gk8jAdXWmj).
  36. ### Next steps
  37. **[Build your first project with BMad →](https://docs.bmad-method.org/start/build-your-first-change/)**
  38. **[Add BMad to an existing codebase →](https://docs.bmad-method.org/existing-codebases/start-in-an-existing-codebase/)**
  39. BMad is free and open source, with no paywalled workflows or gated community.
  40. ## Why BMad?
  41. Coding assistants are effective at implementation, but they often turn unstated assumptions into code. BMad keeps you in control while its agents and workflows make the important decisions explicit and preserve them as context for the work that follows.
  42. - **Right-sized process** — Go directly to implementation for clear changes or add deeper planning for larger initiatives.
  43. - **New or existing code** — Start from nothing, or establish verified context on a codebase you inherited and work from what is actually there.
  44. - **Durable context** — Carry product and technical decisions forward instead of re-explaining them in every chat.
  45. - **Specialized perspectives** — Bring in product, architecture, UX, development, and testing expertise when it helps.
  46. - **Guided collaboration** — Use structured workflows and multiple-agent discussions without handing over judgment.
  47. - **One delivery path** — Move from early thinking through reviewed implementation, correction, and learning.
  48. [See how much planning a change needs →](https://docs.bmad-method.org/plan/choose-a-planning-path/)
  49. ## BMad Ecosystem
  50. Install the core method or add official modules for specialized work.
  51. | Module | Purpose |
  52. | --- | --- |
  53. | **[BMad Method](https://github.com/bmad-code-org/BMAD-METHOD)** | Plan and deliver software, from new prototypes to established codebases |
  54. | **[BMad Builder](https://github.com/bmad-code-org/bmad-builder)** | Skill, workflow, and agent builder |
  55. | **[BMad Creative Intelligence Suite](https://github.com/bmad-code-org/bmad-module-creative-intelligence-suite)** | Creative thinking partners for innovation, design thinking, and storytelling |
  56. | **[BMad Test Architect](https://github.com/bmad-code-org/bmad-method-test-architecture-enterprise)** | Enterprise testing add-on for BMad Method |
  57. | **[BMad Loop](https://github.com/bmad-code-org/bmad-loop)** | Builds, verifies, and retros a whole epic unattended |
  58. | **[BMad Game Dev Studio](https://github.com/bmad-code-org/bmad-module-game-dev-studio)** | Ideate, design, and build games in any framework, including Unity, Unreal, Godot, and Phaser |
  59. ## Documentation
  60. - **[Build Your First Change](https://docs.bmad-method.org/start/build-your-first-change/)** — Install BMad and build a small project.
  61. - **[Choose a Planning Path](https://docs.bmad-method.org/plan/choose-a-planning-path/)** — Pick how much planning a change needs and see what each planning skill produces.
  62. - **[Start in an Existing Codebase](https://docs.bmad-method.org/existing-codebases/start-in-an-existing-codebase/)** — Add BMad to an existing codebase.
  63. ## Community
  64. - [Discord](https://discord.gg/gk8jAdXWmj) — Get help, share ideas, and collaborate.
  65. - [YouTube](https://youtube.com/@BMadCode) — Watch tutorials and master classes.
  66. - [GitHub Issues](https://github.com/bmad-code-org/BMAD-METHOD/issues) — Report bugs and request features.
  67. - [GitHub Discussions](https://github.com/bmad-code-org/BMAD-METHOD/discussions) — Join longer community conversations.
  68. - [BMad Code](https://bmadcode.com) — Explore the wider ecosystem.
  69. ## Support and Contributing
  70. BMad is free for everyone and always will be. Star the repository, [buy me a coffee](https://buymeacoffee.com/bmad), or email <contact@bmadcode.com> for corporate sponsorship.
  71. Contributions are welcome. Read [CONTRIBUTING.md](CONTRIBUTING.md) before opening a pull request.
  72. ## License
  73. MIT License — see [LICENSE](LICENSE) for details.
  74. **BMad** and **BMAD-METHOD** are trademarks of BMad Code, LLC. See [TRADEMARK.md](TRADEMARK.md) for details.
  75. If you would like to contribute, join us in the discord and read [CONTRIBUTORS.md](CONTRIBUTORS.md) first.

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.