Menu

Individual skill

adr-writer

Writes an Architecture Decision Record (ADR) documenting a decision, its context, the options considered, and its consequences. Use to record a decision that's already been made so future readers understand why.

skills/architecture/adr-writer/SKILL.md

Read pinned source

Source commit d0a9928d24afb7df0fad2f2f35f65d3938a6926a

What was checked

Matches the observed repository HEAD
Yes
Scanner rules are current
Yes
Repository scan complete
No
Skill scan complete
Yes
Observed behavior
Instructions only
Last checked
Nov 5, 2026

These are observations at the recorded commit, not a guarantee of safety. Review the source before running it.

Install this skill

Choose an agent in your Stack or copy a command below. Commands fetch the pinned commit and copy only this skill directory. Existing destinations are refused. Copying a command does not install anything.

An install command is unavailable: current rules, complete repository and skill scans, an eligible behavior level and a permitted license are required.

Repository context

Repository stars (not skill ratings)
27
Repository last updated
Aug 20, 2026
License
MIT

Observed agent integration: No specific integration evidence. Standard SKILL.md installation does not imply verified compatibility.

Files and excerpt

File metadata and permitted, redacted excerpts come from the recorded scan. Source links are pinned to that commit.

Browse files
Read excerpt

## Purpose

Document an architectural decision in ADR format — capturing not just *what* was decided, but the context that forced the decision, the alternatives considered, and the consequences accepted. The value is for the reader six months later asking "why on earth is it built this way."

## When to Use

- A significant technical decision has been made and needs to be recorded.
- Onboarding docs keep having to explain the same "why is it like this" question verbally.
- Retroactively documenting an existing decision whose rationale lives only in people's heads.

Pairs with [Decision Maker](../../reasoning/decision-maker/): that skill *makes* the decision by comparing options; this skill *records* a decision in a durable, standard format.

## What to Analyze / Do