Turn intent into working software

BMad works with supported AI coding tools to carry a software request through clarification, an approved plan, implementation, and review. You keep control of the decisions that shape the result, and Build returns working code you can run and inspect.

Start with Working Software

Getting Started begins in an empty directory with one short request:

/bmad-build write an implementation of mars rover kata

Build asks for the choices it needs, then gives you a plan to approve or change. It writes and reviews the program before you run the finished Mars Rover in your terminal. The request stays small; you decide what the program should become.

Build Mars Rover with BMad

Continue in a Mature Codebase

Getting Deeper moves the same direct workflow into Django 5.2.4. You ask Build to add JSON output to django-admin diffsettings, make the decisions that define that output, run the focused tests, and inspect the JSON produced by the command.

The second Django exercise shows what changes when the work spans several stories. BMad Spec records one shared contract for filtering, redaction, and CI status. Three Build runs implement it in order, and one final command shows the features working together: filtering selects the setting, redaction hides its value, and the exit status still reports the remaining difference.

Try the Django playground

Find a Specific Answer

Use the search box or sidebar when you already know what you need. These common tasks lead directly to the relevant documentation:

• Install or update BMad
• Use BMad in an established project
• Understand how Build works
• Look up installed skills

Build in Your Repository

Choose a real change in a repository you already use. Install BMad in that repository, run the installed bmad-build skill, and describe the result you want. You can settle the important choices, approve or revise the plan, and inspect the finished change in its real context.

Use BMad in your repository