1:1 mentoring with Big Tech AI engineers
System Design

Architecture Decision Records

Why an AI decision expires in weeks, the one field that reopens it (a trigger you can watch), an eight-field record, and one worked provider decision priced at 2026-10-08 list prices; the other two decisions shrink to one-line records that link their owners.

Last updated

Staff10 min readFirst read10-Layer Architecture

After this section you can

  • Write a decision record with the eight fields and a trigger a monitor can check.
  • Choose a trigger that stays right when prices change: a ratio, not a fixed volume or dollar line.
  • Supersede a record when its trigger fires, instead of editing it.
43

Architecture Decision Records

Write each AI decision as a numbered record with a revisit trigger a monitor can check, then supersede the record when the trigger fires.

Key idea

An AI decision expires on a schedule you do not set: a retirement comes with at least 60 days' notice. Give each decision a trigger a monitor can check, and supersede the record when it fires.

A record ages: its trigger fires, and a new record supersedes it
ONE RECORD, ONE TRIGGER, ONE LOOP Record accepted, dated revisit_trigger Watch the ratio, monthly API spend ratio Trigger fires ratio at or over 1 Decide draft ADR-0004 owner, action Supersede only the status line changes 1 2 3 4 the new record is watched

Blue input, purple record, teal trigger, amber decision, green outcome. Pans sideways on a phone.

Related

More in System Design

Get full access to all 149 sections with code examples, diagrams, and interactive animations.

Unlock Premium