bmad-checkpoint-preview

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

6|Updated Aug 29, 2026
One-click install
npx skills add https://github.com/HordRicJr/Akomagni --skill bmad-checkpoint-preview-hordricjr
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: bmad-checkpoint-preview
Source: https://github.com/HordRicJr/Akomagni/tree/main/bmad-core/.agents/skills/bmad-checkpoint-preview
Command: npx skills add https://github.com/HordRicJr/Akomagni --skill bmad-checkpoint-preview-hordricjr

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Reviewing a code change without structure leads to missed risks and shallow approvals. This Skill turns a diff, commit, branch, or PR into a guided human-in-the-loop review, walking the reviewer from intent and orientation through design walkthrough, risk surfacing, and hands-on verification before a final decision. ## Core Features & Use Cases - Orientation and Intent Summary: Identifies the change from conversation context, sprint status, or git state, then presents intent and surface-area stats (files changed, modules touched, boundary crossings, new public interfaces). - Concern-Based Walkthrough: Organizes the change by design concerns with clickable path:line stops, generating a review trail from the diff when no author-produced trail exists. - Risk and Testing Passes: Surfaces high-blast-radius spots tagged by category (auth, schema, billing, security, infra) and suggests concrete manual observations of changed behavior. - Use Case: A developer finishes a feature branch and says "walk me through this change" — the Skill locates the branch, summarizes intent, guides the reviewer through key code locations, flags risky spots, and ends with an approve/rework/discuss decision. ## Quick Start Ask the assistant to walk you through the current branch or a specific commit as a checkpoint 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 review by referencing a commit, branch, PR, or spec file. The workflow identifies the change, summarizes its intent and surface area, then walks you through concerns, risk spots, and testing suggestions before you decide to approve or request rework.

How does the review walkthrough organize a large diff?

It groups changes by design concern rather than by file, selecting 2-5 cohesive intents with clickable path:line stops ordered for comprehension. If no author-produced review trail exists, it generates one from the diff automatically.

Can it review a pull request from GitHub?

Yes. Pass a PR reference and it resolves it 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 that is a visible action.

What happens if git is unavailable during the review?

If the diff cannot be retrieved, trail generation fails gracefully and the workflow falls back to a non-trail path. Surface-area stats are skipped with a note rather than guessed.

What kinds of risks does the detail pass detect?

It scans the diff for risk-sensitive patterns tagged as auth, public API, schema, billing, infra, security, or config, then sequences the top spots by blast radius. It does not assign severity scores and states explicitly when no high-risk spots exist.