bmad-checkpoint-preview

Guide human reviewers through structured code change walkthroughs with risk-focused checks.

Updated May 17, 2026
One-click install
npx skills add https://github.com/thuantan2060/facebook-sale-tracking --skill bmad-checkpoint-preview-thuantan2060
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: bmad-checkpoint-preview
Source: https://github.com/thuantan2060/facebook-sale-tracking/tree/main/.agents/skills/bmad-checkpoint-preview
Command: npx skills add https://github.com/thuantan2060/facebook-sale-tracking --skill bmad-checkpoint-preview-thuantan2060

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

It helps you quickly understand what a change is trying to do and where to focus your attention during human review, especially when you see the term "checkpoint" or need a walkthrough of the change.

Core Features & Use Cases

  • Guided review workflow: Orchestrates orientation, walkthrough, detail pass, and testing guidance for a human reviewer.
  • Diff and context-driven guidance: Uses a generated review trail when available, then structures the walkthrough and risk spots around design intent rather than file-by-file reading.
  • Configurable persistence and customization: Loads persistent facts and workflow configuration (including language and artifact inputs) before executing the steps.
  • Risk-focused review: Surfaces high-bite-risk areas like auth, public API, schema, billing, security, and infra changes to guide what to scrutinize.

Quick Start

Ask your AI to review the change and walk you through the checkpoint for human 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 perform a human-in-the-loop code review for a checkpoint?

A human-in-the-loop code review for a checkpoint requires a structured walkthrough that combines intent, git diff context, and configuration into an actionable review order. The process guides you through orientation, detail passes, and testing steps.

What is a risk-focused code walkthrough?

A risk-focused code walkthrough structures your human review around design intent rather than reading files sequentially. It surfaces high-bite-risk areas like auth, public API, schema, billing, security, and infra changes to guide what to scrutinize.

How do I validate a git diff during a checkpoint review?

To validate a git diff during a checkpoint review, the system loads persistent facts and workflow configuration, then generates an actionable review order. This produces orientation, walkthrough, detail pass, and testing steps with path:line callouts.

Does this guided review process support custom workflow configuration?

Yes, the guided review process supports custom workflow configuration. It runs workflow customization resolution and loads persistent facts and language inputs before executing the orientation, walkthrough, and testing guidance steps.

When do I need a checkpoint review for my code changes?

You need a checkpoint review when you must quickly understand what a code change is trying to do and where to focus your attention during human validation, especially when dealing with complex risk areas like schema or security modifications.

What are the limitations of using an LLM-assisted review for checkpoints?

An LLM-assisted review for checkpoints requires YAML frontmatter-defined discovery metadata to function. It relies on a generated review trail when available, meaning its guidance is limited by the provided diff context and configuration inputs.