# Decision Record

> Use when a change adds a feature or meaningfully changes how something works and the decision behind it has to be written down before implementation — "record this decision", "write an ADR", "open a spec change", "decision record", or the task skill's decision-record step. Detects what the project already uses (an ADR log in MADR, adr-tools or log4brains shape; OpenSpec, Spec Kit or Kiro specs; the CLIs on PATH), writes into that format, and writes a linked ADR-plus-spec pair when the project keeps both.

- Skill: `arasz/decision-record` (Agent Skill, multi-file: 4 files)
- Install (CLI): `npx get-skill add arasz/decision-record`
- Raw SKILL.md: https://api.skillmd.com/api/skills/arasz/decision-record/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Productivity
- License: MIT
- Author: Arasz (https://skillmd.com/u/arasz)
- Updated: 2026-11-14
- Page: https://skillmd.com/skills/arasz/decision-record

---


> **This is the generic copy.** If this project has been scaffolded, prefer the unprefixed
> `decision-record` skill: it is `.ai-badger/skills/decision-record/SKILL.md`, and it has this project's
> extensions and any `project-local.md` merged in. This copy has neither.
>
> The full procedure is in `SKILL.full.md` beside this file, unchanged — read it if the project has no
> `.ai-badger/`, or run `welcome-ai-badger` to scaffold one.

