Agent skill

doc-utest-validator

Validate Unit Test Specifications (UTEST) against Layer 10 UTEST MVP schema and structure contracts

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-utest-validator

Metadata

Additional technical details for this skill

tags
sdd-workflow layer-10-artifact quality-assurance utest
custom fields 
{
    "layer": 10,
    "version": "1.0",
    "priority": "shared",
    "last_updated": "2026-02-27",
    "artifact_type": "UTEST",
    "skill_category": "quality-assurance",
    "development_status": "active",
    "upstream_artifacts": [
        "UTEST"
    ],
    "downstream_artifacts": [
        "Audit",
        "Fix"
    ],
    "architecture_approaches": [
        "ai-agent-based",
        "traditional-8layer"
    ]
}
versioning policy
tracks UTEST_MVP_SCHEMA schema_version

SKILL.md

doc-utest-validator

Purpose

Validate UTEST documents for subtype-specific schema, structure, traceability, and unit-test gate requirements.

Validation Schema Reference

  • ai_dev_ssd_flow/10_TSPEC/UTEST/UTEST_MVP_SCHEMA.yaml
  • ai_dev_ssd_flow/10_TSPEC/UTEST/UTEST-MVP-TEMPLATE.md
  • ai_dev_ssd_flow/10_TSPEC/UTEST/UTEST_MVP_SCHEMA.yaml

Validation Checklist

  1. Nested folder rule (UTEST-NN_{slug}/UTEST-NN_{slug}.md)
  2. Six required sections present and ordered
  3. UTEST element IDs use TSPEC.NN.40.SS
  4. Required cumulative tags present (@brd..@spec, optional @ctr)
  5. Required subtype tags present (@req, @spec)
  6. TASKS-Ready score markers are present (Target: >=90%)
  7. REQ coverage markers are present (Coverage: >=90%)
  8. Test categories include [Logic], [State], [Validation], [Edge]
  9. Input/Output table requirement is satisfied for test cases
  10. Pseudocode guidance exists for complex test logic

Commands

bash
python ai_dev_ssd_flow/10_TSPEC/scripts/validate_utest.py docs/10_TSPEC/UTEST/
bash ai_dev_ssd_flow/10_TSPEC/scripts/validate_all_tspec.sh docs/10_TSPEC/
bash ai_dev_ssd_flow/10_TSPEC/scripts/validate_tspec_quality_score.sh docs/10_TSPEC/
python ai_dev_ssd_flow/scripts/validate_cross_document.py --document docs/10_TSPEC/UTEST/UTEST-NN_slug/UTEST-NN_slug.md --auto-fix
python ai_dev_ssd_flow/scripts/validate_tags_against_docs.py --artifact UTEST-NN --expected-layers brd,prd,ears,bdd,adr,sys,req,spec --strict

Integration

  • Invoked by: doc-utest, doc-utest-autopilot, doc-utest-audit
  • Feeds into: doc-utest-audit, doc-utest-fixer

Version History

Version Date Changes
1.0 2026-02-27 Initial UTEST validator with schema/structure/tag checks and unit-test 90% gate validation rules

Implementation Plan Consistency (IPLAN-004)

  • Treat plan-derived outputs as valid source mode and verify intent preservation from implementation plan scope/objectives.
  • Validate upstream autopilot precedence assumption: --iplan > --ref > --prompt.
  • Flag objective/scope conflicts between plan context and artifact output as blocking issues requiring clarification.
  • Do not introduce legacy fallback paths such as docs-v2.0/00_REF.

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