You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
65 lines
1.6 KiB
65 lines
1.6 KiB
# ADR Template
|
|
|
|
## ADR-XXXX-YY-ZZ: [Short Title]
|
|
|
|
**Date:** YYYY-MM-DD
|
|
**Status:** [PROPOSED | ACCEPTED | REJECTED | DEPRECATED | SUPERSEDED]
|
|
**Deciders:** [List of decision makers]
|
|
**Technical Story:** [Link to issue/PR if applicable]
|
|
|
|
## Context
|
|
|
|
[Describe the forces at play, including technological, political, social, and
|
|
project local. These forces are probably in tension, and should be called out as
|
|
such. The language in this section is value-neutral. It is simply describing facts.]
|
|
|
|
## Decision
|
|
|
|
[Describe our response to these forces. We will use the past tense ("We will...").]
|
|
|
|
## Consequences
|
|
|
|
### Positive
|
|
- [List positive consequences]
|
|
|
|
### Negative
|
|
- [List negative consequences or trade-offs]
|
|
|
|
### Neutral
|
|
- [List neutral consequences or notes]
|
|
|
|
## Alternatives Considered
|
|
|
|
- **Alternative 1:** [Description] - [Why rejected]
|
|
- **Alternative 2:** [Description] - [Why rejected]
|
|
- **Alternative 3:** [Description] - [Why rejected]
|
|
|
|
## Implementation Notes
|
|
|
|
[Any specific implementation details, migration steps, or technical considerations]
|
|
|
|
## References
|
|
|
|
- [Link to relevant documentation]
|
|
- [Link to related ADRs]
|
|
- [Link to external resources]
|
|
|
|
## Related Decisions
|
|
|
|
- [List related ADRs or decisions]
|
|
|
|
---
|
|
|
|
## Usage Guidelines
|
|
|
|
1. **Copy this template** for new ADRs
|
|
2. **Number sequentially** (ADR-001, ADR-002, etc.)
|
|
3. **Use descriptive titles** that clearly indicate the decision
|
|
4. **Include all stakeholders** in the deciders list
|
|
5. **Link to related issues** and documentation
|
|
6. **Update status** as decisions evolve
|
|
7. **Store in** `doc/architecture-decisions/` directory
|
|
description:
|
|
globs:
|
|
alwaysApply: false
|
|
---
|
|
|