Connect

Architecture Decision Records (ADR)

sickn33bysickn33
•
38k
•
Learning & Documentation

Streamlines the creation and management of Architecture Decision Records to document technical choices and rationale.

This skill provides standardized patterns and templates for capturing the context, rationale, and consequences of significant technical decisions. It helps development teams maintain a permanent record of architectural choices, facilitating better onboarding, easier historical reviews, and clearer communication of design trade-offs. By implementing various ADR formats like MADR and Y-Statements, it ensures that the critical 'why' behind the code is preserved as the project evolves.

Key Features

01Integration guidance for adr-tools and automated indexing
0237,717 GitHub stars
03Standardized templates for MADR, Lightweight ADRs, and Y-Statements
04Structured patterns for documenting decision drivers and trade-offs
05Guided lifecycle management from Proposal to Supersession
06Workflows for deprecating and replacing legacy architectural decisions

Use Cases

01Documenting major framework or database selection processes
02Onboarding new developers by providing historical context for design choices
03Facilitating structured architectural reviews within engineering teams