doc-ptest-fixer

Purpose

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

Input Contract

Preferred:

• PTEST-NN.A_audit_report_vNNN.md

Legacy-compatible:

• PTEST-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 (@sys , @spec )

• Missing performance categories or load scenario tables

• Non-measurable threshold definitions

• Incomplete execution profile for complex scenarios

• Traceability and cross-reference consistency

• Naming/path corrections for nested-folder compliance

Outputs

• Fixed PTEST document(s)

• PTEST-NN.F_fix_report_vNNN.md

Commands

/doc-ptest-fixer PTEST-01 /doc-ptest-fixer PTEST-01 --review-report PTEST-01.A_audit_report_v001.md /doc-ptest-fixer PTEST-01 --review-report PTEST-01.R_review_report_v001.md

Integration

• Typically invoked after doc-ptest-audit

• Re-run doc-ptest-audit after fixes to verify closure

Version History

Version Date Changes

1.0 2026-02-27 Initial PTEST 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 .