Architecture Decision Records
Document and track architecture decisions using industry-standard ADR formats including MADR, Nygard, Structurizr, and Y-Statement
The ADR directory stores Architecture Decision Records. ADRs capture important technical decisions along with their context, rationale, and consequences, creating a permanent record that helps teams understand why architectural choices were made.
Supported ADR Formats
Format Comparison
Each format includes different sections based on its documentation philosophy:
Creating an ADR
ADR Statuses
Track the lifecycle of each decision:
Best Practices
Learn more
Document architectural decisions with Architecture Decision Records. NeoArc supports 4 ADR formats with status tracking, markdown export, and linked diagrams.
Choose from four ADR formats: Nygard for classic simplicity, Structurizr for architecture focus, MADR for options analysis, or Y-Statement for single-sentence decisions.
Manage the ADR lifecycle from draft to accepted. Export to markdown, organise with directories, and track decision evolution over time.
Capture architectural decisions in structured, searchable formats that live alongside your code. NeoArc Studio supports 4 industry-standard ADR formats with full editor and viewer components.