core/CLAUDE.md

Claude Code Rules

Always read and respect docs/DEV.md at the start of every conversation before doing any work in this project.

After every code change, update the relevant documentation. This includes:

• docs/ for cross-cutting conventions, architecture decisions, and design rules
• co-located README.md files in src/core/<module>/ and src/features/<feature>/ for module-level behaviour

No task is complete until all impacted documentation is up to date.

No whack-a-mole

Always fix the root cause, never the symptoms. If the same type of error appears in a second file after fixing the first, that's the signal the real fix is elsewhere — trace the import or call chain to understand why this code is reached in this context, then fix at that point.