| Status | 🟡 Proposed / 🟢 Accepted / 🔵 Superseded by ADR-NNN |
| Created | YYYY-MM-DD |
| Last Updated | YYYY-MM-DD |
| Deciders | Name |
| Tags | template |
Describe the background and constraints written for future human and AI developers.
Summarize the main challenge in one or two sentences. Then, phrase the decision explicitly as a question.
Use the table below to evaluate your options against key decision drivers.
- Define your drivers — the forces, constraints, or architectural qualities that matter most (e.g. scalability, maintainability, observability, budget, effort). Add each driver as a column name.
- List your options — add each considered solution as a row.
- (Optional) Assign weights to drivers to show relative importance.
- Describe each option — one line summary.
- Score each option for how well it satisfies each driver using the legend: ✅ = 3 (Good)
⚠️ = 2 (Acceptable) ❌ = 1 (Poor) - Compute overall score:
overall score = (Driver1 weight × Driver1 score)
+ (Driver2 weight × Driver2 score)
+ ...
+ (DriverN weight × DriverN score)
- (Optional) Add short notes on the main pros and cons for each option.
- (Optional) Sort the rows according to the overall score (best fit at the top)
| Option | Description | Driver 1 | Driver 2 | Driver N | Overall score | Notes |
|---|---|---|---|---|---|---|
| Weight | - | 1 | 1 | 1 | - | |
| A | ||||||
| B | ||||||
| C |
✅ = 3 (good),
We will use Option X because...
Justify your choice using the results of the decision matrix above. Describe evidence to support the scoring.
- Good, because...
- Bad, because...
- Unknowns/risks
How will you ensure this ADR is implemented and enforced?
| Type | Links |
|---|---|
| ADRs | |
| Issues | |
| PRs |