governance-spec-validator

Compare implemented code against approved SPEC JSON and generate a Markdown Validation Report.

Updated Jan 6, 2026
One-click install
npx skills add https://github.com/cslsoftwares/ParamentersORM --skill governance-spec-validator
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: governance-spec-validator
Source: https://github.com/cslsoftwares/ParamentersORM/tree/main/.cursor/skills/governance-spec-validator_V1.0.0
Command: npx skills add https://github.com/cslsoftwares/ParamentersORM --skill governance-spec-validator

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This tool verifies that the implemented code aligns with the approved SPEC, generating a conformity report that shows the percentage of features implemented, acceptance criteria met vs. pending, and edge cases covered.

Core Features & Use Cases

  • Compare implemented features against the approved SPEC to surface gaps.
  • Generate a structured Validation Report with overall conformity percentage and per-item status.
  • Cross-check acceptance criteria and edge cases against the codebase to guide reviews and merges.

Quick Start

Run the governance-spec-validator against the approved SPEC and the codebase to generate a conformity validation report.

Frequently Asked Questions about governance-spec-validator

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

FAQPage Schema
How do I validate code conformance against an approved SPEC?

To validate code conformance against an approved SPEC, the tool reads the SPEC JSON, scans relevant source files, and outputs a Markdown Validation Report detailing the implemented feature percentage and pending acceptance criteria.

What is the best way to check release readiness for acceptance criteria and edge cases?

Checking release readiness involves cross-checking acceptance criteria and edge cases against the codebase to compute a conformity score, guiding pre-merge gates and sprint-end validations with a structured status report.

Can I generate a conformity validation report for a specific sprint?

Yes, you can generate a conformity validation report for sprint-end validations by comparing implemented features against the approved SPEC to surface gaps and verify overall release readiness.

How does spec conformance validation handle edge cases in the codebase?

Spec conformance validation handles edge cases by cross-checking them against the codebase to determine gaps, calculating a conformity score that reflects the percentage of edge cases covered versus pending.

Does this validation tool require a specific format for the approved SPEC?

The validation tool requires the approved SPEC to be in JSON format to accurately scan relevant source files, compute the conformity score, and output the structured Markdown Validation Report.

What limitations exist when validating spec conformance before a merge?

A limitation of validating spec conformance pre-merge is that it strictly relies on the approved SPEC JSON and source file scanning to identify gaps, meaning incomplete SPEC definitions will directly impact the conformity score accuracy.