Getting Started with ADRs
Document architectural decisions with Architecture Decision Records. NeoArc supports multiple ADR formats with status tracking, markdown export, and linked diagrams.
Architecture Decision Records (ADRs) capture the context, decision, and consequences of significant technical choices. The structured editor offers four format options, status tracking, and automatic markdown export for integration with your existing documentation workflows.
Why Use ADRs?
Preserve Context
Capture why decisions were made, not just what was decided
Onboard Faster
New team members understand the architecture quickly
Avoid Repetition
Document decisions once instead of explaining repeatedly
Track Evolution
See how your architecture has changed over time
Enable Review
Revisit past decisions when requirements change
Improve Communication
Share decisions with stakeholders in a consistent format
ADR Formats
NeoArc supports four ADR formats to match your team's preferences:
ADR Status Values
Track the lifecycle of decisions with six status values:
Creating Your First ADR
ADR Properties
Each ADR includes:
Linking ADRs
Connect ADRs to other content:
| Link Type | Purpose |
|---|---|
| Related ADRs | Link to decisions that influence or depend on this one |
| Related Diagrams | Connect to architecture diagrams that illustrate the decision |
| References | Add external URLs to supporting documentation |
File Storage
The ADR Panel
Navigate ADRs using the sidebar panel:
- Hierarchical directory view
- Status dot indicators showing decision state
- Auto-expansion to current ADR
- Click to view any ADR