Engineering brief
Stop Pretending You Understand. Your Codebase Is Too Big.
At a glance
- Relevance
- Practical value
- Warnings
- None
Nobody fully understands a large codebase. The best engineers don’t memorize—they build intuition.
Shifts focus from understanding code to managing systems with incomplete knowledge.
Summary
The video argues that believing you must fully understand a large codebase is a misunderstanding of how modern software works. For systems with millions of lines of code and high turnover, completeness is impossible and counterproductive. The real skill is having an intuition for where things belong, not memorizing every line. This is supported by
examples from working at Twitch and Amazon. The speaker defends 'partial understanding' as the default state for engineers on large systems. The key tradeoff is between pure engineering ideals (maintaining a perfect mental model) and the impure reality of shipping features on time. Good codebases are designed so that incomplete knowledge doesn't block work, relying
on good architecture and tooling like type systems. The discussion extends to AI, noting that coding agents experience '100% turnover' every new thread, which makes them a test case for working without historical knowledge. The speaker finds this both challenging and rewarding, as it forces engineers to focus on steering outcomes rather than micromanaging implementation
details. The core tension is between the desire for a perfect theory of the program (from Peter Naur's paper) and the practical reality of large-scale systems where nobody has one. The conclusion is that modern engineering is about managing partial understanding, not achieving omniscience. This is a useful reframe for leaders dealing with legacy systems
Watch the video
This video is blocked due to your privacy settings. To watch this video, please accept YouTube marketing cookies.
Related breakdowns
Codex Brand Killed by OpenAI’s ChatGPT Merge
Codex is now just a mode in ChatGPT. The branding erasure may cost OpenAI developer trust, even if the underlying tech improves.
AI Makes Rebuilding NPM, Git, and Slack a Small-Team Sport
Theo argues AI agents make rebuilding foundational tools like NPM and Git feasible for small teams—but network effects remain the real barrier.
Code Quality Has a Simple Answer: It Depends on Disposability
A practical framework for deciding when code quality matters: disposable software needs none, durable software needs all. The real work is making rigor cheap.
Get TL;DW
Too Long; Didn't Watch.
A concise breakdowns of the AI and devtools videos that actually matter for engineering leaders.
Free. Weekly. No hype.
Video and thumbnails remain the property of their respective creators. tldw.news provides editorial analysis, commentary, and discovery links to original content.