adr

Installation
SKILL.md

ADR Skill

Purpose: Generate permanent, sequentially-numbered Architecture Decision Records (ADRs) from completed plans, specs, or inline decision descriptions. ADRs are the long-lived artifact of the planning pipeline — never auto-deleted or overwritten.

Input

$ARGUMENTS

Accepted inputs:

  • Path to docs/plans/<feature-name>.md — extract decisions from the plan
  • Path to docs/specs/<feature-name>.md — extract decisions from the spec
  • Inline description of a decision — use directly
  • Empty → use AskUserQuestion: "What architectural decision would you like to record? Provide a file path (docs/plans/ or docs/specs/) or describe the decision directly."

Workflow

Step 1: Extract Decision Candidates

Related skills
Installs
9
First Seen
Mar 11, 2026