# Claude Code Rules

Always read and respect [docs/DEV.md](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.