Does Code Quality Still Matter? It Depends on This — Max Kanat-Alexander, Capital One

By ai.engineer

Categories: AI, Tools

Summary

Code quality matters exclusively for two things: understanding system behavior and safely executing changes. Max Kanat-Alexander debunks the 'it depends' answer by providing a concrete framework showing how structure reduces modification risk and prevents future problems—making quality ROI measurable, not subjective.

Key Takeaways

  1. All software success reduces to two factors: understanding the system's actual behavior and executing on that understanding. Code quality tools (debuggers, tests, observability) exist solely to improve these capabilities, not correctness.
  2. System modifications carry two quantifiable risk categories: introducing immediate problems and making future changes harder. Both stem from understanding gaps, making structure the core lever for risk reduction.
  3. Code structure is the fundamental reason code exists at all. Readable, organized components allow engineers to describe subsystem behavior precisely; unstructured code becomes ungrokable at scale (billions of lines).
  4. Post-mortems reduce to two root causes: systems too hard to understand or systems made harder to understand by changes. Use this framework to evaluate whether code quality investments prevent future incidents.
  5. Replace 'it depends' with measurable criteria: Does this change increase understanding risk or future modification risk? Framework-based reasoning replaces subjective code quality debates with concrete risk assessment.

Related topics

Transcript Excerpt

[music] >> So, today I figured I'd just pick a nice uncontroversial topic that nobody has any opinions about. Right? Nobody nobody said anything on about on this about social media, you know, and of course every take about this on social media is like really deeply nuanced, you know, like people have lots of like depth and like, you know, really big thoughts. You know, maybe there's a little bit more to it than like yes or no. And you know, of course if you ever ask a senior engineer a question, we always have the same answer to every question, every senior engineer's favorite answer to every question, which is it depends. Now, that's not a very helpful answer though, frankly, because what does it depend on? So, let's start with this. Why did code quality ever matter in the first place? Li…

More from ai.engineer