create-adr

Installation
SKILL.md

Create ADR

Produce one ADR per invocation. An ADR records a decision that has already been made; if the decision is still open, use /create-rfc. Follow the five-step process in order: Step 2 validates the mandatory fields, and drafting starts once every one of them is present.

Hard rules

  • Never invent facts. If a mandatory field is missing, ask. Never fill Context, Decision, or Consequences with plausible-sounding filler.
  • Never edit an existing ADR to change the decision. Supersede with a new ADR and link back. ADRs are historical records.
  • Never skip trade-offs. Consequences must be honest — include what becomes harder, not just what becomes easier.
  • Write in the user's language — the one they are using in this session, every section of the document included.

Dispatch

Installs
39
GitHub Stars
19
First Seen
Apr 6, 2026