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 — do not skip Step 2 (validate mandatory fields) or draft before every mandatory field 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.
  • Never write in a language other than the user's. Match the language the user is using in this session.

Dispatch

Installs
32
GitHub Stars
17
First Seen
Apr 6, 2026
create-adr — emiliosheinz/agent-skills