Audit summary

Release: v0.92.0 (published 2026-10-15T04:47:22Z). Local git history is shallow in this sandbox (git log --since on a single boundary commit showed the entire tree as "changed"), so the release/change audit used GitHub MCP list_commits scoped to docs/ and .github/aw/ instead of local git diff/git log.

Documentation commits reviewed: 31 commits touching .github/aw/ and ~15 recent commits touching docs/ since the release, including:

• #70738 — rename missing-capability diagnostic tools to report_missing_tool / report_missing_data (frontmatter keys missing-tool: / missing-(redacted) became deprecated schema aliases, "Run gh aw fix` to migrate")
• #70763 — admission jobs now opt-in via frontmatter/aw.json
• #70622 — artifact-first admission conclusion session delivery
• Several already-applied [instructions]-tagged docs PRs (checkout/model-routing sync, work-queue guidance, debug playbook, graders migration, offline skills) — no action needed, these are current.

Size audit

wc -l .github/aw/*.md — all 77 files remain under their target limits. cli-commands.md is closest to its 400-line budget at 399 lines but not over.

Accuracy audit

Cross-checked .github/aw/*.md against pkg/parser/schemas/main_workflow_schema.json (the compiler_types.go / safe_outputs_config.go files named in the janitor brief no longer exist as single files — they were split into pkg/workflow/safe_outputs_config_*.go and pkg/workflow/compiler_* files per prior ADRs; reviewed those instead).

Found and fixed: three instruction files still documented the now-deprecated missing-tool: / missing-(redacted) frontmatter keys as current syntax. The schema (lines ~12035–12126) marks these "deprecated": truewith the canonical namesreport-missing-tool:/report-missing-(redacted) Verified the create-issue default nuance already documented (false when the block is explicitly present, auto-true only when omitted) against pkg/workflow/missing_issue_reporting.go — that part was already accurate and left unchanged.

Files changed:

• .github/aw/safe-outputs-automation.md (307 lines, was 307) — renamed both config headings and YAML examples to report-missing-tool: / `report-missing-(redacted) noting the deprecated aliases.
• .github/aw/safe-outputs-content.md (388 lines, was 388) — updated the system-types list referenced by the create-issue auto-injection rule.
• .github/aw/designer-mappings.md (168 lines, was 168) — updated the intent-to-safe-output mapping table.

Left unchanged (verified correct, not drift): .github/aw/runbooks/workflow-health.md and .github/aw/runbooks/README.md use "missing-tool" only as a runtime error-message description (e.g. "Error: missing tool configuration for mcpscripts-gh"), not the frontmatter key — no change needed there.

Duplication audit

No new duplication introduced; the three edits are independent corrections of the same terminology drift, not overlapping guidance that needed consolidation. No existing duplicated content was found that needed removing beyond this pass.

Edge cases

This is not a no-op: real documentation drift was found and corrected, so the Duplication and Accuracy audits were run in full per the required process (the "no relevant changes" early-exit did not apply).

Steering

Checked issue #70832 for steer-tagged comments — none present at time of this run.

🤖 Generated with [Claude Code]((claude.com/redacted)

Generated by 🧹 Instructions Janitor · claude · sonnet50 · 159.8 AIC · ⌖ 22.8 AIC · ⊞ 6.7K · ◷

• expires on Oct 23, 2026, 12:49 AM UTC-08:00