← ClaudeAtlas

doc-driftlisted

Surface drift between the pending diff and the repo's orientation docs --- AGENTS.md (or legacy CLAUDE.md), README.md, and the GitHub repository description --- before `spinclass merge-this-session`. Use when the user asks "are the docs still accurate?", "did this change the README?", "check for doc drift", or right before a merge.
amarbel-llc/eng · ★ 1 · Code & Development · score 70
Install: claude install-skill amarbel-llc/eng
# Doc Drift Pre-merge sweep: check whether the pending diff invalidated any claim in the repo's **orientation docs** --- the things a human or agent reads first to get their bearings --- and surface specific stale statements with suggested fixes, without rewriting blindly. **Announce at start:** "Checking orientation docs for drift." ## The orientation docs 1. **AGENTS.md** --- the canonical agent-guidance file (architecture, commands, flags, file layout, conventions). Older repos may still call it **CLAUDE.md**; treat whichever exists as canonical. If both exist (e.g. `CLAUDE.md` symlinked to `AGENTS.md`), read the real file once. 2. **README.md** --- human-facing overview, install/usage, examples. 3. **GitHub repository description** --- the one-line summary shown on the repo page and in search results. These rot silently: a feature lands, a flag changes, an entrypoint moves, but the overview and the one-liner lag behind. ## Steps ### 1. Get the pending diff - `grit diff --stat-only` then `grit diff` against the worktree (never the root git directory --- per AGENTS.md). Base is whatever this branch forked from (spinclass branches off the default branch); use `grit log <base>..HEAD --oneline` to enumerate this session's commits. - If the diff touches **no** behavior, commands, flags, layout, or dependencies --- e.g. a pure-internal refactor or a test-only change --- the orientation docs almost certainly still hold. Say so and exit cheaply