# ADR-NNNN: Short decision title ## Status Proposed | Accepted | Superseded by ADR-XXXX ## Context What forces are in play? What problem or constraint triggered the decision? Keep it to the facts that actually shaped the choice. ## Options | Option | Pros | Cons | | --- | --- | --- | | A — … | … | … | | B — … | … | … | (Drop this section when only one option was ever real.) ## Decision The choice, stated plainly. One paragraph. ## Consequences - What becomes easier. - What becomes harder or is now forbidden. - Follow-ups, links to affected docs.