[vibe](../README.md) > [ADR](README.md) > **_template**

<!-- Copy this file to NNNN-kebab-title.md, fill in, delete this note. -->

# ADR-NNNN: Title

> **Status**: Proposed | Accepted | Superseded by ADR-NNNN
> **Date**: YYYY-MM-DD
> **Deciders**: name(s)

## Context

What forces are at play? Describe the problem, the constraints, and the situation that makes a decision necessary. State facts, not opinions. Keep it short enough that a future reader understands *why* a decision was needed without prior context.

## Decision

The decision, stated in the active voice: "We will ...". One clear choice. If the decision has sub-parts, use a short bulleted list.

## Consequences

What becomes easier or harder as a result of this decision?

- **+** A positive outcome / something now enabled.
- **−** A trade-off / cost / new constraint accepted.
- **→** A future follow-up this implies (work deferred, a door left open, a re-evaluation trigger).

## Alternatives considered

| Option | Why not |
| --- | --- |
| Alternative A | Reason it was rejected. |
| Alternative B | Reason it was rejected. |

## QA & validation

How was (or will be) this decision validated? Tests, smoke checks, manual verification, rollback plan, or the criteria that would tell us the decision was wrong.

## References

- Link to the PR that introduces this ADR (and ensure the PR links back here).
- Related ADRs, PRDs, investigations, or external docs (descriptive link text, never "here"/"this").