Skip to content

Blog

Architecture Review: What It Covers and When You Need One

What a software architecture review looks at, when it is worth doing, what you should get at the end, and how to prepare so it answers the questions you actually have.

3 min read · Dino Correia
architecture-reviewsolution-architecturetechnical-decision-making

TL;DR

  • An architecture review is an independent look at a system to find where the risk sits, what slows the team down, and what to change first.
  • It is worth doing before a big investment, after a period of fast growth, when delivery keeps slowing, or when a decision needs a second opinion.
  • A good review ends with a prioritised list of changes and the reasoning behind each one, not a list of everything that could be better.
  • Prepare by stating the question you want answered, and by giving the reviewer access to the people who know the system.

An architecture review is an independent look at an existing system: how it is structured, where the risk sits, what is making change slow or expensive, and what to fix first. It is not an audit with a pass mark. The useful output is a short, prioritised list of changes, each with the reason it matters, that the team can act on.

When a review is worth doing

  • Before a big investment. A new product line, a large migration, or a funding round where someone will ask whether the system can carry the plan.
  • After fast growth. The system grew around deadlines, and nobody has stepped back to look at the whole.
  • When delivery keeps slowing. Every change touches more than it should, and estimates keep slipping.
  • When incidents repeat. The same kind of failure keeps coming back in different places.
  • When a decision needs a second opinion. A rebuild, a re-platform, or a vendor choice, where the people closest to it have a stake in the answer.

If none of these apply, you may not need one. A review is most useful when there is a real decision or a real pain behind it.

What a review looks at

AreaThe question
StructureDo the boundaries between components match how the business actually changes?
DataWho owns each piece of data, and how many copies of the truth are there?
IntegrationsWhat happens when an external system is slow, down, or changes its API?
ReliabilityWhere are the single points of failure, and how would you know something broke?
SecurityHow are access, secrets and sensitive data handled in practice, not on paper?
DeliveryHow long does a small change take to reach production, and what slows it down?
CostWhich parts cost more to run or change than they’re worth?
Team fitCan the current team understand, operate and change what exists?

Not every review needs every row. The question you start with decides which ones get the most time.

What you should get at the end

  • A current-state picture: the systems, how they connect, and where data lives, as it really is.
  • The main risks and constraints, ranked by likelihood and impact.
  • Observations about the architecture: what is working and should be protected, as well as what isn’t.
  • Options for the important problems, with trade-offs.
  • A recommended direction and a prioritised list of changes, so the team knows what to do on Monday.

A review that ends with forty equally weighted findings hasn’t finished its job. The prioritising is the valuable part.

How to prepare

  1. State the question. “Can this system support ten times the customers?” leads to a very different review than “Why does every release break something?”
  2. Gather what exists. Diagrams, decision records, incident reports, deployment setup. Out of date is fine; it shows where reality drifted.
  3. Book time with the people who know. The engineers who built it, the people who operate it, and someone who knows what the business needs next.
  4. Agree what happens after. Who receives the findings, and who decides what to act on.

Internal or external reviewer?

An internal reviewer knows the history. An external one has no stake in past decisions, which makes it easier to say that a choice no longer fits, and easier for the team to hear it. For a system behind a big decision, an outside view is usually worth it. For regular health checks, an internal review against a shared checklist works well, and the Well-Architected pillars are a reasonable starting structure.

If you’re facing one of the situations above, an architecture review typically takes one to three days and ends with exactly that prioritised list. For a review focused on an acquisition or investment, see the technical due diligence checklist.

Where this leads

  1. If this is the situation you're in

    Architecture Review →

    An independent look at an existing system: where the risk sits, what is slowing you down, and what to fix first.

  2. Or skip ahead

    Let's talk: tell me about the problem →

Related articles

Blog

Technical Due Diligence Checklist: What to Look At

A technical due diligence checklist for investors and acquirers: architecture, code and delivery, data, security, infrastructure costs, third-party dependencies, and the team.

· 3 min read
architecture-reviewchecklisttechnical-decision-making
Read →

Blog

Build vs Buy: How to Make the Decision (and Not Regret It)

How to decide whether to build, buy, or integrate software: the questions that matter, the hidden costs on both sides, and when each option wins.

· 4 min read
technical-decision-makingsolution-architecture
Read →

Blog

Solution Architecture Document: What to Include (+ Template)

What to include in a solution architecture document: problem, requirements, options, design, integrations, data, risks, and decisions. Template included.

· 7 min read
solution-architecturedocumentationdecision-records
Read →

Working through something similar?

I help untangle problems like this one.