Architecture Decision Record

Architecture Decision Records help teams capture important choices about system design. These lightweight documents explain why a decision was made and what impact it will have. They include the context, the decision, the consequences, and any alternatives considered.

Developers and architects use ADRs to keep a clear history of technical choices. New team members can quickly understand past decisions. This skill provides ready-to-use templates that follow the well-known Nygard format. It helps you avoid repeating old debates and makes your team's reasoning clear.

Use this skill whenever you make a significant architectural choice. It guides you to write a record that everyone can follow. The templates ensure you include all key sections. Your project will have a durable memory of how and why it evolved.