# Adr

> Create architecture decision records and design reviews to document technical choices and evaluate open options.

- Skill: `newkayak12/adr` (Agent Skill, multi-file: 5 files)
- Install (CLI): `npx get-skill add newkayak12/adr`
- Raw SKILL.md: https://api.skillmd.com/api/skills/newkayak12/adr/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: newkayak12 (https://skillmd.com/u/newkayak12)
- Updated: 2026-11-15
- Page: https://skillmd.com/skills/newkayak12/adr

---


# ADR

Triggers: ADR, architecture decision record, design review, 설계 리뷰, 결정 기록.

## Process

Pick the format by the signal:

| Signal | Format |
|---|---|
| Decision made | `references/formats/adr.md` (playbook: `references/formats/adr-process.md`) |
| Options open | `references/formats/design-review.md` (playbook: `references/formats/design-review-process.md`) |

A review that ends Approved converts to an ADR; cross-link both in `Related:`.

## Output Template

An ADR saved to `docs/adr/NNNN-<slug>.md`, or a design review saved to `docs/design-reviews/YYYY-MM-DD-<slug>.md`, each in the fixed template of its format file.

## What Claude Does / What You Do

| Claude | You |
|---|---|
| Picks the format, fills the template, numbers and saves the file | State the decision or the question, name the real deciders |
| Flags hedging and an empty Negative consequence | Confirm the rationale and status |

## Related Skills

- `write:prd` — PRD, design doc, RFC, proposal
- `write:plans` — implementation plans, blog, feedback

