ADR / MARKDOWN

An architecture decision record with evidence.

Context, options, consequences — and the sources behind the choice.

Copy this structure into your own project and adapt it to your decision.

Context

What decision do we need to make? What constraints matter?

Options

Which options did we consider, and what evidence supports each?

Decision

What have we chosen, and why?

Consequences

What tradeoffs and follow-up work does this choice create?

Evidence

Record each claim, source, date checked and remaining uncertainty.

Revisit

What would make us reconsider this decision?

TAKE THE STRUCTURE WITH YOU
# An architecture decision record with evidence.

## Context
What decision do we need to make? What constraints matter?

## Options
Which options did we consider, and what evidence supports each?

## Decision
What have we chosen, and why?

## Consequences
What tradeoffs and follow-up work does this choice create?

## Evidence
Record each claim, source, date checked and remaining uncertainty.

## Revisit
What would make us reconsider this decision?