Status: Proposed | Accepted | Deprecated | Superseded by [ADR-YYYY]
Date: YYYY-MM-DD
Deciders: [List of people involved in decision]
Related: [Links to related ADRs, if any]
What is the issue that we're seeing that is motivating this decision or change?
This section should describe:
- The forces at play (technical, political, social, project)
- The trade-offs being considered
- Why this decision is needed now
- Who is affected by this decision
What is the change that we're proposing and/or doing?
This section should describe:
- The specific choice being made
- Key aspects of the solution
- Why this option was chosen
- How it will be implemented (high-level)
What other options were considered?
For each alternative:
- Describe the option
- Explain why it wasn't chosen
- Note any advantages it had
- Description: ...
- Pros: ...
- Cons: ...
- Why not chosen: ...
- Description: ...
- Pros: ...
- Cons: ...
- Why not chosen: ...
What becomes easier or more difficult to do and any risks introduced by the change?
- What benefits does this decision bring?
- What becomes easier?
- What problems does it solve?
- What costs does this decision have?
- What becomes harder?
- What new problems might arise?
- What could go wrong?
- What are the mitigation strategies?
- What debt is this decision taking on?
- When/how should it be revisited?
[Optional] Any specific notes about implementation:
- Migration path from current state
- Breaking changes
- Rollout strategy
- Testing strategy
[Optional] Links to:
- Related documentation
- External articles/resources
- Discussion threads
- Pull requests
- Issues