ADR-000: Template
Status
Proposed
Context
Describe the issue or problem that needs a decision. Include:
- What forces are at play (technical, business, team)?
- What constraints do we have?
- What requirements must be met?
- What is the current situation that led to this decision?
Be factual and objective. Avoid proposing solutions in this section.
Decision
State the decision clearly and concisely.
We will [action/approach].
Provide details about:
- What will be implemented
- How it will work
- Key design elements
Consequences
Positive Consequences
- Benefit 1: Description
- Benefit 2: Description
- Benefit 3: Description
Negative Consequences
- Drawback 1: Description
- Drawback 2: Description
- Risk 1: Description
Neutral Consequences
- Change 1: Description
- Impact 1: Description
Alternatives Considered
Alternative 1: Name
Description: Brief explanation
Pros:
Cons:
Reason for rejection: Why we didn’t choose this
Alternative 2: Name
Description: Brief explanation
Pros:
Cons:
Reason for rejection: Why we didn’t choose this
References
- Link to related documentation
- Link to discussions or issues
- Link to external resources
Date: YYYY-MM-DD
Author: Name
Reviewers: Name1, Name2