domains / families / software-engineering / architecture-decision-records

architecture-decision-records

authentic

Write and maintain Architecture Decision Records (ADRs) following best practices for technical decision documentation. Use when documenting significant technical decisions, reviewing past architectural choices, or establishing decision processes.

When to use

• Making significant architectural decisions
• Documenting technology choices
• Recording design trade-offs
• Onboarding new team members
• Reviewing historical decisions
• Establishing decision-making processes

When not to use

• You only need to document small implementation details
• The change is a minor patch or routine maintenance
• There is no architectural decision to capture

Skill page

Source