hykocx
de745cb924
- add "no whack-a-mole" rule in CLAUDE.md to enforce fixing root causes over symptoms - add equivalent root cause principle in docs/DEV.md coding standards section
14 lines
791 B
Markdown
14 lines
791 B
Markdown
# 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.
|