bmad-checkpoint-preview

Guides human reviewers through code changes with structured walkthroughs and risk analysis.

Updated Aug 25, 2024
One-click install
npx skills add https://github.com/LeGeRyChEeSe/LanPlay-DiscordBot --skill bmad-checkpoint-preview-legerycheese
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: bmad-checkpoint-preview
Source: https://github.com/LeGeRyChEeSe/LanPlay-DiscordBot/tree/main/bmad/src/bmm-skills/4-implementation/bmad-checkpoint-preview
Command: npx skills add https://github.com/LeGeRyChEeSe/LanPlay-DiscordBot --skill bmad-checkpoint-preview-legerycheese

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Reviewing a code change without context is slow and error-prone. This Skill walks a human reviewer through any change — a PR, commit, branch, or spec — in a structured sequence: orientation, design walkthrough, risk detail pass, manual testing suggestions, and a final approve/rework decision. ## Core Features & Use Cases - Guided Review Trail: Builds or loads a Suggested Review Order of path:line stops grouped by design concern, so reviewers see the highest-leverage code first. - Risk Spot Detection: Scans diffs for auth, schema, billing, security, and config changes, surfacing the spots where a mistake has the highest blast radius. - Decision Workflow: Ends with an explicit approve, rework, or discuss decision, including optional PR approval via gh and interactive patching. - Use Case: A developer finishes a feature branch and says "walk me through this change" — the Skill identifies the change, summarizes intent and surface area stats, then leads the reviewer through each concern step by step. ## Quick Start Ask the assistant to run a checkpoint review of the current branch or a specific PR, then follow the guided walkthrough steps.

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 review by saying "checkpoint" or "walk me through this change" with a PR, commit, or branch reference. The workflow identifies the change, summarizes intent and diff stats, then guides you through orientation, walkthrough, risk pass, and testing steps.

How does the review trail get generated for a commit?▼

If the spec has a Suggested Review Order, it is used directly. Otherwise the Skill reads the full diff and changed files, identifies 2-5 design concerns, and selects path:line stops ordered from entry point to peripherals.

Can it review a GitHub pull request directly?▼

Yes. Pass a PR reference and it resolves to a branch or commit via gh pr view. On approval it can offer to run gh pr review --approve, but only after confirming with you since it is a visible action.

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. It surfaces up to five spots ordered by blast radius, and explicitly states when no high-risk spots exist rather than inventing findings.

What happens if git is unavailable during review?▼

If the diff cannot be retrieved, trail generation fails gracefully and the workflow falls back to a non-trail path in the walkthrough step. Surface area stats are skipped with a note instead of being guessed.