doc-driftlisted
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