Architecture Decision Record

Use this template when recording a significant technology or design decision. Completed ADRs belong in the decisions/record/ section of this site.

When to Use

• A technology choice affects multiple components or teams.
• An architectural pattern is being established or changed.
• A trade-off needs to be documented for future reference.
• Reverting a previous decision (mark the old ADR as “Superseded”).

Target Section

decisions/record/

Template

---
title: "ADR-NNN: Decision Title"
tags: [adr, decision]
domain: decisions
maturity: published
author: Principal Engineer
---

# ADR-[NNN]: [Decision Title]

**Author**: Principal Engineer
**Date**: YYYY-MM-DD
**Status**: Proposed | Accepted | Deprecated | Superseded by ADR-[NNN]

## Context

Describe the situation that requires a decision. Include:

- The problem or requirement driving the decision.
- Relevant constraints (technical, business, timeline).
- Links to related features, issues or prior ADRs.

## Decision Drivers

- List the criteria used to evaluate options (e.g., performance, maintainability, team familiarity, cost, security).

## Options Considered

### Option A: [Name]

- **Description**: How this option works.
- **Pros**: Benefits of this approach.
- **Cons**: Drawbacks and risks.

### Option B: [Name]

- **Description**: How this option works.
- **Pros**: Benefits of this approach.
- **Cons**: Drawbacks and risks.

### Option C: [Name] (if applicable)

- **Description**: How this option works.
- **Pros**: Benefits of this approach.
- **Cons**: Drawbacks and risks.

## Decision

State the chosen option and the rationale.

> We chose **Option [X]** because [reason]. The primary factors were [decision drivers that favored this option].

## Consequences

### Positive

- List the benefits of this decision.

### Negative

- List the trade-offs and costs accepted.

### Neutral

- List effects that are neither positive nor negative but worth noting.

## Follow-Up Actions

- List any tasks, implementation plans or documentation updates required as a result of this decision.