# Craft Adr

> Recording architectural decisions. Why we chose X over Y.

- Skill: `attac-t/craft-adr` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add attac-t/craft-adr`
- Raw SKILL.md: https://api.skillmd.com/api/skills/attac-t/craft-adr/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: attac-t (https://skillmd.com/u/attac-t)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/attac-t/craft-adr

---


# Skill: Craft ADR

> "Decisions in code are temporary. Decisions in ADRs are permanent."

## The Standard

1. **Location**: `docs/{domain}/ADR/ADR-001-title.md`.
2. **Status**: Proposed → Accepted → Deprecated.
3. **Structure**: Context → Decision → Consequences.
4. **Rationale**: Document what was rejected and why.

## When to Record

| Record               | Don't Record      |
|----------------------|-------------------|
| Package choice       | Trivial fixes     |
| Pattern choice       | Standard CRUD     |
| Schema design        | Config changes    |
| Integration approach | Obvious decisions |

## Real-World Examples

See [examples.md](examples.md).