Decision record (decision log entry)
OfficialOfficial · updated Nov 4, 2026 · v1.0.0
Records a decision as a short log entry: the decision, context, options considered, why, who decided, the date, status, and a revisit trigger.
Sign up free to add this skill to your pod
You come back here after you sign in, and add it with one click.
When to use it
- A team just decided something costly to reverse or likely to be questioned
- People keep asking why something was chosen and the answer isn't written down
What you give it
- What was decided and by whom
- Date
- Options discussed and why they lost
- Thread, minutes, or doc (optional)
What you get
A numbered Markdown decision-log entry with status, decider, context, options, reasons, consequences, and a revisit trigger.
Changelog
- v1.0.0 · Nov 4, 2026 · First release.
Sources
- Documenting architecture decisions (Michael Nygard, Cognitect) (2026-11-04)
- Architectural Decision Records (ADRs) (2026-11-04)
- Architectural Decision Record Framework (GOV.UK) (2026-11-04)
- DACI: a decision-making framework (Atlassian Team Playbook) (2026-11-04)
Related skills
- Decision memo Writes a short narrative decision memo: recommendation first, context, options with trade-offs, risks, and the ask with a decider and deadline.
- Meeting minutes with action items Turns a transcript or rough notes into minutes: decisions, action items with one owner and a due date each, and open questions.
- Meeting agenda (or cancel it) Builds an agenda from a goal and attendees: one outcome, timed questions with owner and type (decide, discuss, inform), pre-reads, or a recommendation to cancel.
- Project kickoff brief Writes a one-page kickoff brief: goal, one success measure, scope in and out, milestones, a RACI-lite table, top risks with owners, and how the team talks.