All writing
Operating PhilosophyMay 5, 2025 · 4 min read

Read the Thesis Before the Code

Architecture is a means, not an end. Before I judge a system, I learn what the business is trying to become.

The thesisBefore the code

When I step into a company, especially a post-acquisition one, the first thing I ask for is not the repository. It is the thesis. What is this business trying to become, on what timeline, and what has to be true for that to happen? Only then does the code mean anything.

Code is evidence, not the verdict

A messy codebase is not automatically a problem, and a beautiful one is not automatically an asset. The only question that matters is whether the technology helps or hurts the thing the business is trying to do. A pile of pragmatic shortcuts can be exactly right for a company racing to a milestone, and a gold-plated platform can be a quiet act of self-indulgence.

I read the investment thesis before I read the code. The job is to protect and compound the value of the asset, not to admire the architecture.

How it changes the work

  • Diligence starts with the business plan, then maps technical risk onto the parts that actually carry the thesis.
  • Remediation is sequenced by value at risk, not by how much a given module annoys the engineers.
  • Roadmaps tie back to the value-creation plan, so the board sees technology decisions in their own language.

Read the thesis first and you spend your limited time and political capital on the things that move the outcome. Skip it and you will do excellent work on the wrong problems. If you want the long version of how this plays out under a deal clock, see the turnaround playbook.

Keep reading
Operating Philosophy · May 12, 2025

Business Before Backlog

Engineering Leadership · Jul 22, 2024

On-Prem to Cloud-Native With Under an Hour of Downtime

Metrics & DORA · Feb 2, 2025

From Low Performer to Elite: A Three-Month DORA Transformation