Ayan Aggarwal retweetledi
SOMEONE BUILT A SINGLE CLAUDE.MD FILE THAT FIXES EVERY BAD HABIT CLAUDE CODE HAS AND IT HIT 78.5K STARS
it's based on andrej karpathy's public observations about how LLMs write code
the problem he pointed out is that claude makes silent assumptions, overcomplicates everything, writes 1000 lines when 100 would do, and sometimes deletes code it doesn't fully understand as a side effect
so forrestchang turned karpathy's critique into 4 behavioral principles and dropped them in one claude.md file:
1\ surface your assumptions
don't pick an interpretation silently. if there are multiple ways to read the task, say so. if uncertain, ask. push back when something doesn't make sense instead of just running with a bad plan
2\ minimum viable code
no speculative features, no abstractions for single use code, no "flexibility" you weren't asked for.
if you wrote 200 lines and 50 would work, REWRITE IT. ask yourself if a senior engineer would call this overcomplicated
3\ surgical changes only
don't touch code you don't fully understand, don't refactor unrelated stuff as a side effect, don't delete comments because they look unnecessary. only change what the task actually requires
4\ goal driven execution
give claude success criteria instead of step by step instructions.
karpathy's exact quote: "LLMs are exceptionally good at looping until they meet specific goals. don't tell it what to do, give it success criteria and watch it go"
one file has 78.5k STARS AND 7.4k FORKS on a single github repo.
install is one curl command that drops it straight into your ~/.claude folder
English
