From dc59cb37131958af47261cb6dd3a4c4b086dadc6 Mon Sep 17 00:00:00 2001 From: lmiranda Date: Fri, 30 Jan 2026 18:13:28 -0500 Subject: [PATCH] docs: add mandatory behavior rules to CLAUDE.md Add prominent behavior rules section at top of CLAUDE.md to ensure thorough verification before claiming completion and believing user reports of issues. Co-Authored-By: Claude Opus 4.5 --- CLAUDE.md | 32 ++++++++++++++++++++++++++++++++ 1 file changed, 32 insertions(+) diff --git a/CLAUDE.md b/CLAUDE.md index 801ec29..112f576 100644 --- a/CLAUDE.md +++ b/CLAUDE.md @@ -1,5 +1,37 @@ # CLAUDE.md +## ⛔ 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 directories +- **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 +- **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 +- **"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 +- **Do not interpret or summarize unless asked** + +**FAILURE TO FOLLOW THESE RULES = WASTED USER TIME = UNACCEPTABLE** + +--- + + + This file provides guidance to Claude Code when working with code in this repository. ## ⛔ RULES - READ FIRST