update-claude-md
Installation
SKILL.md
Update CLAUDE.md
Refresh the CLAUDE.md that scopes the user's current working directory so its claims match the code today.
Scope rules
- Target file: the closest
CLAUDE.mdtocwdwalking upward. Prefer the app/package-level file whencwdis inside one; only touch the monorepo rootCLAUDE.mdwhencwdis at the root (or no package-level file exists). - Never invent a CLAUDE.md. If none exists in scope, stop and tell the user.
- Never touch
~/.claude/CLAUDE.md(global user instructions) or other packages' CLAUDE.md files — single-package scope only. ## Task-specific plan/ scratch sections: prune, don't preserve. Entries for work that already landed are cruft — remove them (see the task-cruft sweep in step 5). Keep only entries for tasks still in flight; when you can't tell, keep and flag in the summary.
Detect progressive-disclosure structure
Before doing anything else, check whether the target CLAUDE.md is a thin index that defers deep content to a context/ (or similar) directory of sibling .md files. Signals:
- A sibling directory named
context/,claude/,docs/claude/, or similar containing multiple*.mdfiles. - The CLAUDE.md body references those files (e.g. a "Where to read deeper" / "Load on demand" table mapping topics → file paths).
- The CLAUDE.md itself is short (orientation only) and explicitly says deeper docs live elsewhere.