Tag
#software-architecture
The Model Grades Its Own Homework
Sorting changes by risk is the right idea. Letting the agent's confidence set the class is the one input that turns every gate behind it into decoration.
Every Approval Is a Missing Rule
If the architects do not write the rules the agents read, the person who writes the template does. Notes from reviewing an operating model for agentic delivery.
Turn the Sequence Diagram on Its Side
The people who can tell you a boundary is wrong were never going to read UML. Turn the sequence diagram on its side and they do not have to.
We Deleted the Wrong Half of Agile
Reviewability is something you design. Extreme Programming already knew how, and we made exactly the wrong half of it optional.
Design the Stopping Point
Target state is the easy half of a solution design. The hard half is the first step, because that is usually where the money runs out.
Adoption Is the Deliverable
The ugliest service in production beats the most elegant one nobody calls. So where exactly does an architect's job end?
The Bottleneck Moved
AI made writing code cheap. Our squad reports show where the queue went next: to the people who have to read it.
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 artifact of mine that pays off most is not a diagram and not a decision record. 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.