Menu
Audit docs/ and ~/.claude/docs/ for rot โ broken refs, stale runbooks, ADR contradictions, architecture drift, orphan CLAUDE.md. Reports only; never auto-edits. Use on /document-audit or 'check doc health'.
Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.
Based on SOC occupation classification
Compatibility launcher for the code-review agent. Delegates a GitHub/GitLab PR review to Codex: deterministic preflight does recon, then Codex scores six axes into one artifact at .TerMinal/reviews/<pr>/<sha>.md (v2) or .reviews/<pr>/<sha>.md (legacy v1). Use on /code-review or 'review this PR'.
Human-review digest for a PR/MR โ chunks the diff into a noise-filtered, risk-ranked, code-first review surface (green/red diffs, ๐ข/๐ก/๐ด, design-decision callouts) WITHOUT abstracting the code away. Deterministic chunker + one bounded codex pass. Sits alongside /code-review (the gate) and /iterate (tests). Use on /digest or 'digest this PR for review'. Renders in TerMinal.
Sweep recent changes and propose doc updates (ADRs, runbooks, learnings, architecture, per-folder CLAUDE.md), one candidate at a time. Use on /document, 'capture decisions', or natural post-commit/post-PR pauses.
FORCE-MODE hotfix: smallest patch โ commit โ push DIRECTLY to main โ follow-up ticket. Needs TERMINAL_FORCE_MAIN=1 (hook-enforced). Use on /emergency-fix or 'this is breaking prod' / 'hotfix' / 'we need to revert now'.
Enqueue a one-off TerMinal automation-inbox request (can create Activity, tickets, HITL, agent runs, or background tasks). Use on /enqueue-request or to queue a durable local automation request.
Continuous autonomous orchestrator: reconcile, route tickets by owner agent, run stacked PR/MR passes, optionally discover/refill, park HITL, never merge. Use on /factory or 'work the backlog autonomously'.
| name | document-audit |
| description | Audit docs/ and ~/.claude/docs/ for rot โ broken refs, stale runbooks, ADR contradictions, architecture drift, orphan CLAUDE.md. Reports only; never auto-edits. Use on /document-audit or 'check doc health'. |
Walk all docs and report rot. The user decides what to prune, archive, or update โ this skill never edits or deletes on its own.
For each .md under docs/ (current repo) and ~/.claude/docs/ (global):
last-verified older than 90 days.accepted ADRs whose decisions appear to conflict, where neither has a supersedes / superseded-by link.architecture.md mentions folders, services, or major deps that no longer match the repo state.Group findings by severity:
For each finding, include:
update / archive / delete / mark supersededEnd the report with totals per severity.
status: deprecated or status: superseded โ those are expected and shouldn't appear as contradictions.last-verified as stale โ flag them as missing-frontmatter (Suspect) instead.If both project docs/ and ~/.claude/docs/ are in scope and the report would be very long, ask the user which scope to audit first. Otherwise audit both and report together with clear path prefixes.