[Proposed | Accepted | Deprecated | Superseded by ADR-NNN]
Describe the forces at play, including technical, business, and team constraints. What problem or question prompted this decision? What alternatives were considered?
Include specific evaluation criteria and observations about each alternative. Code examples of the competing approaches are encouraged.
State the decision clearly and concisely. Explain the chosen approach with code examples where applicable.
Include guidance on:
- The default/recommended pattern
- When to deviate from the default
- How to implement the decision in practice
List the benefits of this decision.
List the drawbacks and tradeoffs.
Describe how the negative consequences are addressed (e.g., which skills, agents, or knowledge documents help).