spec-validation

Validate specification implementation in a codebase with file:line evidence.

Updated Apr 10, 2026
One-click install
npx skills add https://github.com/DiologIR/diolog-plugins --skill spec-validation-diologir
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: spec-validation
Source: https://github.com/DiologIR/diolog-plugins/tree/main/plugins/spec-validation/skills/spec-validation
Command: npx skills add https://github.com/DiologIR/diolog-plugins --skill spec-validation-diologir

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

This Skill addresses the challenge of confirming that a specification, build plan, or Definition of Done is actually implemented in a codebase, not just rendered or passing tests.

Core Features & Use Cases

  • Validation of Implementation: Verifies that a feature or app is genuinely implemented, not just rendered or passing tests.
  • Data Provenance Audit: Classifies every claimed-done field as REAL, AUTHORED, or MOCK with file:line evidence.
  • Living Gap Report: Generates a ranked, living gap report that documents the validation process and results.

Quick Start

Use the spec-validation skill to audit the implementation of a feature in the 'main' branch by providing the specification document and the codebase path.

Frequently Asked Questions about spec-validation

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

FAQPage Schema
How do I verify that a specification is genuinely implemented in a codebase?

Data provenance tracking classifies every claimed-done field in a codebase as REAL, AUTHORED, or MOCK. It provides file:line evidence for each classification, ensuring that features are genuinely implemented rather than just rendered or using mocked data.

Can I audit my codebase for mocked data instead of real implementation?

Yes, you can audit a codebase to detect mocked data by validating the implementation against the specification document. This defect detection process confirms whether claimed-done features are genuinely implemented and generates a living gap report documenting the findings.

What do I need to provide to run a codebase audit for implementation verification?

Implementation verification requires access to the target codebase and the corresponding specification document. You provide the path to the codebase branch and the specification to initiate the validation process and generate the gap report.

Does specification validation work differently from running standard automated tests?

Specification validation goes beyond standard automated tests by confirming that a feature is genuinely implemented, not just passing tests. It audits data provenance to classify fields as REAL, AUTHORED, or MOCK, providing deeper evidence-based verification of the actual implementation.

What is a living gap report for implementation verification?

A living gap report is the output of specification validation that ranks and documents the verification results. It details the validation process, classifies claimed-done fields, and provides evidence-based proof of whether features are genuinely implemented in the codebase.