After using Claude Code every day for 10 months, it still surprises me.
In my last Advanced Claude Code workshop, Claude Code outright refused to follow the instructions in CLAUDE.md. It happened to 2 out of 16 learners.
In my last Advanced Claude Code workshop, Claude Code outright refused to follow the instructions in CLAUDE.md. It happened to 2 out of 16 learners.
Here is the setup. CLAUDE.md can live in different subfolders, and each one applies to its own folder. To demo this, we created two subfolders: english-1 and english-2.
In english-1, the CLAUDE.md said “Always write in Singlish.”
In english-2, “Always write in UK English.”
I named the first folder english-1 on purpose, not singlish. I wanted to prove the output is shaped by CLAUDE.md, not by the folder name.
We then prompted Claude Code to:
“Write an article about AI use cases in [industry] and save in @english-1/”
It worked for most learners. But for 2 of the 16 learners, Claude Code did the opposite. It explicitly said that while CLAUDE.md asked for Singlish, the folder is named english-1, so it decided to write in proper English.
One rule I always share about CLAUDE.md: always loaded does not mean always followed, especially once the context window fills up. But this is the first time I have seen Claude Code outright refuse and explain why.
The lesson: an LLM weighs everything in its context, not just the instructions you give it. When your context is confusing, the folder name conflicting with CLAUDE.md here, you are leaving it to luck which signal Claude Code follows.
If you are building with Claude Code, writing good instructions is only half the job. The other half is removing the signals that contradict them.
#AI #ClaudeCode #VibeCoding #AIAgents #BuildInPublic
If you are a non-techie who wants to learn Claude Code from a practitioner, I run a Foundations of Claude Code workshop.
Details: https://lnkd.in/e9r8kScw
If you are already familiar with Claude Code in the Terminal, my next Advanced Claude Code workshop is on 24 Jul, 10am to 6pm. This CLAUDE.md demo is one of the things we do there. We deep dive into context engineering, skills and workflow patterns to run big and long-running tasks (a.k.a. Loop Engineering).
Details: https://lnkd.in/eR6WPQnC
Enjoyed this? Subscribe for more.
Practical insights on AI, growth, and independent learning. No spam.
More in AI Agents
I finally concede that AI is smarter than me.
For 2 years, I held onto reasons like “AI can't solve my kid's homework” or “It can't play tic-tac-toe” to believe I was still smarter.
Don't believe the BS that you can use Claude Code for free.
Ollama recently made their API compatible with Claude Code. Many creators quickly jumped on the opportunity to farm engagement with the hook: "You can now u...
Business+AI Lab with AWS: Event Recap
Held at AWS Singapore, this hands-on GenAI Lab gave participants the rare opportunity to build and deploy their own enterprise-grade chatbot, in under 3 hour...
Not all AI projects need data scientist and AI engineers.
One of the most common mistakes business leaders make in their AI project is getting the wrong team to build.
Why llms.txt Is a Bad Idea for the Web
But seeing "SEO gurus" promote it on authoritative platforms like Search Engine Land and Yoast SEO worries me.
Gemini CLI stubbornly insisted its code was right and even did a Google search to prove it with an outdated article.
I was speechless. 😂
I finally concede that AI is smarter than me.
For 2 years, I held onto reasons like “AI can't solve my kid's homework” or “It can't play tic-tac-toe” to believe I was still smarter.
Business+AI Lab with AWS: Event Recap
Held at AWS Singapore, this hands-on GenAI Lab gave participants the rare opportunity to build and deploy their own enterprise-grade chatbot, in under 3 hour...
Why llms.txt Is a Bad Idea for the Web
But seeing "SEO gurus" promote it on authoritative platforms like Search Engine Land and Yoast SEO worries me.
Don't believe the BS that you can use Claude Code for free.
Ollama recently made their API compatible with Claude Code. Many creators quickly jumped on the opportunity to farm engagement with the hook: "You can now u...
Not all AI projects need data scientist and AI engineers.
One of the most common mistakes business leaders make in their AI project is getting the wrong team to build.
Gemini CLI stubbornly insisted its code was right and even did a Google search to prove it with an outdated article.
I was speechless. 😂