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.mdover.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.mdIntegration
- Typically invoked after
doc-ptest-audit - Re-run
doc-ptest-auditafter 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.