Architecture Decision Records

Each file here records one design decision: the context that forced it, what was decided, what it costs, and the alternatives that were rejected. The records outlive the commits and review threads that produced them, so a later change can tell a deliberate choice from an accident.

• File name: YYMM-NN-short-title.md, numbered in order. Numbers are never reused.
• Status: Accepted, Superseded by YYMM-NN, or Deprecated. An accepted record is not edited to change its decision; write a new record that supersedes it.
• Sections: Status, Context, Decision, Consequences, Alternatives considered.