Create ADR — Development skill for Claude Code
Record an architecture decision with rigorous alternatives analysis and honest consequences.
How to install Create ADR
Installs to ~/.claude/skills/sellke-writ-create-adr/SKILL.md
mkdir -p ~/.claude/skills/sellke-writ-create-adr && curl -fsSL https://raw.githubusercontent.com/sellke/writ/HEAD/commands/create-adr.md -o ~/.claude/skills/sellke-writ-create-adr/SKILL.md Restart Claude Code, or start a new session, for it to be picked up.
What Create ADR does
name: create-adr description: "Record an architecture decision with rigorous alternatives analysis and honest consequences. For high-switching-cost or convention-breaking choices, not routine technical picks." problem: "A choice with a high switching cost gets made in a conversation and its reasoning evaporates, so the next contributor reopens it or silently contradicts it." outcome: "A numbered record in .writ/decision-records/ states the chosen option, the alternatives it beat, and the con
Alternatives in Development
- Friction Protocol — Friction protocol — convention 29.1k ★
- Migrations — Versioned breaking change migrations for Turbo 263 ★
- Claude Fable 5 Prompt Strategies — Use when composing prompts targeting Claude Opus 5 (Claude 디폴트), Fable 5, Opus 4.8, or Sonnet 5 — 최신 Claude 프롬 176 ★
Full documentation available on GitHub
View Source RepositoryRelated Skills
V ADR
Capture one genuine architecture decision as a thin, human-confirmed ADR under docs/superpowers/adr/NNNN-slug.
Downside Case
Builds the strongest possible case for NOT building a feature. Acts as a rigorous adversary, evaluating opport
Convention
Extract prescriptive CONVENTION rules (and CONVENTION:craft. picks) from an existing codebase. Second link in
Architecture Decision Records
Capture architectural decisions made during coding sessions as structured ADRs. Auto-detects decision moments,
Recall Escalation
Assess the operator's current frustration level from their last turn — calm/mild/escalated/high/breaking_point
Implications
Trace the first- and second-order consequences
Related Agents
ADR Reviewer
Strict Architecture Decision Record reviewer. Reviews ADRs for section completeness, context-decision alignmen
ADR Drafter
Drafts Architecture Decision Records (ADRs) from a decision prompt or discussion. Structures rationale, altern
Timps ADR Writer
Turn a technical decision into a Michael Nygard-style Architecture Decision Record: context, options matrix, d