| name | claude-docs-updater |
| description | Update CLAUDE.md documentation files after code changes. Use when user says "update the CLAUDE.md", "sync the docs with my changes", "document what I changed", "update documentation for this package", or after making significant code modifications that should be reflected in project documentation. |
| allowed-tools | Read, Write, Edit, Bash(git diff:*), Bash(git status:*), Glob |
| model | opus |
CLAUDE.md Updater
Quickly synchronize CLAUDE.md files based on staged git changes.
When to Activate
- After significant code changes
- User mentions updating documentation
- Staged changes should be documented
- New files added that need documentation
- Dependencies or commands changed
Quick Process
- Check Git: Verify in git repository
- Get Staged Files:
git diff --cached --name-status - Group by CLAUDE.md: Find nearest CLAUDE.md for each file
- Analyze Changes: Determine if updates needed
- Show Summary: Preview what will be updated
- Apply Updates: Write changes with user confirmation
Update Triggers
Updates triggered when:
- New files added (status 'A')
- package.json modified
- project.json modified
- Significant changes (>50 lines)
- New exports added
Update Strategies
New Files
- `path/to/file.ts` - [TODO: Add description]
Dependencies (package.json)
- **package-name** (version)
Commands (project.json)
- `nx command project` - [description]
Significant Changes
- Modified `path/to/file.ts` (N lines changed)
Performance
- Single git command for detection
- No external tools required
- Simple file operations
- 1-3 seconds typical
Safety
- Git provides rollback (
git restore CLAUDE.md) - Single confirmation prompt
- Non-destructive (adds, doesn't remove)
- Review with
git diffbefore commit
Usage Modes
Auto-detect (recommended): Analyzes staged changes automatically
Explicit: Update specific path's CLAUDE.md
Best Practices
- Stage changes first (
git add) - Review updates (
git diff **/*CLAUDE.md) - Commit together with related code
- Run frequently after significant changes