spec-validation

Validate cross-file consistency across phased project specification documents.

Updated Aug 27, 2026
One-click install
npx skills add https://github.com/MaxGiu67/plugin-MUCC --skill spec-validation-maxgiu67
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: spec-validation
Source: https://github.com/MaxGiu67/plugin-MUCC/tree/main/dev-methodology/skills/spec-validation
Command: npx skills add https://github.com/MaxGiu67/plugin-MUCC --skill spec-validation-maxgiu67

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

Prevents misalignment and missing artifacts across phased project specifications by verifying that vision, PRD, user stories, tech specs, sprint plans, and test cases are present and cross-referenced before handoffs and phase transitions.

Core Features & Use Cases

  • File existence checks: Confirms required spec files for completed phases exist and are non-empty.
  • PRD → Stories mapping: Verifies every PRD Feature has associated User Stories and flags orphaned stories.
  • Stories → Tech Spec & Sprint mapping: Ensures Must Have stories have corresponding tech spec sections, are assigned to sprints, and that story point totals respect velocity constraints.
  • AC → Test Cases tracing: Checks each acceptance criterion has linked test cases and identifies orphaned tests.
  • Reporting & recommendations: Produces a structured SPEC VALIDATION REPORT with warnings and prioritized fixes for missing specs, tests, and sprint overloads.
  • Use case: Run before a phase handoff to ensure all PRD features are covered by stories, tech specs exist for Must Have items, and all ACs have test coverage.

Quick Start

Run the spec validation for the project and return a SPEC VALIDATION REPORT summarizing missing files, orphaned references, and recommended fixes.

Frequently Asked Questions about spec-validation

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

FAQPage Schema
How do I validate cross-file consistency across project specification documents?

To validate cross-file consistency across project specification documents, you can use a validation process that checks file existence and cross-references across vision, PRD, user stories, tech specs, sprint plans, and test cases to detect missing or orphaned references during handoffs.

What is the best way to map PRD features to user stories and detect orphaned references?

Mapping PRD features to user stories involves verifying every PRD feature has associated user stories and flagging orphaned stories. This ensures traceability and prevents missing artifacts before phase transitions in software development workflows.

How do I trace acceptance criteria to test cases and identify orphaned tests?

Tracing acceptance criteria to test cases requires checking that each acceptance criterion has linked test cases. This process identifies orphaned tests and ensures complete coverage before generating a structured validation report.

Can I check MoSCoW priorities and story point totals against sprint velocity constraints?

Yes, you can check MoSCoW priorities and story point totals against sprint velocity constraints. This ensures Must Have stories have corresponding tech spec sections, are assigned to sprints, and respect velocity limitations.

When do I need to run spec validation for phase handoffs?

You need to run spec validation for phase handoffs when transitioning between project phases to ensure all PRD features are covered by stories, tech specs exist for Must Have items, and all acceptance criteria have test coverage.

Does the spec validation process work without external dependencies?

Yes, the spec validation process works without external dependencies. It operates using internal scripts to perform file existence checks, cross-reference mapping, and generate a structured validation report with warnings and prioritized fixes.