Menú
Reviews the codebase against its docs. Read-only. Flags stale documentation where the code has moved on — never edits a doc or opens a PR at L1.
Instalar con Codex o Claude Copia este prompt, pégalo en Codex, Claude u otro asistente, y deja que revise la página de la skill y la instale por ti.
Basado en la clasificación ocupacional SOC
| name | docs-sweep |
| description | Reviews the codebase against its docs. Read-only. Flags stale documentation where the code has moved on — never edits a doc or opens a PR at L1. |
The prompt carries intent; this skill carries the procedure — keep it a checklist, not an essay. Adapted from Forward Future Loop Library #1 ("The docs sweep," Matthew Berman) to this library's L1-first, report-only shape.
docs-sweep-state.md's last-swept mark, and the documentation that
describes it.docs-drift-report.md: one entry per stale page — doc file and
section · what it claims · what the code actually does now · a suggested
(NOT applied) correction.docs-sweep-state.md's last-swept mark, append one
line to loop-run-log.md, commit both.LOOP.md →
Promotion to L2).Reviews pending PRs, excludes stale/unfinished work, combines the rest into a release batch built from main. Read-only — reports the batch, never actually releases.
Writes a scoped spec packet for one ticket, reviewed by a genuinely independent adversarial pass that also regression-checks prior findings. Read-only outside the draft — never writes the canonical spec.
Defines every required outcome and its evidence before acting on long-running work, then audits each requirement as proved/weak/missing/ contradicted. Only run when explicitly asked for a completion audit.
General-purpose harness for scheduled repo work — stage in an isolated worktree, verify with a genuinely separate second session, ship only after a pass. Read-only — reports, never delivers.
Runs an adversarial review cycle against a PR (Claude implements/fixes, Codex or a subagent stand-in reviews), up to 5 iterations. Read-only on the real PR — drafts fixes, never pushes them.
Turns a ticket or bug report into a review-ready patch. Read-only — reproduces, roots out the cause, drafts a fix, reports it. Never opens a PR, never folds in unrelated refactors.