← ClaudeAtlas

doc-driftlisted

Use for the whole-estate doc audit, "run the doc-drift loop", "audit the docs against the code", "are the docs still true", "doc drift sweep", "check every doc claim", or a scheduled doc-audit cadence run. Enumerates every LIVING doc (README, MANUAL, AGENTS, WORKFLOW, architecture, patterns), verdicts each against the live repo with evidence, fixes drift on a branch, gates through a PR. An audit-loop instance (docs/patterns/audit-loop.md). NOT for diff-scoped doc sync inside a build cycle (that is /kit:docs), NOT for dated records like specs, research, retros (they describe their moment and never drift), NOT for one known-wrong doc (just fix it).
dwarvesf/dwarves-kit · ★ 11 · AI & Automation · score 77
Install: claude install-skill dwarvesf/dwarves-kit
# Doc drift ## Overview Audit every living doc against the live repo and ship the fixes as a PR. This is the doc-drift instance of `docs/patterns/audit-loop.md`: enumerate, verdict with evidence, apply on a branch, gate through a PR the operator approves. `/kit:docs` syncs docs against ONE diff during a build cycle. This skill audits the WHOLE estate on a cadence, and catches what diff-scoped sync structurally misses: drift from merged-but-undocumented work, inventory rot, dead pointers, stale counts. PR #306 (hand-fixing the README inventories) is the proven need. ## The four slots (per the audit-loop pattern) | Slot | This instance | |---|---| | Item set | living docs only: `git ls-files README.md MANUAL.md AGENTS.md CLAUDE.md CONTRIBUTING.md ':(glob)docs/*.md' ':(glob)docs/patterns/*.md'` (the `:(glob)` magic is required: a bare `docs/*.md` pathspec matches recursively and pulls in every dated record) | | Contract | every checkable claim matches the live repo: referenced paths exist, inventory tables match the live dirs, counts match derived counts, named verbs and flags exist, cross-doc pointers resolve | | Evidence class | Tier 1: the repo itself via grep/ls/diff. Tier 2: a model reads the doc's described behavior against the actual command or script | | Apply mechanics | FIX in place on an isolated branch; REMOVE only with a named successor; PR body lists every verdict; UNSURE never auto-resolved | Dated records (docs/specs, docs/research, docs/retro, docs/handoff,