Status: [Proposed | Accepted | Rejected | Superseded by ADR-NNN] Date: YYYY-MM-DD Context: [One sentence on what triggered this decision]
[The single sentence stating the decision. If this can't be written in one sentence, the decision isn't crisp enough yet.]
[2-4 paragraphs on the situation that requires a decision. Include:
- What system/spec/strategy this affects
- What problem exists today
- What constraints apply
- Who is affected]
Pros:
- [Specific benefit]
Cons:
- [Specific cost]
Pros:
- [Specific benefit]
Cons:
- [Specific cost]
[Add more options as needed. Always include at least 2.]
[Why the chosen option wins. Be specific. "It's better" is not a rationale. "It reduces migration cost by 80% and matches existing conventions in the dotfile pattern" is.]
[Concrete actions, file paths, surfaces, owners]
[How existing users/code/data transition to the new state]
[How this gets announced internally and externally]
- Q approves
- Q rejects (alternate selected: ___)
- Q requests further discussion
[State whether this decision blocks anything downstream]