doc-driftlisted

# Doc drift ## Scope and triggers 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). Dated records like specs, research, retros describe their moment and never 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