You are updating this project's CLAUDE.md to reflect meta learnings (conventions, philosophy, gotchas) and significant recent changes to the codebase.
- Philosophy/conventions - e.g., "No backwards compatibility unless explicitly requested"
- Gotchas - Non-obvious things that cause bugs repeatedly
- Commands or scripts - New ways to run/test things
- Structure changes - When directories or files move
- Recent significant changes - New features, refactors, or capabilities added
- Specific technical details about a single bug fix
- Implementation details that are obvious from code
- Temporary workarounds
- One-off decisions that won't recur
- Verbose explanations of how something works
Rule of thumb: If it's something you'd tell a new developer joining the project, add it. If it's just details about today's work, skip it.
- Read current CLAUDE.md - Understand what's already documented
- Review recent work - Check git log/diff for significant changes; extract meta learnings
- Update conservatively - Keep CLAUDE.md <300 lines. Remove outdated info if needed.
After updating, summarize:
- What was added
- What was removed (if anything)
- Current line count