# ADR Authoring

> ADR Authoring

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

---


# ADR Authoring

Purpose: Record important technical decisions with alternatives and consequences.

1. State context and constraints.
2. Name the decision in specific terms.
3. List at least two alternatives.
4. Include positive and negative consequences.

Checklist:

- One decision only.
- Alternatives are plausible.
- Downsides are explicit.
- Follow-up decisions are named.

Positive example: choose local-first Postgres plus Temporal because durable state is load-bearing.
Negative example: "use modern tech" without alternatives.

Failure modes: advocacy without tradeoffs, vague consequences, combined decisions.