Filed under
Cloud Architecture
8 pieces on this topic, newest first — essays, notes, and case files in one stream.
Developer Advocacy Should Ship Working Software
EssayDeveloper-facing teams build more credible content when their examples survive real implementation, not just polished demos.
How to Run an Architecture Review That Actually Helps
TutorialMost architecture reviews are either rubber stamps or political obstacles. This is a practical guide to running reviews that improve technical decisions without slowing teams down.
Earn Complexity
PrincipleComplexity is not inherently bad. Unearned complexity is. The difference is whether the complexity was added to solve a real, present problem — or to prepare for a future that may not arrive.
Architecture Decision Records as Team Communication
FrameworkADRs are widely prescribed and rarely used well. The reason is almost always that teams treat them as documentation artifacts instead of communication tools. Here is how to use them as the latter.
Optimize for Reversibility
PrincipleNot all decisions are equally expensive to undo. The highest leverage engineering discipline is not making better decisions — it is preserving the ability to change them when you learn more.
How to Write a Technical Spec That People Actually Read
TutorialA technical spec is a decision document, not a documentation artifact. This guide covers how to structure one so it surfaces disagreement early, builds shared understanding, and creates a durable record of why the system was built the way it was.
Build for the Team That Will Maintain It
PrincipleThe best architecture for a system is the one the team that will maintain it can understand, debug, and change confidently. A technically superior architecture that the team cannot navigate is not superior.
Signal vs. Noise in Engineering Metrics
FrameworkMost engineering metrics measure activity, not outcome. A framework for identifying which metrics carry real signal, which generate noise that looks like signal, and how to build a measurement system that actually improves decisions.