/rules-check-drift — keep your rules file true, not longer

Your rules file — CLAUDE.md or AGENTS.md — is a steering document, not documentation: your ground rules, your conventions, and a current map of where things live. Its only failure mode that matters is being wrong: a stale rule or a drifted map actively misleads the agent on every future run. This skill checks the rules file against what just changed and proposes the smallest edit that keeps it true.

Wrong rules are worse than missing rules. A longer rules file is worse than a lean one. Most changes need no edit at all — adding a wrong or verbose line makes it worse.

Input

• $ARGUMENTS — optional diff range. Default: uncommitted + staged (git diff HEAD); fall back to main...HEAD.
• Scope: the project's rules file(s) — CLAUDE.md and/or AGENTS.md, the root file + any package-level ones. (If CLAUDE.md is just a @AGENTS.md import, check AGENTS.md.) Ignore README, docs/, and .claude/ agent/command/skill files. This skill exists to keep the rules honest, nothing else.

Process