Engineering brief

Stop Pretending You Understand. Your Codebase Is Too Big.

Theo - t3․gg2 min read · saves 27 min

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

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.