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

When to Use

Use doc-utest when:

You are creating or editing UTEST-only artifacts.
@req and @spec mappings are primary.
Component-level logic, state, validation, and edge-case checks are the core objective.

Use doc-tspec instead when:

Multi-subtype orchestration is required (UTEST/ITEST/STEST/FTEST/PTEST/SECTEST).
Cross-subtype normalization or batch TSPEC work is primary.

UTEST Contract (MVP)

Required Structure

UTEST follows a 6-section contract:

Document Control
Test Scope
Test Case Index
Test Case Details
REQ Coverage Matrix
Traceability

Required Tags

Cumulative Layer-10 tags: @brd, @prd, @ears, @bdd, @adr, @sys, @req, @spec (+ @ctr if exists)
UTEST-specific required tags: @req, @spec

Unit-Test Gate Requirements

TASKS-Ready score target must be >=90%.
REQ coverage target must be >=90%.
Test categories must include [Logic], [State], [Validation], [Edge].
Every test case must include an Input/Output table.
Complex test logic must include pseudocode.

Folder Rule

Use nested folder structure:

docs/10_TSPEC/UTEST/UTEST-NN_{slug}/UTEST-NN_{slug}.md

Validation Commands

# UTEST subtype validation
python ai_dev_ssd_flow/10_TSPEC/scripts/validate_utest.py docs/10_TSPEC/UTEST/

# Layer-wide TSPEC validation
bash ai_dev_ssd_flow/10_TSPEC/scripts/validate_all_tspec.sh docs/10_TSPEC/

# Quality score validation
bash ai_dev_ssd_flow/10_TSPEC/scripts/validate_tspec_quality_score.sh docs/10_TSPEC/

# Cross-document validation
python ai_dev_ssd_flow/scripts/validate_cross_document.py --document docs/10_TSPEC/UTEST/UTEST-NN_slug/UTEST-NN_slug.md --auto-fix

# Cumulative tag validation
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

Output Quality Gate

No schema/structure blockers.
All required UTEST sections present.
@req and @spec mappings are explicit.
REQ coverage and TASKS-ready scores meet >=90% target.
[Logic], [State], [Validation], [Edge] categories are represented.
Input/Output tables and pseudocode guidance are present where required.
Report references use versioned naming where applicable.

Related Skills

doc-utest-autopilot
doc-utest-validator
doc-utest-reviewer
doc-utest-fixer
doc-utest-audit
doc-tspec (multi-subtype fallback path)

Version History

Version	Date	Changes
1.0	2026-02-27	Initial UTEST authoring skill aligned to canonical UTEST MVP template/rules/schema with 90%-gate constraints and TSPEC coexistence routing

doc-utest

doc-utest

Purpose

Canonical References