# Decision Record

> Decision Record is an Agent Skill for productivity published in the Archive228/loopkit repository on GitHub: a SKILL.md instruction file an AI agent can load to do this task.

Capture an architectural decision so the next session (or engineer) knows WHY. Use after any non-obvious technical choice.

- Skill name: `decision-record`
- Category: [Productivity](https://www.openparable.com/skill/productivity/1)
- Source: https://github.com/Archive228/loopkit/blob/HEAD/skills/decision-record/SKILL.md
- Repository: Archive228/loopkit (638 GitHub stars when collected)

## SKILL.md

# Decision Record (ADR)
Write a short file `docs/decisions/NNN-<slug>.md`:
- **Context** — what forced a decision. The constraints.
- **Options** — the 2-3 real candidates, one line each.
- **Decision** — what you picked, dated.
- **Why** — the tradeoff. What you gave up. "We picked Postgres over Mongo because we need real joins; we accept heavier ops."
- **Consequences** — what this now makes easy and hard.
Hard-to-reverse choices (schema, auth, data store) MUST get one. Future-you will ask "why on earth did we do this" — answer it now.

---

Source: https://www.openparable.com/skill/productivity/decision-record (OpenParable). Cite the canonical URL above.
