Every developer knows this feeling: you open a repo you've never seen before — maybe for a new job, a contribution, an audit, or just curiosity — and you're suddenly playing detective. Cmd+Shift+F for a function name. Scrolling through a 2,000-line file trying to figure out who calls what. Reading a README that was last updated two major versions ago.
It's not that the code is badly written. It's that understanding a codebase is fundamentally different from reading it. You don't need every line — you need answers to questions like:
"How does authentication actually work here?"
"Where would I add a new API route?"
"What does this PR change, and is it risky?"
