Agent skill

doc-cspec-validator

Validate Code Specifications (CSPEC) documents against Layer 9.50 schema standards

View SKILL.md on GitHub Repository
Stars 10
Forks 3

Install this agent skill to your Project

npx add-skill https://github.com/vladm3105/aidoc-flow-framework/tree/main/.claude/skills/doc-cspec-validator

Metadata

Additional technical details for this skill

tags
sdd-workflow layer-9-artifact cspec-artifact quality-assurance
custom fields 
{
    "layer": 9,
    "version": "1.0",
    "priority": "shared",
    "last_updated": "2026-03-01",
    "subtype_code": 50,
    "artifact_type": "CSPEC",
    "skill_category": "quality-assurance",
    "deliverable_type": "code",
    "development_status": "active",
    "upstream_artifacts": [
        "CSPEC"
    ],
    "downstream_artifacts": [],
    "architecture_approaches": [
        "ai-agent-based",
        "traditional-8layer"
    ]
}

SKILL.md

doc-cspec-validator

Validate Code Specifications (CSPEC) documents against Layer 9.50 schema standards.

Activation

Invoke when user requests validation of CSPEC documents or after creating/modifying CSPEC artifacts.

Validation Schema Reference

  • Schema: ai_dev_ssd_flow/09_SPEC/CSPEC/CSPEC_MVP_SCHEMA.yaml
  • Layer: 9.50
  • Artifact Type: CSPEC
  • Deliverable Type: code

Validation Checklist

0. Folder Structure Validation (BLOCKING)

Required Structure:

CSPEC Type Required Location
YAML docs/09_SPEC/CSPEC/CSPEC-NN_{slug}/CSPEC-NN_{slug}.yaml

1. Metadata Validation

Field Required Valid Values
document_type Yes cspec-document
artifact_type Yes CSPEC
deliverable_type Yes code
subtype_code Yes 50
layer Yes 9

2. CTR Compliance (MANDATORY for CSPEC)

CSPEC requires CTR contract:

  • CTR reference exists in traceability
  • Interface definitions match CTR schema
  • API contracts are implemented

3. Interface Definitions

  • All interfaces have complete signatures
  • Parameter types are specified
  • Return types are specified
  • Error handling is defined

4. Implementation Details

  • Classes/modules are specified
  • Methods have algorithms defined
  • Dependencies are listed
  • Configuration is documented

5. Test Mapping

  • Unit test cases mapped to methods
  • Integration test cases mapped to interfaces
  • Coverage requirements specified

6. Traceability

Required cumulative tags:

  • @brd, @prd, @ears, @bdd, @adr, @sys, @req, @ctr

7. CODE-Ready Score

Component Weight Minimum
Interface Completeness 20% 100%
CTR Compliance 20% 100%
Algorithm Specification 15% 90%
Error Handling 15% 90%
Test Mapping 15% 90%
Traceability 15% 100%

Target: CODE-Ready ≥90%

Validation Commands

bash
# Validate single CSPEC
python ai_dev_ssd_flow/09_SPEC/scripts/validate_spec.py \
  --spec-file docs/09_SPEC/CSPEC/CSPEC-NN_{slug}/CSPEC-NN_{slug}.yaml \
  --subtype CSPEC

# Validate all CSPECs
python ai_dev_ssd_flow/09_SPEC/scripts/validate_spec.py \
  --directory docs/09_SPEC/CSPEC \
  --subtype CSPEC

Error Codes

Code Severity Description
CSPEC-E001 Error Missing CTR reference
CSPEC-E002 Error Incomplete interface definition
CSPEC-E003 Error Missing algorithm specification
CSPEC-W001 Warning Test mapping incomplete
CSPEC-W002 Warning CODE-Ready score below threshold

References

  • Schema: ai_dev_ssd_flow/09_SPEC/CSPEC/CSPEC_MVP_SCHEMA.yaml
  • Validation Rules: ai_dev_ssd_flow/09_SPEC/CSPEC/CSPEC_MVP_SCHEMA.yaml

Recommended Agent Skills

Expand your agent's capabilities with these related and highly-rated skills.

vladm3105/aidoc-flow-framework

doc-spec-reviewer

Comprehensive content review and quality assurance for SPEC documents - validates YAML structure, REQ coverage, interface definitions, and identifies issues requiring manual attention

10 3
Explore
vladm3105/aidoc-flow-framework

doc-prd-fixer

Automated fix skill that reads review reports and applies fixes to PRD documents - handles broken links, element IDs, missing files, and iterative improvement

10 3
Explore
vladm3105/aidoc-flow-framework

doc-procspec-autopilot

Automated PROCSPEC (Process Specification) generation from REQ - generates specifications for SOPs, runbooks, playbooks, and operational procedures

10 3
Explore
vladm3105/aidoc-flow-framework

doc-riskspec-autopilot

Automated RISKSPEC (Risk Specification) generation from REQ - generates specifications for risk matrices, impact assessments, and mitigation plans

10 3
Explore
vladm3105/aidoc-flow-framework

doc-ptest-autopilot

Automated PTEST generation and review orchestration for performance category and threshold validation

10 3
Explore
vladm3105/aidoc-flow-framework

doc-adr-autopilot

Automated ADR generation pipeline from BRD Architecture Decision Requirements - analyzes topics, generates Context-Decision-Consequences records

10 3
Explore

Didn't find tool you were looking for?

Be as detailed as possible for better results