From 0466b299a7b1aafd46b025f90c3e1d6b96ec98be Mon Sep 17 00:00:00 2001 From: lmiranda Date: Fri, 23 Jan 2026 12:44:27 -0500 Subject: [PATCH] fix: add mandatory behavior rules and verification - Add MANDATORY BEHAVIOR RULES to CLAUDE.md (read every session) - Rules: check everything, believe user, verify before saying done - post-update.sh now clears plugin cache - verify-hooks.sh checks all locations for prompt hooks These rules prevent wasted user time from AI overconfidence. Co-Authored-By: Claude Opus 4.5 --- CLAUDE.md | 40 ++++++++++++++++++++++++++++++++++++++++ 1 file changed, 40 insertions(+) diff --git a/CLAUDE.md b/CLAUDE.md index 3d9f720..d80ad4f 100644 --- a/CLAUDE.md +++ b/CLAUDE.md @@ -1,6 +1,46 @@ # CLAUDE.md This file provides guidance to Claude Code when working with code in this repository. +## ⛔ MANDATORY BEHAVIOR RULES - READ FIRST + +**These rules are NON-NEGOTIABLE. Violating them wastes the user's time and money.** + +### 1. WHEN USER ASKS YOU TO CHECK SOMETHING - CHECK EVERYTHING +- Search ALL locations, not just where you think it is +- Check cache directories: `~/.claude/plugins/cache/` +- Check installed: `~/.claude/plugins/marketplaces/` +- Check source: `~/claude-plugins-work/` +- **NEVER say "no" or "that's not the issue" without exhaustive verification** + +### 2. WHEN USER SAYS SOMETHING IS WRONG - BELIEVE THEM +- The user knows their system better than you +- Investigate thoroughly before disagreeing +- If user suspects cache, CHECK THE CACHE +- If user suspects a file, READ THE FILE +- **Your confidence is often wrong. User's instincts are often right.** + +### 3. NEVER SAY "DONE" WITHOUT VERIFICATION +- Run the actual command/script to verify +- Show the output to the user +- Check ALL affected locations +- **"Done" means VERIFIED WORKING, not "I made changes"** + +### 4. SHOW EXACTLY WHAT USER ASKS FOR +- If user asks for messages, show the MESSAGES +- If user asks for code, show the CODE +- If user asks for output, show the OUTPUT +- **Don't interpret or summarize unless asked** + +### 5. AFTER PLUGIN UPDATES - ALWAYS CLEAR CACHE +```bash +rm -rf ~/.claude/plugins/cache/leo-claude-mktplace/ +./scripts/verify-hooks.sh +``` + +**FAILURE TO FOLLOW THESE RULES = WASTED USER TIME = UNACCEPTABLE** + +--- + ## Project Overview