/revise-claude-md
Capture session learnings and update CLAUDE.md for future sessions
Step
Human
Claude Code Agent
External Systems
Reflect
Reviews session for missing context that would help future runs
Bash commands, code style patterns, testing approaches, env quirks, gotchas
Find
Locates CLAUDE.md and .claude.local.md files in project
Decides placement: CLAUDE.md (shared/git) vs .claude.local.md (personal/gitignored)
find . -name "CLAUDE.md" -o -name ".claude.local.md" Existing files located
Git Draft
Drafts concise additions — one line per concept
Avoids verbose explanations, obvious info, one-off fixes. Format: command/pattern + brief description.
Propose
Shows proposed changes as diffs with one-line rationale each
For each: which file, why, and the exact diff
Decision Gate Approve
Approves, modifies, or rejects each proposed change
Required Apply
Applies approved changes to CLAUDE.md files
Only edits files the user approved
CLAUDE.md updated
Git Human
Agent
External
Decision gate