Documenting Decisions

Capture architectural decisions as Architecture Decision Records (ADRs).

Purpose

Design decisions made during brainstorming and planning need a standardized, discoverable format for long-term reference. ADRs record what was decided, why, and what alternatives were considered. This skill reads design documents and produces structured ADR files that provide historical context for future engineers.

When to Use

Use this skill when:

• A design decision has been made during brainstorming or planning
• An architectural choice needs to be recorded for posterity
• You want to document why an approach was chosen over alternatives
• A previous decision is being superseded or deprecated