bmad-checkpoint-preview

Guides human reviewers through code changes via structured walkthrough, risk, and testing steps.

Updated Jun 3, 2026
One-click install
npx skills add https://github.com/MathematicGuy/team-006-vin20k --skill bmad-checkpoint-preview-mathematicguy
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: bmad-checkpoint-preview
Source: https://github.com/MathematicGuy/team-006-vin20k/tree/main/.agent/skills/bmad-checkpoint-preview
Command: npx skills add https://github.com/MathematicGuy/team-006-vin20k --skill bmad-checkpoint-preview-mathematicguy

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Reviewing a code change without structure leads to missed risks and shallow approvals. This Skill turns an LLM into a guided review companion that walks a human through a change — from intent and orientation, through a concern-based walkthrough and risk-spot detail pass, to hands-on testing suggestions and a final approve/rework/discuss decision. ## Core Features & Use Cases - Structured 5-Step Review Flow: Orientation (intent + diff stats), Walkthrough (concern-grouped path:line stops), Detail Pass (risk-tagged hotspots like auth, schema, billing), Testing (observable behavior suggestions), and Wrap-Up (decision prompt). - Review Trail Generation: When no author-produced Suggested Review Order exists, it generates one from the diff by reading changed files and grouping cohesive design concerns. - Customizable Workflow: A customize.toml file supports team and user overrides for activation steps, persistent facts, and post-completion behavior, merged via BMad structural rules. - Use Case: After finishing a feature branch, say "walk me through this change" — the Skill identifies the change from conversation context, sprint status, or git state, computes surface-area stats, and guides you to a confident ship/rework decision. ## Quick Start Ask the assistant to checkpoint or walk you through the current branch or PR you want to review.

Frequently Asked Questions about bmad-checkpoint-preview

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I review a code change with an AI assistant?▼

Trigger the checkpoint workflow by saying "checkpoint" or "walk me through this change". The assistant identifies the change from conversation context, sprint status files, or git state, then guides you through orientation, walkthrough, risk review, and testing steps.

How does the review trail generation work without a spec?▼

When no spec with a Suggested Review Order exists, the skill reads the full diff and changed files, identifies 2-5 cohesive design concerns, and selects path:line stops ordered for comprehension. The generated trail then drives the walkthrough step.

Can I customize the checkpoint review workflow for my team?▼

Yes. Team overrides go in _bmad/custom/bmad-checkpoint-preview.toml and personal overrides in a .user.toml variant. Scalars override, arrays append, and arrays of tables keyed by code or id replace matching entries under BMad merge rules.

What risk categories does the detail pass detect?▼

The detail pass scans the diff for auth, public API, schema, billing, infra, security, and config changes, plus an open-ended other category. It surfaces up to 5 spots ordered by blast radius without assigning severity scores.

What happens if git is unavailable during a review?▼

If git is unavailable, diff stats are skipped with a notice and trail generation fails gracefully. The workflow preserves the original review mode and the walkthrough step falls back to its non-trail path.