adr.md•1.86 kB
# ADR [NNN]: [Title]
**Date:** [YYYY-MM-DD]
**Status:** [Proposed/Accepted/Deprecated/Superseded]
**Supersedes:** [ADR link if applicable]
**Superseded By:** [ADR link if applicable]
## Context
[Describe the issue, problem, or opportunity that requires a decision. Include relevant background information, constraints, and requirements.]
### Forces
[List the factors that influence the decision]
- [Force 1]
- [Force 2]
- [Force 3]
## Decision
[State the decision clearly and concisely. What are we doing?]
[Provide more detailed explanation of the decision if needed]
## Alternatives Considered
### [Alternative 1]
**Description:** [What this option entails]
**Pros:**
- [Advantage]
- [Advantage]
**Cons:**
- [Disadvantage]
- [Disadvantage]
**Why Not Chosen:** [Reasoning]
### [Alternative 2]
**Description:** [What this option entails]
**Pros:**
- [Advantage]
**Cons:**
- [Disadvantage]
**Why Not Chosen:** [Reasoning]
## Consequences
### Positive
- [Positive consequence]
- [Another positive consequence]
### Negative
- [Negative consequence or trade-off]
- [Another negative consequence]
### Neutral
- [Neutral impact]
## Implementation
### Changes Required
1. [What needs to be modified/added]
2. [Another change]
### Files Affected
- `path/to/file.ts` - [What changes]
- `path/to/other.ts` - [What changes]
### Migration Path
[If this changes existing behavior, how do we migrate?]
1. [Step 1]
2. [Step 2]
### Timeline
- **Decision Date:** [YYYY-MM-DD]
- **Implementation Start:** [YYYY-MM-DD]
- **Implementation Complete:** [YYYY-MM-DD or "Ongoing"]
## Validation
[How will we know this decision was correct?]
- [Success metric 1]
- [Success metric 2]
## References
- [Link to discussion/issue]
- [Link to documentation]
- [Link to related ADR]
## Notes
[Any additional context, caveats, or future considerations]