Files
BMAD-METHOD/docs/index.md
T
Alex Verkhovsky 11bfd36d58 docs: route the landing page by task (#2776)
* docs: make the landing page route readers by task

* docs: frame the landing page as think then build

The first pass routed by task but still treated bmad-build as the product.
Name both skill groups, send first-time readers to Getting Started, and
split spec work from the longer planning path.

* Update docs/index.md

Co-authored-by: greptile-apps[bot] <165735046+greptile-apps[bot]@users.noreply.github.com>

---------

Co-authored-by: greptile-apps[bot] <165735046+greptile-apps[bot]@users.noreply.github.com>
2026-08-26 03:46:23 -07:00

2.3 KiB

title, description, hero
title description hero
Build Software with BMad BMad helps you decide what to build and then build it. Start here to install it, make your first change, or find the path that fits the work in front of you.
title tagline actions
Turn ideas into software.<br>At any scale. Think it through, then build it. You make the calls, so you understand what you ship.
text link variant
Build your first change ./tutorials/getting-started/ primary
text link variant
Install BMad ./how-to/install-bmad/ secondary

BMad adds a set of named commands, called skills, to AI coding tools such as Claude Code and Cursor. Some of them help you think: explore an idea, research it, argue against it, and write down what you have settled on. Others help you build: give bmad-build a change you want made, and it writes the code and reviews it.

You can use either group on its own. Many people run the thinking skills and never ask BMad to write a line of code, and a small fix can go straight to building with no planning at all.

Find Your Starting Point

You want to see it work. Getting Started walks through one build in an empty project.

You know exactly what needs to change, and it is small. Run bmad-build and describe the change. See Quick Fixes.

You are working in an existing codebase. Consider running bmad-project-context, then build as usual. See Established Projects and Manage Project Context.

You are building a larger feature or a whole product. If you can give bmad-spec a complete intent, start there. If you need to go through the ideation/planning paces first, choose a path in the Workflow Map.

Your idea is still vague, or you are not sure it is a good one. Generate options with Brainstorming, gather evidence with Deep Recon, or pressure-test the idea.

You want BMad to follow your team's own rules and practices. See Customize BMad and Expand BMad for Your Organization.

:::tip[Unsure where to start?] Run bmad-help. :::