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