doc-stest-fixer

Purpose

Apply fixes for STEST issues identified by validator/reviewer workflows, with deterministic source-report precedence.

---

Input Contract

Preferred:

• STEST-NN.A_audit_report_vNNN.md

Legacy-compatible:

• STEST-NN.R_review_report_vNNN.md

Selection precedence:

1. Newest timestamp/version.
2. 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 (@ears, @bdd, @req)
• Missing timeout or 100%-gate constraints
• Missing rollback procedure requirements
• Non-binary pass/fail criteria in critical-path checks
• Traceability and cross-reference consistency
• Naming/path corrections for nested-folder compliance

---

Outputs

• Fixed STEST document(s)
• STEST-NN.F_fix_report_vNNN.md

---

Commands

/doc-stest-fixer STEST-01
/doc-stest-fixer STEST-01 --review-report STEST-01.A_audit_report_v001.md
/doc-stest-fixer STEST-01 --review-report STEST-01.R_review_report_v001.md

---

Integration

• Typically invoked after doc-stest-audit
• Re-run doc-stest-audit after fixes to verify closure

---

Version History

Version	Date	Changes
1.0	2026-02-27	Initial STEST fixer with deterministic .A_ preferred / .R_ legacy precedence and strict deployment-gate remediation checks

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.