Decision record

One ADR — options side by side, the call itself in a callout.

Use this templateDocs template
Decision recordOne ADR — options side by side, the call itself in a callout.

Decision: <the choice, stated as the outcome>

Status: Proposed · Date: <date> · Deciders: <names>

Status vocabulary: Proposed · Accepted · Superseded.

Context

What forces this decision now, and <what happens if you don't make it>.

We need conflict-free multiplayer editing across web and mobile, including offline. Three upcoming features depend on the answer, so the choice can't wait.

Options considered

A path from options through a decision to its consequences

<Option A>

  • <What it gives you>
  • <What it costs you>

Option B — CRDTs

  • Converge without a central server; offline-friendly
  • Higher memory per doc, needs periodic compaction

Decision

Important

We chose <option> because <the single constraint that decided it>.

Consequences

  • Easier: <what this unlocks>
  • Harder: <what you now own forever — say it plainly>
  • Watch: <the metric that tells you this was wrong>