# ADR Template

Use this template when creating new Architecture Decision Records.

---

# ADR-XXX: Title

## Status

**Proposed** | **Accepted** | **Deprecated** | **Superseded by [ADR-XXX](XXX-link.md)**

## Date

YYYY-MM-DD

## Context

What is the issue that we're seeing that is motivating this decision or change?

Describe:
- The problem or requirement
- The constraints we're working within
- Any relevant background information

## Decision

What is the change that we're proposing and/or doing?

State the decision clearly:
- What technology/approach did we choose?
- Why did we choose it?
- What alternatives were considered?

## Alternatives Considered

### Option 1: [Name]
- **Pros**: ...
- **Cons**: ...

### Option 2: [Name]
- **Pros**: ...
- **Cons**: ...

## Consequences

What becomes easier or more difficult to do because of this change?

### Positive
- Benefit 1
- Benefit 2

### Negative
- Trade-off 1
- Trade-off 2

### Neutral
- Change 1
- Change 2

## References

- Link to relevant documentation
- Link to related issues/PRs
- External resources