MADR (Markdown ADR)
A structured index-friendly format: problem, drivers, options, outcome, and confirmation. Pairs well with search and lint rules that look for specific headings.
MADR is a template family, not a standard—teams pin a version in their own docs. The generator output matches the common heading layout used for automation.
The official project lives in the MADR org on GitHub; this site’s template is a compatible subset for quick capture.
Switch format
Markdown template
# <short title>
* **Status:** proposed | accepted | …
* **Deciders:** <names / roles>
* **Technical story:** <issue/URL> · **Date:** <YYYY-MM-DD>
## Context and Problem Statement
What problem exists, in what system boundary, and why a choice is needed now.
## Decision Drivers
- <driver 1: e.g. time-to-ship, compliance, operability, …>
- <driver 2>
## Considered Options
- **Option A** — <one line>
- **Option B** — <one line>
## Decision Outcome
Chosen option: <A>. Link or bullet the commitment (tooling, process, or code structure).
## Consequences
- Positive: …
- Negative: …
- Follow-ups: …
## Pros and Cons of the Options (summary)
Short comparison: why A won for *this* team at *this* time.
## Confirmation
<Staff meeting, RFC ID, or ADR number reference that records acceptance.>
Open generator with this format preselected (also persisted in local storage on this site).