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:

• 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 (@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 .