There's a single 65-line file that fixes almost every problem people have with Claude Code. It's built from Andrej Karpathy's three biggest complaints about AI coding agents. Drop it in your project folder and Claude reads it automatically.
Andrej Karpathy is one of the most respected voices in AI. He was a founding member of OpenAI, ran AI at Tesla, founded Eureka Labs, and joined Anthropic on May 19, 2026. When he posts about why AI coding agents are broken, the rest of the industry pays attention.
He has three specific complaints about how Claude Code (and every other AI coding agent) actually behaves in the wild. One — silent assumptions instead of clarifying questions. Two — overcomplication: writing 200 lines when 20 would do. Three — touching code you never asked it to touch, sneaking refactors into a 1-line fix.
Someone took those three complaints and turned them into a 65-line CLAUDE.md file. Drop it into the root of any project, and Claude Code reads it automatically at the start of every session. Developers using it report accuracy jumps from around 65% up to 94% on their own benchmark tasks. Setup time: 30 seconds.
When a coding agent isn't sure what you mean, it has two choices: ask, or guess. Almost every coding agent guesses by default, because guessing produces output and asking feels like friction. The result is code that compiles but solves a problem you didn't actually have.
The Karpathy file forces the opposite behavior. Before writing any code, Claude has to either confirm its understanding of the task in one sentence, or surface the specific ambiguity it ran into and ask. Karpathy's framing from his original post:
"The models make wrong assumptions on your behalf and just run along with them without checking. They don't manage their confusion, don't seek clarifications, don't surface inconsistencies."
Ask Claude to add a button and you'll often get back a button, a wrapper component, a styled-components theme update, a config file for the wrapper, and a small refactor of the parent. Five files. One feature. Nobody asked for the abstraction.
The file's second rule is simplicity first: minimum viable code, no speculative abstractions, no preemptive flexibility. If the requirement is to write three similar lines, write three similar lines. The agent only abstracts when there's evidence three things will actually become five.
Most developers have lost an afternoon to this: a one-line bug fix that comes back as a 200-line diff because the agent decided to clean up the file while it was in there. The third rule is surgical changes. Edit only what was requested. Leave everything else alone. Don't refactor adjacent code. Don't rename variables. Don't reformat. If you think the surrounding code is bad, say so — don't silently change it.
There is a fourth rule too: goal-driven execution. Every task gets a verifiable success criterion at the start. Did the test pass? Did the bug repro disappear? Did the rendered output match the screenshot? You can't be "done" until the criterion is hit, and you can't be "done with a bunch of opinions added on" either.
CLAUDE.md from the repo.CLAUDE.md in the root folder of your project. That's the same folder as your package.json or your pyproject.toml or your .git directory.CLAUDE.md automatically at the start of the session. No flags, no commands, no config.If you already have a CLAUDE.md in your project, append the Karpathy rules to the end of your existing file. Claude reads the whole thing.
The file isn't magic. It's just a tight set of rules in a place Claude reads by default. The reason people see 65% → 94% jumps is that Claude Code's default behavior is much sloppier than its capability, and a thoughtful system prompt closes the gap. Comment KARPATHY on the original post and I'll DM you the file plus the install steps as a copy-paste block.
If you're ready to set up Claude for your specific job, with custom skills, connectors, and automations built around the work you do every day, follow along on Instagram for step-by-step guides.
Follow @aiwithunnati →These are the exact AI agents and workflows I use for content creation, automation, and research — automating 90% of day-to-day operations. Stay tuned for the full bundle.
Follow on Instagram →