GSD Plan Checker

Validate PLAN.md and ROADMAP.md files for completeness and dependency correctness.

Updated Aug 7, 2025
One-click install
npx skills add https://github.com/hGriff0n/velopitt --skill gsd-plan-checker-hgriff0n
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: GSD Plan Checker
Source: https://github.com/hGriff0n/velopitt/tree/main/.agent/skills/plan-checker
Command: npx skills add https://github.com/hGriff0n/velopitt --skill gsd-plan-checker-hgriff0n

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Validates planning artifacts to prevent execution failures by ensuring plans are complete, coherent, and properly linked.

Core Features & Use Cases

  • Dimension-based validation of plan files (coverage, completeness, dependencies, and artifact links).
  • Early detection of gaps between goals, requirements, and tasks for reliable planning.
  • Example use-case: after creating ROADMAP.md and PLAN.md, run the checker to surface issues before execution.

Quick Start

Run the plan-checker after planning to validate all PLAN.md files against the defined dimensions.

Frequently Asked Questions about GSD Plan Checker

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

FAQPage Schema
How do I validate a PLAN.md file before execution?

To validate a PLAN.md file, run the plan-checker to verify requirement coverage, task completeness, dependency correctness, and cross-link integrity across all defined project dimensions. It surfaces gaps between goals and tasks to prevent execution failures.

What is plan validation and when do I need it?

Plan validation is the process of checking planning artifacts for completeness, coherence, and proper linking before execution. You need it after creating ROADMAP.md and PLAN.md files to catch quality problems and ensure all requirements are properly covered.

Can I check task dependencies and cross-links in ROADMAP.md documents?

Yes, the plan-checker validates both ROADMAP.md and PLAN.md documents across all project phases. It checks dependency correctness and cross-link integrity while ensuring frontmatter includes phase, plan, wave, depends_on, and must_haves fields.

How do I verify that plan tasks include all required dimensions?

Verify plan tasks by running the checker to ensure each task lists the Files, Action, Verify, and Done dimensions. This validation guarantees task completeness and confirms that frontmatter contains the required phase and dependency metadata.

What are common issues caught when validating planning artifacts?

Common issues caught include missing frontmatter fields like phase, plan, wave, depends_on, and must_haves, incomplete task dimensions lacking Files, Action, Verify, or Done, and incorrect dependencies or broken cross-links between requirements and tasks.

Do I need specific dependencies to check PLAN.md files for execution failures?

No dependencies are required to check PLAN.md files for execution failures. The plan-checker operates independently to validate requirement coverage, task completeness, dependency correctness, and cross-link integrity across your planning artifacts.