phase-checkpoint

Execute and validate Phase Checkpoint criteria from EXECUTION_PLAN.md.

39|5|Updated Dec 28, 2025
One-click install
npx skills add https://github.com/benjaminshoemaker/ai_coding_project_base --skill phase-checkpoint
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: phase-checkpoint
Source: https://github.com/benjaminshoemaker/ai_coding_project_base/tree/main/.claude/skills/phase-checkpoint
Command: npx skills add https://github.com/benjaminshoemaker/ai_coding_project_base --skill phase-checkpoint

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill automates the validation of a completed project phase by executing the Phase Checkpoint criteria described in EXECUTION_PLAN.md, ensuring all required checks are satisfied before advancing.

Core Features & Use Cases

  • Automated phase integrity checks: collects and runs the required tests, linting, type checks, security scans, and manual verifications defined in EXECUTION_PLAN.md.
  • Auto-advance readiness: determines whether a phase can move to the next step and optionally triggers the next phase.
  • Context-aware guidance: reads project configuration to tailor verification steps for greenfield or feature phases.

Quick Start

After finishing a phase, execute /phase-checkpoint <phase-number> to validate all acceptance criteria from EXECUTION_PLAN.md.

Frequently Asked Questions about phase-checkpoint

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

FAQPage Schema
How do I automate phase verification and quality gates before advancing a project?

Automate phase verification by executing the Phase Checkpoint criteria defined in EXECUTION_PLAN.md to run required tests, linting, security scans, and production checks before advancing. This ensures all acceptance criteria are satisfied automatically.

What is a phase checkpoint in software execution plans?

A phase checkpoint is an automated validation step that verifies all required tests, lint, type checks, security scans, and manual verifications are completed in a project phase before moving to the next step. It enforces quality gates defined in EXECUTION_PLAN.md.

Do I need a verification configuration file to run phase checkpoints?

Yes, phase checkpoint verification requires a local configuration file at .claude/verification-config.json along with the EXECUTION_PLAN.md file. These files determine the specific checks to run for greenfield or feature phases.

How do I validate acceptance criteria after completing a project phase?

Validate acceptance criteria by running the phase checkpoint command with the specific phase number to execute all required tests, linting, type checks, and security scans defined in the execution plan. It confirms readiness to advance.

Can phase checkpoints automatically trigger the next phase in a project?

Yes, phase checkpoints determine auto-advance readiness by validating all acceptance criteria and optionally triggering the next phase. It reads project configuration to tailor verification steps for greenfield or feature contexts.

Why does phase checkpoint verification fail to advance my project?

Phase checkpoint verification fails when required tests, lint, type checks, security scans, or manual verifications defined in EXECUTION_PLAN.md are not completed. Ensure .claude/verification-config.json is present and all criteria pass before advancing.