Architecture Decision Records
Document and maintain significant technical decisions with standardized Architecture Decision Records to capture context and rationale.
The Architecture Decision Records (ADR) skill provides a structured framework for documenting, maintaining, and managing significant technical choices within a project. It offers comprehensive templates—including MADR, lightweight, and Y-statement formats—to record the context, trade-offs, and long-term consequences of architectural shifts. By institutionalizing the 'why' behind engineering decisions, this skill ensures that historical knowledge is preserved for future team members, facilitates thorough peer reviews, and streamlines the lifecycle management of architectural evolutions from proposal to deprecation.