doc-dspec-fixer

Purpose

Automated fix skill that reads the latest review report and applies fixes to DSPEC (Documentation Specification) documents. Enables iterative improvement cycles between review and fix phases.

Layer: 9.51 (DSPEC Quality Improvement)

Upstream: REQ, DSPEC, Review Report

Downstream: Fixed DSPEC, Fix Report

---

Fixable Issue Types

Automatic Fixes

Issue Type	Fix Action
Missing document_type	Add document_type: dspec-document
Missing subtype_code	Add subtype_code: 51
Broken internal links	Update to correct paths
Missing traceability tags	Add required cumulative tags
YAML syntax errors	Fix formatting issues

Semi-Automatic Fixes

Issue Type	Fix Action
Missing content outline sections	Generate placeholders
Incomplete audience definition	Add template sections

Manual Review Required

Issue Type	Action
Content accuracy issues	Requires subject matter expert
Audience mismatch	Requires stakeholder input
Style guide violations	May require editorial review

---

Output Files

File	Purpose
Updated DSPEC YAML	Fixed document
DSPEC-NN.F_fix_report_vNNN.md	Fix report documenting changes

---

References

• Template: ai_dev_ssd_flow/09_SPEC/DSPEC/DSPEC-MVP-TEMPLATE.yaml
• Schema: ai_dev_ssd_flow/09_SPEC/DSPEC/DSPEC_MVP_SCHEMA.yaml