liveBook · Manning

Architectural decision

As explained in Software Architecture Decision-Making

An architectural choice is a selected approach to a software system's technical structure or operation.

An architectural decision is a selected approach to a system’s technical structure or operation, made under delivery and operational pressure rather than approved once on a diagram. It turns intent into a viable direction while accepting that time, cost, skills, legacy dependencies, ownership, security, and risk tolerance limit what can be built and sustained. section 1.0 section 1.1

The central task is not to find a universally best pattern or technology. It is to make trade-offs explicit: better performance can raise operating cost, faster delivery can create rework, and cleaner separation can exceed a team’s capacity to operate it. Consequences often emerge gradually as loss of control, clarity, or flexibility makes change expensive. section 1.1 section 3.7

Ground a significant decision before committing by examining:

  • Intent: identify the outcome the system must support rather than beginning with a solution. section 1.1
  • Technical objectives: clarify vague requests into response-time, throughput, recovery, boundary, and operational requirements. section 1.4
  • Forces: assess deadline, total cost of ownership, team capability, risk tolerance, ownership, and the wider project landscape. section 2.6
  • Shared consequences: involve stakeholders, developers, operations, security, and finance early enough to expose conflicts and accepted risks. section 1.5
  • Feedback: revisit the choice as constraints, requirements, and production evidence change. section 1.8 section 2.7
Figure 1.1 Architecture as a feedback loop. Intent is shaped by forces, translated into decisions, and tested through consequences, feedback, and adaptation.

Use the feedback loop to keep a decision connected to its original intent, the forces shaping it, its consequences, and the evidence that may require adaptation. section 1.1

Choosing a reporting architecture

For modest, predictable reporting owned by a small team, cost, capability, and ownership can outweigh extreme scale or real-time performance. A viable choice is one structured application, scheduled refreshes, a managed relational database, sufficient observability, and explicit ownership—while avoiding assumptions that make later change costly. The point is not that this design is always right, but that it fits the stated pressures better than premature distributed complexity. section 2.6

Some decisions deserve greater rigor because compromise is less acceptable around security, data integrity, compliance, and mission-critical resilience. Other choices should be delayed until the last responsible moment, when enough is known to act without closing future options too early. Treat managed services similarly: adopt them when they reduce real burden and fit operational ownership, not merely because they are available. section 3.7 section 4.6

How Software Architecture Decision-Making covers it

How deep it goes
Explains decision-making through forces, trade-offs, feedback, and a six-question assessment, without prescribing a universal technical solution.
Examples
Uses a small-team reporting capability and contrasts managed services, self-operated platforms, serverless, containers, and integration styles.
What it assumes
Starts from vague stakeholder intent and teaches its translation into concrete technical objectives through clarification.
What you can do after
Evaluate/understand architectural options by making forces, ownership, trade-offs, and changing consequences visible before commitment.
How it connects
Connects intent, technical objectives, trade-offs, risk tolerance, ownership, technical debt, observability, and managed services.

Also explained in

Compare how 6 books explain architectural decision →

Related concepts

This explainer was generated by Manning's knowledge graph from the text of Software Architecture Decision-Making. The section links point to the parts of the book it draws on.