planning-validate

Validate planning artifacts for structure, consistency, and governance compliance.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

Planning artifacts (spec.md, plan.md, data-model.md, contracts/) often drift apart, causing misalignment, incomplete requirements, and blockers for task generation. planning-validate automates a quality gate to detect gaps and enforce consistency after /speckit.plan completes.

Core Features & Use Cases

  • Automated artifact validation: checks spec.md, plan.md, data-model.md, and contracts/ for presence, structure, and cross-artifact consistency.
  • Constitution and governance checks: verifies alignment with project constitution and gate results to ensure compliant planning.
  • Actionable output: reports GREEN/YELLOW/RED statuses with blockers and recommendations to unblock progression.

Quick Start

Run planning-validate after you complete /speckit.plan to automatically assess your planning artifacts and surface issues before task generation.

Frequently Asked Questions about planning-validate

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

FAQPage Schema
How do I validate planning artifacts for consistency and completeness?

Automated validation checks spec.md, plan.md, data-model.md, and contracts/ for presence and cross-artifact consistency. It enforces required sections and constitutional references to detect gaps and prevent misalignment before task generation.

What is automated planning artifact quality assurance and when do I need it?

Automated planning artifact quality assurance is a governance gate that detects gaps and enforces consistency across spec.md, plan.md, and contracts. You need it when artifacts drift apart, causing incomplete requirements and blockers for task generation.

How do I run planning validation after generating feature specifications?

Run the validation skill immediately after completing /speckit.plan across your feature directories. It automatically assesses planning artifacts, enforcing required sections, constitutional references, and gate results to produce structured status reports.

Can I use planning validation to enforce constitutional references and governance gates?

Yes, planning validation verifies alignment with project constitution and gate results to ensure compliant planning. It enforces required sections, constitutional references, and gate results across all feature directories to maintain governance standards.

What do GREEN, YELLOW, and RED statuses mean in planning artifact validation results?

Validation produces structured GREEN, YELLOW, or RED statuses with blockers and recommendations to unblock progression. These statuses indicate whether your spec.md, plan.md, data-model.md, and contracts/ meet quality, completeness, and consistency requirements.

Why does planning validation fail when my spec.md and plan.md are inconsistent?

Planning validation fails on inconsistent spec.md and plan.md files because it enforces cross-artifact integrity. When artifacts drift apart, the validation detects misalignment, incomplete requirements, and missing sections, reporting them as blockers to unblock progression.