validate-plan

Validate an implementation against its plan by running verification commands and reporting deviations.

1|1|Updated Feb 2, 2026
One-click install
npx skills add https://github.com/corticalstack/flow --skill validate-plan-corticalstack
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: validate-plan
Source: https://github.com/corticalstack/flow/tree/main/.claude/skills/validate-plan
Command: npx skills add https://github.com/corticalstack/flow --skill validate-plan-corticalstack

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? After implementing a plan, teams often commit code without confirming it actually matches the plan's success criteria, leading to regressions and incomplete features slipping into the codebase. This Skill acts as a quality gate that systematically verifies implementation correctness before any commit. ## Core Features & Use Cases - Plan-to-Code Comparison: Reads the implementation plan, identifies expected file changes and success criteria, then compares actual git diffs against the specification phase by phase. - Automated Verification Execution: Runs the test, build, and lint commands defined in the plan's Automated Verification section and documents pass/fail results. - Structured Validation Report: Produces a markdown report covering implementation status, deviations, potential issues, manual testing steps, and recommendations, then updates the work-item tracker state. - Use Case: After running /implement-plan on a feature branch, invoke /validate-plan to catch a missing database index and failing lint checks before creating commits, keeping git history clean. ## Quick Start Ask the agent to validate the current uncommitted implementation against the plan file at flow/plans/my-feature.md using /validate-plan.

Frequently Asked Questions about validate-plan

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

FAQPage Schema
How do I validate an implementation against a plan before committing?▼

Invoke /validate-plan with the plan file path, or let it discover the plan from recent commits. It runs the plan's automated verification commands, compares git diffs to planned changes, and produces a validation report with pass/fail status per phase.

What does the validate-plan skill check during validation?▼

It verifies all plan phases are actually complete, runs automated tests and lint commands, checks code follows existing patterns, looks for regressions and missing error handling, and lists manual testing steps for UI or integration behavior.

Should I run validation before or after committing changes?▼

Run it on uncommitted changes, after /implement-plan and before /commit. This keeps git history clean by catching issues early instead of adding fix-up commits later.

What happens when validation fails?▼

The report documents each failure with the exact command run and root cause analysis, and the work-item tracker state is set to validation-failed. You fix the issues and re-run validation before proceeding to commit and PR creation.

Can validate-plan work without a plan file path?▼

Yes. If no path is provided, it searches recent commits for plan references or asks the user, then gathers implementation evidence through git log and git diff analysis of the session's changes.