doc-itest-audit

SKILL.md

doc-itest-audit

Purpose

Run a single ITEST audit workflow:

  1. doc-itest-validator
  2. doc-itest-reviewer

Then emit a combined fixer-ready report.


Output Contract

Primary output:

  • ITEST-NN.A_audit_report_vNNN.md

Fixer compatibility:

  • doc-itest-fixer accepts .A_ (preferred) and .R_ (legacy-compatible).

Combined Status Rules

  • PASS: validator PASS AND reviewer score >= threshold AND no blocking/manual-required issues
  • FAIL: validator FAIL OR reviewer score below threshold OR blocking/manual-required issues present

Combined Report Sections

  1. Summary
  2. Score Calculation
  3. Validator Findings
  4. Reviewer Findings
  5. Coverage Findings
  6. Fix Queue (auto_fixable, manual_required, blocked)
  7. Recommended Next Step

Handoff Rule

If remediation needed:

  • Run doc-itest-fixer with newest report.
  • On timestamp/version tie, prefer .A_ over .R_.

Example

/doc-itest-audit docs/10_TSPEC/ITEST/ITEST-01_scope/ITEST-01_scope.md

Version History

Version Date Changes
1.0 2026-02-27 Initial ITEST audit wrapper with validator->reviewer orchestration and .A_ preferred fixer 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.
Weekly Installs
3
GitHub Stars
9
First Seen
3 days ago
Installed on
opencode3
gemini-cli3
antigravity3
claude-code3
github-copilot3
codex3