MarkThatDownTemplates
Record the context, options, chosen approach, and consequences. The template keeps the reasoning available when the same question returns.
# Decision record
Decision. [Short title]
Status. [Proposed or accepted]
Date. [Date]
Owner. [Name]
## Context
[Problem and constraints]
## Options considered
| Option | Benefit | Cost |
| --- | --- | --- |
| [Option] | [Benefit] | [Cost] |
## Decision
[Chosen option and reason]
## Consequences
- [Tradeoff we accept]
## Revisit when
- [Condition that changes the reasoning]
An ordinary Markdown file. No signup required.
Name the constraint that drove the choice. Include the strongest alternative so future readers understand the tradeoff.
Use an observable change, such as a dependency or requirement. A record can explain a past decision without pretending it remains correct forever.
Reviewed October 2, 2026. Maintained by Humenhuk.
Original practical template. Adapt the examples to your own work.