doc-dspec-validator
Validate Documentation Specifications (DSPEC) documents against Layer 9.51 schema standards.
Activation
Invoke when user requests validation of DSPEC documents or after creating/modifying DSPEC artifacts.
Validation Schema Reference
-
Schema: ai_dev_ssd_flow/09_SPEC/DSPEC/DSPEC_MVP_SCHEMA.yaml
-
Layer: 9.51
-
Artifact Type: DSPEC
-
Deliverable Type: document
Validation Checklist
- Metadata Validation
Field Required Valid Values
document_type
Yes dspec-document
artifact_type
Yes DSPEC
deliverable_type
Yes document
subtype_code
Yes 51
layer
Yes 9
- Content Structure
-
Document type specified (55-58)
-
Target audience defined
-
Content outline complete
-
Style guide referenced
- Audience Analysis
-
Primary audience identified
-
Secondary audiences listed
-
Technical level specified
-
Prerequisites documented
- Content Coverage
-
All REQ topics covered
-
Examples included
-
Diagrams/visuals specified
-
Glossary terms defined
- Accessibility
-
Alt text requirements noted
-
Reading level specified
-
Translation requirements documented
-
Format accessibility considered
- Traceability
Required cumulative tags:
- @brd , @prd , @ears , @bdd , @adr , @sys , @req
- DOC-Ready Score
Component Weight Minimum
Content Coverage 25% 100%
Audience Alignment 20% 90%
Structure Completeness 20% 90%
Style Compliance 15% 85%
Accessibility 10% 85%
Traceability 10% 100%
Target: DOC-Ready ≥85%
Error Codes
Code Severity Description
DSPEC-E001 Error Missing audience definition
DSPEC-E002 Error Incomplete content outline
DSPEC-E003 Error Missing document type
DSPEC-W001 Warning Style guide not referenced
DSPEC-W002 Warning DOC-Ready score below threshold
References
-
Schema: ai_dev_ssd_flow/09_SPEC/DSPEC/DSPEC_MVP_SCHEMA.yaml
-
Validation Rules: ai_dev_ssd_flow/09_SPEC/DSPEC/DSPEC_MVP_VALIDATION_RULES.md