validate-specs

Cross-validates BRD and PRD documents for coverage gaps, contradictions, and technical feasibility.

4|Updated Mar 14, 2026
One-click install
npx skills add https://github.com/VoxTechnologies/transmute-framework --skill validate-specs-voxtechnologies
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: validate-specs
Source: https://github.com/VoxTechnologies/transmute-framework/tree/main/skills/validate-specs
Command: npx skills add https://github.com/VoxTechnologies/transmute-framework --skill validate-specs-voxtechnologies

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Business Requirements Documents and Product Requirements Documents are often generated in separate sessions, causing terminology drift, missing requirement coverage, broken cross-references, and untestable acceptance criteria that become expensive bugs once code is written. This Skill catches those specification errors before they propagate into implementation. ## Core Features & Use Cases - Requirements Traceability: Builds a forward and reverse traceability matrix mapping every BRD functional requirement (FR-xxx) to PRD user stories, screen specs, and API specs, flagging coverage gaps and orphan stories. - Consistency & Quality Validation: Three parallel validation teammates check terminology, data models, user flows, API-to-screen alignment, acceptance criteria testability, and technical feasibility against the chosen tech stack. - Automated Fixing & Gate Decision: Fixes CRITICAL and HIGH severity issues directly in the BRD/PRD files, then produces a health-scored report with a PASS / CONDITIONAL PASS / FAIL gate decision for Stage 2B of the Transmute pipeline. - Use Case: After generating a BRD and PRD for a new SaaS product, run Stage 2B to discover that three P0 requirements lack API specs and that the PRD weakened a quantified uptime target — then have those issues fixed in place before scaffolding begins. ## Quick Start Ask the agent to validate specs and cross-check the BRD and PRD in the plancasting directory for coverage gaps and contradictions.

Frequently Asked Questions about validate-specs

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

FAQPage Schema
How do I validate that a PRD covers all BRD requirements?

Run spec validation to build a requirements traceability matrix mapping every BRD functional requirement to PRD user stories, screen specs, and API specs. Any requirement missing one of these artifacts is flagged as a coverage gap with a severity classification.

What does the Stage 2B gate decision check?

The gate evaluates blocking rules first: unresolved CRITICAL issues, unreviewed BRD assumption volume above 30%, P0 feature coverage below 95%, and overall coverage below 90% all cause FAIL. If those pass, severity counts determine PASS or CONDITIONAL PASS.

What prerequisites are required before running spec validation?

The plancasting/brd and plancasting/prd directories must exist with markdown files from Stages 1 and 2, and plancasting/tech-stack.md from Stage 0 must exist for feasibility checks. Missing prerequisites stop execution with a message identifying which stage to run first.

Does spec validation modify the BRD and PRD files?

Yes, it fixes CRITICAL and HIGH severity issues directly in the source files, marking each fix with a dated VALIDATED annotation. It never adds new features — it only closes gaps for existing requirements and re-validates affected cross-references after each fix.

What happens when the BRD and PRD are too large to validate at once?

For exceptionally large products exceeding the context window, validation is split by feature group instead of cross-cutting concern. The lead then performs cross-feature consistency checks manually in the final phase using the unified issue list from all teammates.