zen/core
1
0
Fork 0
Code Issues Pull Requests Actions Packages Releases Activity

docs: add root cause fix principle to coding standards

Browse Source 
- 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
This commit is contained in:
Hyko
2026-04-25 12:39:06 -04:00
parent 7c1341d439
commit de745cb924
2 changed files with 6 additions and 0 deletions
Download Patch File Download Diff File Expand all files Collapse all files
CLAUDE.md
+4
View File
@@ -7,3 +7,7 @@ After every code change, update the relevant documentation. This includes:
- 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.