claude-md
Keep the CLAUDE.md your agents rely on accurate and lean instead of stale. Use when maintaining (not first creating) a CLAUDE.md — syncing it with architecture, conventions and commands as the project
SKILL.mdskills/claude-md/SKILL.md
GitHubCLAUDE.md Maintenance Workflow
Keep an existing CLAUDE.md accurate and lean. This is for ongoing upkeep — use the built-in /init for first creation.
Process
- Read the current
CLAUDE.md. - Compare against reality: recent commits, changed build commands, new/removed modules, updated conventions, new architecture decisions (check the ADR directory).
- Update only the affected sections. Do not rewrite untouched sections.
- Prune: remove stale instructions, merge duplicates, and keep each section tight. If a section has grown long, tighten it rather than letting it sprawl.
- Preserve the user's voice and structure — you are maintaining their file, not replacing it.
What to check for drift
- Build / test / lint commands that changed
- Module or directory structure changes
- New conventions or rules the team adopted
- Architecture decisions recorded as ADRs that belong in the high-level guidance
- Anything now contradicted by the actual codebase
Rules
- Never blow away existing content wholesale — edit surgically.
- Keep it scannable; CLAUDE.md is loaded into every session, so brevity matters.
- If something is already obvious from the code or another doc, don't duplicate it here.