Build

Walk Through a Change

bmad-walkthrough is a guided human review. It writes a review narrative, then walks you through it one block at a time. You can stop to inspect, edit, or test. A block is done only when you say it is.

When to Use It

Invoke it by name: /bmad-walkthrough. Point it at a commit, PR, file, or directory.

Typical moments:

After bmad-build — take the wheel back
Reviewing a PR — especially one with more than a handful of files
Onboarding to a change — a branch you didn’t write

How it runs

Orientation. What the target is and what it is for, from a plan or spec, PR description, and commit messages when they exist.
Create review narrative. A file organized in blocks: intent, broad strokes, slices by concern (not by file), then periphery. An append-only review log sits beside it in a walkthrough-<slug>/ folder in the active initiative’s folder, or in the output folder when no initiative is active.
Walkthrough. Each block is presented in the session with a clickable link into the narrative and one to three moves that fit. Stay on the block until you say it is done.

Moves you can pick: Thoughts, Second opinion, Formal review, Test, Drive, Wrap-up. Formal review prefers bmad-code-review when it is installed. You can also ask for something that was not suggested.

What It Is Not

Not a replacement for bmad-code-review or for the review bmad-build already ran. It does not assign severity scores or produce a pass/fail verdict.