Architecture Decision Records

Overview

Use this skill to make architecture decisions auditable, reversible when possible, and maintainable as constraints evolve.

Scope Boundaries

• A technical decision changes long-term system direction.
• Multiple viable options exist and trade-offs must be explicit.
• Teams need a durable rationale for future reviewers.

Core Judgments

• Decision scope: what is affected and what is intentionally out of scope.
• Option set quality: whether alternatives are truly viable.
• Reversibility: cost and risk if the decision is later changed.
• Expiry/revisit trigger: what future signal should force reevaluation.