improvement: /insights should check for existing CLAUDE.md rules before proposing new ones
Resolved 💬 3 comments Opened Feb 7, 2026 by shuhei0866 Closed Feb 10, 2026
Observation: 5 out of 6 friction-reducing rules already exist in learning_with CLAUDE.md.
Problem statement:
- /insights proposes adding rules that are already documented
- Root cause analysis shows: Problem is NOT missing rules, but NON-COMPLIANCE
- This wastes context and confuses CLAUDE.md as single source of truth
Examples from 223-session analysis:
- WT enforcement: documented in CLAUDE.md > ignored by 10% of subagents
- TDD mandatory: documented > violated by bug-fix tasks
- Review steps: documented in RDD > skipped when under time pressure
- Migration safety: documented > violated without migration number check
Proposal: Enhance /insights to:
- Before proposing new rules, check existing CLAUDE.md for related rules
- If found, analyze WHY the rule is not being followed:
- Is it hard to understand?
- Is it in wrong section/format?
- Is it conflicting with other rules?
- Is it unclear when to apply?
- Propose IMPROVEMENTS to existing rules instead of NEW rules
- When new rule is genuinely needed, explicitly state why existing rules don't cover it
This improves CLAUDE.md signal-to-noise ratio and focuses improvements on compliance, not documentation.
This issue has 3 comments on GitHub. Read the full discussion on GitHub ↗