Skip to main content

Frontend Architecture Operating Model

Why this chapter matters

Architecture fails when it is only a set of opinions held by one senior person. A frontend architect needs an operating model: how decisions are proposed, reviewed, adopted, measured, and retired.

This chapter defines the minimum operating system for architecture work before the advanced governance chapters.

The operating loop

Intake

Architecture work enters through signals:

SignalArchitect response
repeated implementation debateturn the debate into a decision record
production incidentidentify the missing constraint or fitness function
product strategy shiftupdate boundaries, ownership, and quality targets
slow deliverydistinguish code debt from ownership or platform debt
quality regressionadd review gates or automated checks
migration pressuredefine strangler path and compatibility contract

Classification

Not every issue deserves the same weight.

ClassExamplesArtifact
local designcomponent API, local module splitshort note or PR comment
cross-feature decisionshared state, API contract, package boundaryADR
platform decisionbuild system, design system, observability, authRFC and rollout plan
high-risk launchcheckout, billing, identity, AI tool actionreview packet and readiness gate

Review cadence

Use lightweight ceremonies:

CadencePurpose
weekly architecture triageclassify new decisions and risks
biweekly design reviewreview ADRs/RFCs before irreversible work
monthly quality reviewinspect budgets, incidents, accessibility, security, dependency risk
quarterly architecture health reviewretire old standards, update roadmap, rebalance ownership

Ownership model

Architecture ownership should be explicit.

AreaOwner question
product surfaceWho owns user outcome and operational quality?
platform capabilityWho owns contracts, upgrades, documentation, and support?
shared componentWho owns API stability, accessibility, and deprecation?
dependencyWho owns version policy and incident response?
metricWho owns interpretation and action when it regresses?

Fitness functions

Operating models need signals, not vibes.

ConstraintExample fitness function
route costbundle budget and Web Vitals threshold
accessibilitykeyboard/focus smoke test plus component a11y contract
ownershipmodule boundary lint and dependency ownership map
design systemno new raw color usage outside token package
securityCSP violation budget and Trusted Types adoption
reliabilitycritical route error budget and rollback drill

Review checklist

  • Is architecture intake visible to teams?
  • Are decisions classified by risk and reversibility?
  • Are review cadences light enough to survive delivery pressure?
  • Does every shared capability have an owner?
  • Are architecture constraints measured through fitness functions?
  • Is retirement/deprecation part of the process?

Exercises

  1. Draw your team's current architecture operating loop.
  2. Classify the last five frontend architecture debates by decision class.
  3. Define three fitness functions that would have prevented a recent regression.

Source lens

This chapter is the Part 0 baseline for Part IX governance, Part XII review programs, and the capstone solution packs.