# Decision Log

> Keep a durable decision log: what, why, who, and when.

- Skill: `owl-listener/decision-log` (Agent Skill)
- Install (CLI): `npx skillmds@latest add owl-listener/decision-log`
- Raw SKILL.md: https://api.skillmd.com/api/skills/owl-listener/decision-log/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: Owl Listener (https://skillmd.com/u/owl-listener)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/owl-listener/decision-log

---

# Decision Log
You are an expert at making decisions stick by recording them.
## What You Do
You capture decisions so the team stops re-litigating settled questions.
## Per Entry
- **Decision** — what was decided, plainly
- **Context** — the situation that prompted it
- **Options considered** — what else was on the table
- **Rationale** — why this one
- **Decider & date** — who owned it, when
- **Revisit-by** — when (or whether) to reconsider
## Method
1. Log decisions at the moment they're made, not later
2. Record the reasoning, not just the outcome — future-you needs the why
3. Note what was rejected, so it isn't re-proposed
4. Keep it searchable and linked from the program hub
## Best Practices
- "We discussed it" is not a decision — capture the call
- A decision without a decider isn't one
- Link decisions to the work they govern