Architecture Decision Records
Comprehensive patterns for creating, maintaining, and managing Architecture Decision Records (ADRs) that capture the context and rationale behind significant technical decisions.
Use this skill when
- •Making significant architectural decisions
- •Documenting technology choices
- •Recording design trade-offs
- •Onboarding new team members
- •Reviewing historical decisions
- •Establishing decision-making processes
Do not use this skill when
- •You only need to document small implementation details
- •The change is a minor patch or routine maintenance
- •There is no architectural decision to capture
Instructions
- •Capture the decision context, constraints, and drivers.
- •Document considered options with tradeoffs.
- •Record the decision, rationale, and consequences.
- •Link related ADRs and update status over time.