skills.rest
getdatasurge
getdatasurgeCOMMUNITY
Explore all skills by this author →
WebsiteGitHub

GSD Plan Checker

Evaluate ROADMAP.md, REQUIREMENTS.md, and PLAN.md frontmatters for coverage and dependency issues.

Updated Jan 24, 2026
Search Tags:#automation#workflow#planning#dependencies#plan#quality-assurance#planning-validation
One-click install
npx skills add https://github.com/getdatasurge/fresh-staged --skill gsd-plan-checker
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: GSD Plan Checker
Source: https://github.com/getdatasurge/fresh-staged/tree/main/.agent/skills/plan-checker
Command: npx skills add https://github.com/getdatasurge/fresh-staged --skill gsd-plan-checker

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Plans often lack comprehensive coverage, have gaps in task mapping, or contain invalid dependencies, leading to execution failures. The GSD Plan Checker detects these issues early so teams can correct plans before they run.

Core Features & Use Cases

  • Validate plan readiness by cross-referencing ROADMAP.md, REQUIREMENTS.md, and PLAN.md frontmatter.
  • Identify coverage gaps where phase goals lack corresponding tasks and flag ambiguous or duplicate mappings.
  • Verify task completeness across files, actions, verification steps, and acceptance criteria.
  • Check dependency graphs for cycles, missing references, or future references to ensure safe parallelization.
  • Ensure that artifacts are wired together (e.g., components, APIs, and data flows) rather than created in isolation.
  • Enforce scope sanity by guarding plan size and complexity to stay within context budgets.
  • Provide structured issue reports with actionable fixes for blockers and warnings.

Quick Start

Run the plan checker after you finish planning to verify all six dimensions before executing the plan.

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 plan dependencies and coverage before execution?▼

Plan validation cross-references ROADMAP.md, REQUIREMENTS.md, and PLAN.md frontmatters to detect coverage gaps, missing tasks, and invalid dependency cycles before execution begins.

What is planning validation for task structure and dependency graphs?▼

Planning validation applies deterministic checks to frontmatter fields, task completeness, and dependency graphs to ensure phase goals map to actionable tasks and safe parallelization.

How do I check for dependency cycles and missing references in a project plan?▼

Dependency graph checks identify cycles, missing references, and future references within PLAN.md to ensure safe parallelization and prevent execution blockers during task automation.

When do I need to run planning quality assurance checks on my markdown plans?▼

Run planning quality assurance after finishing your plan to verify coverage, completeness, dependencies, artifact wiring, and scope sanity across all phases before moving to execution.

Does plan validation work with ROADMAP.md and REQUIREMENTS.md frontmatter?▼

Yes, the validator cross-references ROADMAP.md, REQUIREMENTS.md, and PLAN.md frontmatters to flag ambiguous mappings, verify task completeness, and ensure artifacts are wired together correctly.

What are the limitations of automated plan validation for scope sanity?▼

Automated plan validation guards plan size and complexity to stay within context budgets, but it requires properly structured frontmatter in ROADMAP.md, REQUIREMENTS.md, and PLAN.md to function.

Related Skills

Explore More Software Engineering Skills→
alo-expalo-exp
6

gsd-plan

Generate PLAN.md from ROADMAP.md and REQUIREMENTS.md with verification steps.

Official
Advanced
timbuchingertimbuchinger
1

executing-plans

Execute implementation plan tasks in batches with review checkpoints.

Community
Basic
frizynnfrizynn
16

dag-planner

Analyze task dependency graphs to detect cycles and determine execution order.

Community
Basic
aaddrickaaddrick
5.3k

lint

Lint shell scripts with shellcheck and GitHub Actions workflows with actionlint.

Community
Basic