Tag
#software-architecture
A Feature Is Not a Service
The ticket said "saved filters". The real decisions were which service, whose identity, and how little to invent.
The Model Is the Easy Part
I put an MCP server in front of a production API. The hard parts were tokens and state, not the model.
Mathematicians vs. Lawyers
Two thinking archetypes I keep meeting in architecture rooms, and why your system needs both.
Pricing the Invisible
Your best architecture work produces nothing observable. Backlogs only rank observables. Let's fix the mismatch.
Multi-Agent Is an Org Chart
I designed a multi-agent AI system and accidentally rebuilt the org chart, failure modes included.
Prompt-Driven Architecture
Part three of the "tools that scale" series: what happens when the daily practice of a Solution Architect starts running on AI.
From Signals to Blips
How a tech radar became my favorite tool for driving an AI transformation across several hundred developers.
The Diagram That Cannot Lie
Why I'm building an architecture modeling tool where the diagram is physically incapable of drifting from the code.
Pricing Is Architecture
The pricing page is an architecture diagram wearing marketing clothes.
Anti-Personas: The Users I Refuse to Serve
The most important architecture document in my side project contains no architecture. It's a list of people I will never build for.
Edge Cases Written by Parliament
What integrating with mandatory government systems taught me about specs you cannot refactor.
ADRs for an Audience of One
My hobby project has eleven Architecture Decision Records and zero users. That ratio is correct.
Questions Are an Architect's Sharpest Tool
The highest-leverage artifact I produce is not a diagram, not a decision record, not a slide deck. It's a list of questions.
The Anti-Corruption Layer Is for People Too
My favorite pattern from Domain-Driven Design protects codebases from foreign models. I keep prescribing it to departments.
The Migration That Never Starts
Every organization has one. Yours does too. It has a folder, a deck, and a birthday.
Diagrams Are Conversations, Not Documentation
The most useful diagram of my career was ugly, partially wrong, and deleted within a week.
Nobody Owns the Sum
Every squad owns its piece. The customer buys the whole. Guess which one has no owner.
Decisions Have an Architecture Too
We design our systems obsessively, then let the decisions about them happen by loudest voice.
Data-Driven Theater
Everyone wants decisions backed by data. Almost nobody asks what the data went through to get there.