Alex Verkhovsky
6c36990123
* docs: add Getting Deeper Django tutorial * docs: add spec-backed Django tutorial * docs: replace Getting Started with small exercises * docs(tutorials): add closing CTA to getting deeper * docs(tutorials): remove redundant hello world exercise * docs: rewrite welcome page around conversion proofs
2.8 KiB
title, description, hero
| title | description | hero | ||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| Build Software with BMad | See how BMad turns short requests and shared specifications into reviewed software changes while you keep control of important decisions. |
|
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.
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.
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.