AI Disruption

AI Disruption

CLAUDE.md Wrong—Don’t Blame Claude Code

Fix your CLAUDE.md: 60 lines, universal rules, let Claude Code finally obey.

Meng Li's avatar
Meng Li
Dec 14, 2025
∙ Paid

“AI Disruption” Publication 8400 Subscriptions 20% Discount Offer Link.


Why does Claude Code’s coding effectiveness vary so much?

Even when the prompts are incredibly detailed, Claude Code just won’t follow them. Even if you follow what other marketing accounts preach and write everything in CLAUDE.md, it still doesn’t work?

The problem is that your CLAUDE.md is written incorrectly, and init is used incorrectly.

Essentially, CLAUDE.md is Claude Code’s context - it gets injected into the conversation context every time a session starts.

The biggest truth about Claude Code is that it actively ignores your CLAUDE.md.

Yes, it completely disregards it!

When Claude Code injects CLAUDE.md, it comes with a system prompt that roughly means “this content may or may not be relevant, judge for yourself.”

In other words, if your content is too messy, too long, or completely off-topic, Claude will selectively skip it entirely.

So how should you write it?

User's avatar

Continue reading this post for free, courtesy of Meng Li.

Or purchase a paid subscription.
© 2026 Meng Li · Privacy ∙ Terms ∙ Collection notice
Start your SubstackGet the app
Substack is the home for great culture