adr.zone

← All templates

Nygard-style ADR

A minimal Markdown ADR: status, context, decision, consequences. The shape popularized in engineering blogs and the adr-tools ecosystem.

Number files consistently (ADR-0001-*.md or your org scheme). The decision section should be quotable in a PR comment; context should be short and force-oriented.

What is an ADR for the broader idea.

Switch format

Markdown template
# ADR-0001: <short title in Title Case>

## Status
Proposed

## Context
Describe the situation: constraints, options considered briefly, and why a decision is needed.

## Decision
State the decision in plain language. Link to ADRs that this supersedes or extends.

## Consequences
- Positive: …
- Negative: …
- Neutral / follow-ups: …

Open generator with this format preselected (also persisted in local storage on this site).