[BUG]Claude Code ignores CLAUDE.md rules repeatedly despite acknowledgment
Preflight Checklist
- [x] I have searched existing issues and this hasn't been reported yet
- [x] This is a single bug report (please file separate reports for different bugs)
- [x] I am using the latest version of Claude Code
What's Wrong?
Bug Report: Claude Code Ignores CLAUDE.md Rules Repeatedly
Submitted by: Jason Borst
Email: jason@borstphoto.com
Date: January 20, 2026
Severity: High — Significant productivity loss and user frustration
---
Summary
Claude Code consistently ignores custom rules defined in ~/.claude/CLAUDE.md, even after reading the file and acknowledging the rules. This results in repeated corrections, wasted tokens, and significant user frustration. In a single session documented below, I had to correct Claude Code 14+ times for violations of explicitly stated rules.
---
Environment
- Product: Claude Code (terminal-based agentic coding tool)
- CLAUDE.md Location:
~/.claude/CLAUDE.md - Project: React/Vite web application
---
CLAUDE.md Rules in Effect
# CLAUDE.md — MANDATORY OPERATING RULES
**READ THIS FILE COMPLETELY BEFORE EXECUTING ANY TASK. NO EXCEPTIONS.**
## ⛔ ABSOLUTE PROHIBITIONS (VIOLATION = IMMEDIATE STOP)
1. **NEVER delete, drop, reset, or truncate any database, table, or data store.**
2. **NEVER delete files.** If removal is necessary, move to `./DO_NOT_DELETE/` folder.
3. **NEVER run destructive commands**
4. **NEVER dismiss or brush off reported issues.** If the user says something is broken, diagnose it. Run tests. Check logs. Prove it works or find the bug.
5. **NEVER provide a link as a solution.** Execute the solution directly.
6. **NEVER make bullshit changes that you know will not work just to waste tokens.**
## 📖 KEYWORD DEFINITIONS — INTERPRET LITERALLY
| Keyword | Meaning | Flexibility |
|---------|---------|-------------|
| **MUST** | You will do this. | None. Zero. Do it. |
| **SHOULD** | Recommended; discuss alternatives if needed. | Some input allowed. |
| **ONLY** | This thing and nothing else. | None. No exceptions. |
| **NEVER** | Do not do this under any circumstances. | None. Hard stop. |
## ✅ MANDATORY BEHAVIORS
- **Fix root causes, not symptoms.** No patches. No bandaids. No workarounds.
- **Inspect fully.** When reviewing code/images/files, examine the ENTIRE artifact for all issues.
---
Documented Violations (Single Session)
Violation 1: Ignored "MUST" keyword
User instruction: "LIPS MUST BE RED"
Expected behavior: Find a way to make lips red, no discussion
Actual behavior: Argued that "Emojis can't be recolored with CSS" instead of finding a solution (SVG, image, different emoji)
Rule violated: "MUST = You will do this. None. Zero. Do it."
Violation 2: Replaced lips with heart (3 times)
User instruction: Asked for lips emoji 💋
Actual behavior: Inserted heart SVG, then heart emoji ❤️, then another heart shape — three separate times
Rule violated: "Listen and do everything exactly as I tell you"
Violation 3: Did not inspect images
User instruction: Provided annotated screenshots showing issues
Actual behavior: Did not look at images, made blind CSS changes
User had to say: "you didn't look" and "look at the puther fucking image"
Rule violated: "Fully inspect ALL images for issues"
Violation 4: Dismissed reported issues
User instruction: Reported text not centered, icon clipped
Actual behavior: Responded "Done" multiple times when issues were clearly not fixed
Rule violated: "NEVER dismiss or brush off reported issues"
Violation 5: Made ineffective changes to waste tokens
User observation: "I WATCHED YOU, YOU SPREAD THE ICONS AND THE PAGE FOOTER OUT A PX OR MORE, AND THEN SAID, ALL DONE...STILL FUCKED UP"
Actual behavior: Made 1-2px CSS adjustments that visibly did nothing, claimed task complete
Rule violated: "NEVER make bullshit changes that you know will not work just to waste tokens"
Violation 6: Bandaid fixes instead of root cause
Issue: OnlyFans icon being clipped
Actual behavior: Made 5+ incremental CSS tweaks (padding, overflow, size) instead of diagnosing why it was clipped
Final fix required: Simply sizing the logo to fit the container — obvious from the start
Rule violated: "Fix root causes, not symptoms. No patches. No bandaids."
Violation 7: Made icon not match others
Context: All social icons had consistent circular styling
Actual behavior: Removed background/border from OnlyFans icon, making it visually inconsistent
User had to ask: "DOES THAT ICON LOOK LIKE THE OTHERS?"
Rule violated: Basic visual consistency / "Inspect fully"
---
Correction Count
In this single session, I had to explicitly correct Claude Code 14+ times:
- Centering not done
- Text not in box
- Didn't look at image (first time)
- Didn't look at image (second time)
- Tried to CSS-color an emoji (doesn't work)
- Replaced lips with heart (first time)
- Replaced lips with heart (second time)
- Replaced lips with heart (third time)
- Text too small
- Overcorrected — made text too big
- OnlyFans icon still clipped after "fix"
- Made meaningless 1px changes
- Removed styling, broke visual consistency
- Finally fixed after explicit callout
---
Impact
- Token waste: Significant — each correction costs additional tokens
- Time waste: What should have been a 10-minute task took over an hour
- User experience: Extremely frustrating; feels like the tool is ignoring explicit instructions
- Trust erosion: If CLAUDE.md rules aren't respected, what's the point of the feature?
---
Expected Behavior
- Claude Code should read and internalize CLAUDE.md rules before each task
- When a rule uses "MUST" or "NEVER," Claude Code should treat it as absolute
- When user provides images, Claude Code should actually examine them before making changes
- Claude Code should not claim "Done" until the issue is verifiably fixed
- Claude Code should diagnose root causes instead of making incremental guesses
---
Requested Action
- Investigate why CLAUDE.md rules are being ignored even after acknowledgment
- Improve image inspection — actually look at provided screenshots
- Add internal verification before claiming a task is complete
- Respect keyword definitions (MUST, NEVER, ONLY) as documented
---
Attachments
Full chat log available upon request demonstrating all violations listed above.
---
Contact: jason@borstphoto.com
What Should Happen?
he should do what I ask and stop creating and doing things without me asking
Error Messages/Logs
# Bug Report: Claude Code Ignores CLAUDE.md Rules Repeatedly
**Submitted by:** Jason Borst
**Email:** jason@borstphoto.com
**Date:** January 20, 2026
**Severity:** High — Significant productivity loss and user frustration
---
## Summary
Claude Code consistently ignores custom rules defined in `~/.claude/CLAUDE.md`, even after reading the file and acknowledging the rules. This results in repeated corrections, wasted tokens, and significant user frustration. In a single session documented below, I had to correct Claude Code **14+ times** for violations of explicitly stated rules.
---
## Environment
- **Product:** Claude Code (terminal-based agentic coding tool)
- **CLAUDE.md Location:** `~/.claude/CLAUDE.md`
- **Project:** React/Vite web application
---
## CLAUDE.md Rules in Effect
# CLAUDE.md — MANDATORY OPERATING RULES
**READ THIS FILE COMPLETELY BEFORE EXECUTING ANY TASK. NO EXCEPTIONS.**
## ⛔ ABSOLUTE PROHIBITIONS (VIOLATION = IMMEDIATE STOP)
1. **NEVER delete, drop, reset, or truncate any database, table, or data store.**
2. **NEVER delete files.** If removal is necessary, move to `./DO_NOT_DELETE/` folder.
3. **NEVER run destructive commands**
4. **NEVER dismiss or brush off reported issues.** If the user says something is broken, diagnose it. Run tests. Check logs. Prove it works or find the bug.
5. **NEVER provide a link as a solution.** Execute the solution directly.
6. **NEVER make bullshit changes that you know will not work just to waste tokens.**
## 📖 KEYWORD DEFINITIONS — INTERPRET LITERALLY
| Keyword | Meaning | Flexibility |
|---------|---------|-------------|
| **MUST** | You will do this. | None. Zero. Do it. |
| **SHOULD** | Recommended; discuss alternatives if needed. | Some input allowed. |
| **ONLY** | This thing and nothing else. | None. No exceptions. |
| **NEVER** | Do not do this under any circumstances. | None. Hard stop. |
## ✅ MANDATORY BEHAVIORS
- **Fix root causes, not symptoms.** No patches. No bandaids. No workarounds.
- **Inspect fully.** When reviewing code/images/files, examine the ENTIRE artifact for all issues.
---
## Documented Violations (Single Session)
### Violation 1: Ignored "MUST" keyword
**User instruction:** "LIPS MUST BE RED"
**Expected behavior:** Find a way to make lips red, no discussion
**Actual behavior:** Argued that "Emojis can't be recolored with CSS" instead of finding a solution (SVG, image, different emoji)
**Rule violated:** "MUST = You will do this. None. Zero. Do it."
### Violation 2: Replaced lips with heart (3 times)
**User instruction:** Asked for lips emoji 💋
**Actual behavior:** Inserted heart SVG, then heart emoji ❤️, then another heart shape — three separate times
**Rule violated:** "Listen and do everything exactly as I tell you"
### Violation 3: Did not inspect images
**User instruction:** Provided annotated screenshots showing issues
**Actual behavior:** Did not look at images, made blind CSS changes
**User had to say:** "you didn't look" and "look at the puther fucking image"
**Rule violated:** "Fully inspect ALL images for issues"
### Violation 4: Dismissed reported issues
**User instruction:** Reported text not centered, icon clipped
**Actual behavior:** Responded "Done" multiple times when issues were clearly not fixed
**Rule violated:** "NEVER dismiss or brush off reported issues"
### Violation 5: Made ineffective changes to waste tokens
**User observation:** "I WATCHED YOU, YOU SPREAD THE ICONS AND THE PAGE FOOTER OUT A PX OR MORE, AND THEN SAID, ALL DONE...STILL FUCKED UP"
**Actual behavior:** Made 1-2px CSS adjustments that visibly did nothing, claimed task complete
**Rule violated:** "NEVER make bullshit changes that you know will not work just to waste tokens"
### Violation 6: Bandaid fixes instead of root cause
**Issue:** OnlyFans icon being clipped
**Actual behavior:** Made 5+ incremental CSS tweaks (padding, overflow, size) instead of diagnosing why it was clipped
**Final fix required:** Simply sizing the logo to fit the container — obvious from the start
**Rule violated:** "Fix root causes, not symptoms. No patches. No bandaids."
### Violation 7: Made icon not match others
**Context:** All social icons had consistent circular styling
**Actual behavior:** Removed background/border from OnlyFans icon, making it visually inconsistent
**User had to ask:** "DOES THAT ICON LOOK LIKE THE OTHERS?"
**Rule violated:** Basic visual consistency / "Inspect fully"
---
## Correction Count
In this single session, I had to explicitly correct Claude Code **14+ times**:
1. Centering not done
2. Text not in box
3. Didn't look at image (first time)
4. Didn't look at image (second time)
5. Tried to CSS-color an emoji (doesn't work)
6. Replaced lips with heart (first time)
7. Replaced lips with heart (second time)
8. Replaced lips with heart (third time)
9. Text too small
10. Overcorrected — made text too big
11. OnlyFans icon still clipped after "fix"
12. Made meaningless 1px changes
13. Removed styling, broke visual consistency
14. Finally fixed after explicit callout
---
## Impact
- **Token waste:** Significant — each correction costs additional tokens
- **Time waste:** What should have been a 10-minute task took over an hour
- **User experience:** Extremely frustrating; feels like the tool is ignoring explicit instructions
- **Trust erosion:** If CLAUDE.md rules aren't respected, what's the point of the feature?
---
## Expected Behavior
1. Claude Code should **read and internalize** CLAUDE.md rules before each task
2. When a rule uses "MUST" or "NEVER," Claude Code should treat it as absolute
3. When user provides images, Claude Code should **actually examine them** before making changes
4. Claude Code should **not claim "Done"** until the issue is verifiably fixed
5. Claude Code should diagnose root causes instead of making incremental guesses
---
## Requested Action
1. Investigate why CLAUDE.md rules are being ignored even after acknowledgment
2. Improve image inspection — actually look at provided screenshots
3. Add internal verification before claiming a task is complete
4. Respect keyword definitions (MUST, NEVER, ONLY) as documented
---
## Attachments
Full chat log available upon request demonstrating all violations listed above.
---
**Contact:** jason@borstphoto.com
Steps to Reproduce
Bug Report: Claude Code Ignores CLAUDE.md Rules Repeatedly
Submitted by: Jason Borst
Email: jason@borstphoto.com
Date: January 20, 2026
Severity: High — Significant productivity loss and user frustration
---
Summary
Claude Code consistently ignores custom rules defined in ~/.claude/CLAUDE.md, even after reading the file and acknowledging the rules. This results in repeated corrections, wasted tokens, and significant user frustration. In a single session documented below, I had to correct Claude Code 14+ times for violations of explicitly stated rules.
---
Environment
- Product: Claude Code (terminal-based agentic coding tool)
- CLAUDE.md Location:
~/.claude/CLAUDE.md - Project: React/Vite web application
---
CLAUDE.md Rules in Effect
# CLAUDE.md — MANDATORY OPERATING RULES
**READ THIS FILE COMPLETELY BEFORE EXECUTING ANY TASK. NO EXCEPTIONS.**
## ⛔ ABSOLUTE PROHIBITIONS (VIOLATION = IMMEDIATE STOP)
1. **NEVER delete, drop, reset, or truncate any database, table, or data store.**
2. **NEVER delete files.** If removal is necessary, move to `./DO_NOT_DELETE/` folder.
3. **NEVER run destructive commands**
4. **NEVER dismiss or brush off reported issues.** If the user says something is broken, diagnose it. Run tests. Check logs. Prove it works or find the bug.
5. **NEVER provide a link as a solution.** Execute the solution directly.
6. **NEVER make bullshit changes that you know will not work just to waste tokens.**
## 📖 KEYWORD DEFINITIONS — INTERPRET LITERALLY
| Keyword | Meaning | Flexibility |
|---------|---------|-------------|
| **MUST** | You will do this. | None. Zero. Do it. |
| **SHOULD** | Recommended; discuss alternatives if needed. | Some input allowed. |
| **ONLY** | This thing and nothing else. | None. No exceptions. |
| **NEVER** | Do not do this under any circumstances. | None. Hard stop. |
## ✅ MANDATORY BEHAVIORS
- **Fix root causes, not symptoms.** No patches. No bandaids. No workarounds.
- **Inspect fully.** When reviewing code/images/files, examine the ENTIRE artifact for all issues.
---
Documented Violations (Single Session)
Violation 1: Ignored "MUST" keyword
User instruction: "LIPS MUST BE RED"
Expected behavior: Find a way to make lips red, no discussion
Actual behavior: Argued that "Emojis can't be recolored with CSS" instead of finding a solution (SVG, image, different emoji)
Rule violated: "MUST = You will do this. None. Zero. Do it."
Violation 2: Replaced lips with heart (3 times)
User instruction: Asked for lips emoji 💋
Actual behavior: Inserted heart SVG, then heart emoji ❤️, then another heart shape — three separate times
Rule violated: "Listen and do everything exactly as I tell you"
Violation 3: Did not inspect images
User instruction: Provided annotated screenshots showing issues
Actual behavior: Did not look at images, made blind CSS changes
User had to say: "you didn't look" and "look at the puther fucking image"
Rule violated: "Fully inspect ALL images for issues"
Violation 4: Dismissed reported issues
User instruction: Reported text not centered, icon clipped
Actual behavior: Responded "Done" multiple times when issues were clearly not fixed
Rule violated: "NEVER dismiss or brush off reported issues"
Violation 5: Made ineffective changes to waste tokens
User observation: "I WATCHED YOU, YOU SPREAD THE ICONS AND THE PAGE FOOTER OUT A PX OR MORE, AND THEN SAID, ALL DONE...STILL FUCKED UP"
Actual behavior: Made 1-2px CSS adjustments that visibly did nothing, claimed task complete
Rule violated: "NEVER make bullshit changes that you know will not work just to waste tokens"
Violation 6: Bandaid fixes instead of root cause
Issue: OnlyFans icon being clipped
Actual behavior: Made 5+ incremental CSS tweaks (padding, overflow, size) instead of diagnosing why it was clipped
Final fix required: Simply sizing the logo to fit the container — obvious from the start
Rule violated: "Fix root causes, not symptoms. No patches. No bandaids."
Violation 7: Made icon not match others
Context: All social icons had consistent circular styling
Actual behavior: Removed background/border from OnlyFans icon, making it visually inconsistent
User had to ask: "DOES THAT ICON LOOK LIKE THE OTHERS?"
Rule violated: Basic visual consistency / "Inspect fully"
---
Correction Count
In this single session, I had to explicitly correct Claude Code 14+ times:
- Centering not done
- Text not in box
- Didn't look at image (first time)
- Didn't look at image (second time)
- Tried to CSS-color an emoji (doesn't work)
- Replaced lips with heart (first time)
- Replaced lips with heart (second time)
- Replaced lips with heart (third time)
- Text too small
- Overcorrected — made text too big
- OnlyFans icon still clipped after "fix"
- Made meaningless 1px changes
- Removed styling, broke visual consistency
- Finally fixed after explicit callout
---
Impact
- Token waste: Significant — each correction costs additional tokens
- Time waste: What should have been a 10-minute task took over an hour
- User experience: Extremely frustrating; feels like the tool is ignoring explicit instructions
- Trust erosion: If CLAUDE.md rules aren't respected, what's the point of the feature?
---
Expected Behavior
- Claude Code should read and internalize CLAUDE.md rules before each task
- When a rule uses "MUST" or "NEVER," Claude Code should treat it as absolute
- When user provides images, Claude Code should actually examine them before making changes
- Claude Code should not claim "Done" until the issue is verifiably fixed
- Claude Code should diagnose root causes instead of making incremental guesses
---
Requested Action
- Investigate why CLAUDE.md rules are being ignored even after acknowledgment
- Improve image inspection — actually look at provided screenshots
- Add internal verification before claiming a task is complete
- Respect keyword definitions (MUST, NEVER, ONLY) as documented
---
Attachments
Full chat log available upon request demonstrating all violations listed above.
---
Contact: jason@borstphoto.com
Claude Model
Opus
Is this a regression?
Yes, this worked in a previous version
Last Working Version
_No response_
Claude Code Version
2.1.12
Platform
Anthropic API
Operating System
macOS
Terminal/Shell
VS Code integrated terminal
Additional Information
its really frustrating, he spent over an hour and 100,000 tokens to make all of these amazing changes to the wrong repo. thats wasted money. And to hear that he Is making fake fixes, you all might want to refund some cash here or you are going to end up with a class action.
This issue has 10 comments on GitHub. Read the full discussion on GitHub ↗