doc-itest-fixer
Purpose
Apply fixes for ITEST issues identified by validator/reviewer workflows, with deterministic source-report precedence.
Input Contract
Preferred:
- ITEST-NN.A_audit_report_vNNN.md
Legacy-compatible:
- ITEST-NN.R_review_report_vNNN.md
Selection precedence:
-
Newest timestamp/version.
-
If tied, prefer .A_audit_report_vNNN.md over .R_review_report_vNNN.md .
Fix Categories
-
Missing required sections (6-section contract)
-
Missing/invalid subtype tags (@ctr , @sys )
-
Contract compliance table completeness
-
Missing sequence diagram for complex interactions
-
Traceability and cross-reference consistency
-
Naming/path corrections for nested-folder compliance
Outputs
-
Fixed ITEST document(s)
-
ITEST-NN.F_fix_report_vNNN.md
Commands
/doc-itest-fixer ITEST-01 /doc-itest-fixer ITEST-01 --review-report ITEST-01.A_audit_report_v001.md /doc-itest-fixer ITEST-01 --review-report ITEST-01.R_review_report_v001.md
Integration
-
Typically invoked after doc-itest-audit
-
Re-run doc-itest-audit after fixes to verify closure
Version History
Version Date Changes
1.0 2026-02-27 Initial ITEST fixer with deterministic .A_ preferred / .R_ legacy precedence and versioned fix report contract
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 .