GV

GeezerVison

The World Wide Web, restored to 800 pixels of glory.

Home|About|Gaming cabinet|Archives|How it works|Starter sites

On this site

  • Sign in
  • ActionsCI/CD and automation
  • CodespacesCloud development environments
  • All Features
  • Documentation
  • Training
  • Certifications
  • Build with Copilot
  • Customize Copilot
  • Integrations
  • Trending repos
  • GitHub Sponsors
  • Developer articles
  • Enterprises

This view

  • Original page
  • New address

GeezerVison is showing github.com — GitHub - bmad-code-org/BMAD-METHOD: Breakthrough Method for Agile Ai Driven Development

BranchesTags
Open more actions menu

Latest commit

 

History

2,374 Commits
2,374 Commits

Folders and files

NameName
Last commit message
Last commit date
.github
.github
 
 
docs-site
docs-site
 
 
docs
docs
 
 
skills
skills
 
 
tools
tools
 
 
.coderabbit.yaml
.coderabbit.yaml
 
 
.gitignore
.gitignore
 
 
.npmrc
.npmrc
 
 
.pre-commit-config.yaml
.pre-commit-config.yaml
 
 
.python-version
.python-version
 
 
.yamllint.yaml
.yamllint.yaml
 
 
AGENTS.md
AGENTS.md
 
 
CHANGELOG.md
CHANGELOG.md
 
 
CNAME
CNAME
 
 
CONTRIBUTING.md
CONTRIBUTING.md
 
 
CONTRIBUTORS.md
CONTRIBUTORS.md
 
 
LICENSE
LICENSE
 
 
README.md
README.md
 
 
SECURITY.md
SECURITY.md
 
 
TRADEMARK.md
TRADEMARK.md
 
 
Wordmark.png
Wordmark.png
 
 
action.yml
action.yml
 
 
banner-bmad-method.png
banner-bmad-method.png
 
 
greptile.json
greptile.json
 
 
pyproject.toml
pyproject.toml
 
 
uv.lock
uv.lock
 
 

Repository files navigation

BMad Method

Version License: MIT Discord

Agile Ai Driven Development — turn an idea or change request into working software without giving up the thinking.

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.

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

Start anywhere. Use BMad end to end, or carry its briefs, specifications, and architecture into your existing delivery workflow.

Start Building

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 for BMad setup and Python scripts.

Stable: v6.12 (recommended if stability is needed until v7 is finalized for release)

With Node.js 20.12+ and Python 3.10+, run in your project:

npx bmad-method install

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.

V7 Preview Alpha (recommended for solo or small teams that can pivot as things will change before beta)

Expect breaking changes between updates. You need an AI coding tool that supports skills.

With Node.js and npm and Git, run in your project to install core tools and BMad Method:

npx skills add bmad-code-org/BMAD-METHOD/skills/core-tools --skill '*'
npx skills add bmad-code-org/BMAD-METHOD/skills/method --skill '*'

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.

Optional modules install the same way:

Module What it adds Install
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 '*'
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

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.

Open your coding tool in the project and ask the bmad skill to run bmad setup. Then invoke bmad-build with what you want to change. Ask bmad whenever you want guidance on what comes next or what is optional.

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.

Report preview problems in GitHub Issues or on Discord.

Next steps

Build your first project with BMad →

Add BMad to an existing codebase →

BMad is free and open source, with no paywalled workflows or gated community.

Why BMad?

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.

  • Right-sized process — Go directly to implementation for clear changes or add deeper planning for larger initiatives.
  • New or existing code — Start from nothing, or establish verified context on a codebase you inherited and work from what is actually there.
  • Durable context — Carry product and technical decisions forward instead of re-explaining them in every chat.
  • Specialized perspectives — Bring in product, architecture, UX, development, and testing expertise when it helps.
  • Guided collaboration — Use structured workflows and multiple-agent discussions without handing over judgment.
  • One delivery path — Move from early thinking through reviewed implementation, correction, and learning.

See how much planning a change needs →

BMad Ecosystem

Install the core method or add official modules for specialized work.

Module Purpose
BMad Method Plan and deliver software, from new prototypes to established codebases
BMad Builder Skill, workflow, and agent builder
BMad Creative Intelligence Suite Creative thinking partners for innovation, design thinking, and storytelling
BMad Test Architect Enterprise testing add-on for BMad Method
BMad Loop Builds, verifies, and retros a whole epic unattended
BMad Game Dev Studio Ideate, design, and build games in any framework, including Unity, Unreal, Godot, and Phaser

Documentation

  • Build Your First Change — Install BMad and build a small project.
  • Choose a Planning Path — Pick how much planning a change needs and see what each planning skill produces.
  • Start in an Existing Codebase — Add BMad to an existing codebase.

Community

  • Discord — Get help, share ideas, and collaborate.
  • YouTube — Watch tutorials and master classes.
  • GitHub Issues — Report bugs and request features.
  • GitHub Discussions — Join longer community conversations.
  • BMad Code — Explore the wider ecosystem.

Support and Contributing

BMad is free for everyone and always will be. Star the repository, buy me a coffee, or email [email protected] for corporate sponsorship.

Contributions are welcome. Read CONTRIBUTING.md before opening a pull request.

License

MIT License — see LICENSE for details.

BMad and BMAD-METHOD are trademarks of BMad Code, LLC. See TRADEMARK.md for details.

If you would like to contribute, join us in the discord and read CONTRIBUTORS.md first.

About

Breakthrough Method for Agile Ai Driven Development

Topics

agileaicontext-engineeringsdlcspec-driven-development

Resources

Readme
License

Code of conduct

Code of conduct

Contributing

Contributing

Security policy

Security policy
Activity
Custom properties

Stars

55.3k stars

Watchers

414 watching

Forks

6.2k forks
Report repository

Releases

Sponsor this project

Packages

Used by

Contributors

Languages

You are visitor 01402503 — GeezerVison does not store the pages you look up.
Best viewed with Netscape Navigator 4.7 or Internet Explorer 6 at 800×600. No cookies required.