Architecture Decision Records

ADRs record hard-to-reverse, surprising, trade-off decisions for Activity Browser.

• Format: short title + 1–3 sentences (see template.md); optional Status / Options / Consequences when useful.
• Numbering: NNNN-slug.md, increment from the highest existing number.
• New ADRs are often created during /grill-with-docs / /domain-modeling.

Read ADRs that touch the area you are changing. If your change contradicts an ADR, surface that explicitly.