# ADR-{{NNNN}}: {{Short noun phrase describing the decision}} ## Status {{proposed | accepted | superseded by ADR-NNNN | deprecated}} ## Context {{What is the issue we're seeing that motivates this decision? Describe the forces at play — technical, organizational, business — that make this choice necessary now. State facts, not opinions. Keep it short: one or two paragraphs is usually enough. If a reader needs background that lives elsewhere, link to it instead of duplicating.}} ## Decision {{The choice we've made, written in present tense as a declarative statement. "We will use X." "We adopt Y." Avoid hedging language. One paragraph.}} ## Consequences ### Positive - {{What becomes easier or possible because of this decision?}} - {{What problem is no longer relevant?}} ### Negative - {{What becomes harder, slower, or more expensive?}} - {{What did we accept as a trade-off?}} - {{What new risks does this introduce, and how do we mitigate them?}}