Files
claude-plugins-official/plugins/claude-md-management/commands/revise-claude-md.md

55 lines
1.3 KiB
Markdown

---
description: Update CLAUDE.md with learnings from this session
allowed-tools: Read, Edit, Glob
---
Review this session for learnings about working with Claude Code in this codebase. Update CLAUDE.md with context that would help future Claude sessions be more effective.
## Step 1: Reflect
What context was missing that would have helped Claude work more effectively?
- Bash commands that were used or discovered
- Code style patterns followed
- Testing approaches that worked
- Environment/configuration quirks
- Warnings or gotchas encountered
## Step 2: Find CLAUDE.md Files
```bash
find . -name "CLAUDE.md" -o -name ".claude.local.md" 2>/dev/null | head -20
```
Decide where each addition belongs:
- `CLAUDE.md` - Team-shared (checked into git)
- `.claude.local.md` - Personal/local only (gitignored)
## Step 3: Draft Additions
**Keep it concise** - one line per concept. CLAUDE.md is part of the prompt, so brevity matters.
Format: `<command or pattern>` - `<brief description>`
Avoid:
- Verbose explanations
- Obvious information
- One-off fixes unlikely to recur
## Step 4: Show Proposed Changes
For each addition:
```
### Update: ./CLAUDE.md
**Why:** [one-line reason]
\`\`\`diff
+ [the addition - keep it brief]
\`\`\`
```
## Step 5: Apply with Approval
Ask if the user wants to apply the changes. Only edit files they approve.