CLAUDE.md Maintenance

Overview

CLAUDE.md is the project's memory. Every Claude session reads it first. If it's stale, every session starts wrong.

Core principle: CLAUDE.md must reflect the project AS IT IS RIGHT NOW — not as it was when first scaffolded. Update it proactively after every meaningful change.

Why this matters: Without a living CLAUDE.md, every new session starts from zero. The agent makes the same mistakes — wrong import paths, deprecated commands, patterns that were already rejected. CLAUDE.md is how the agent stops repeating itself.

When to Update

ALWAYS update CLAUDE.md after: