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.
Hardware ceilings, not hotspots, should drive your optimization strategy
Casey Muratori argues that the best optimizers don't start with a profiler. They start with the hardware's theoretical maximum. Your team's architecture is…
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.