Skill: ADR Create

What This Skill Does

Documents a technical decision as it happens using the ADR (Architecture Decision Record) format. While retrospective reconstructs past decisions from git history (inferring context), this skill captures the full decision context in real-time — including alternatives considered, trade-offs evaluated, and expected consequences.

When to Use

• When making a significant technical decision (new dependency, architecture change, pattern choice)
• When the user says "let's document this decision" or "why did we choose X?"
• Before implementing a controversial or non-obvious approach
• When create-plan involves architectural choices that should be recorded

Execution Model

• Always: the primary agent runs this skill directly.
• Output: docs/adrs/ADR-NNN-<title>.md

Workflow