A single 𝗖𝗟𝗔𝗨𝗗𝗘.𝗺𝗱 file just hit #1 on GitHub trending 🤯
It fixes LLMs' worst coding habits using 4 principles from Karpathy:
Karpathy called LLMs out for making wrong assumptions silently. They overcomplicate everything. They edit code they were never asked to change. No pushback. No clarifying questions. They just run.
So those observations were encoded into 4 behavioral constraints:
→ Think before coding. If something’s ambiguous, ask. Don’t pick one interpretation and run. Surface tradeoffs, stop when confused.
→ Simplicity first. Write the minimum code that solves the problem. No speculative abstractions, no flexibility nobody asked for.
→ Surgical changes. Only touch what the task requires. Don’t improve neighboring code, don’t refactor what isn’t broken.
→ Goal-driven execution. Turn vague instructions into verifiable targets before writing a line. “Add validation” becomes “write tests for invalid inputs, then make them pass.”
It works immediately.
Drop the file in your project root and Claude Code follows it from the first task.
One file. Zero dependencies. No setup.
And best part, 100% open source.