ADR Workflows
Manage the ADR lifecycle from draft to accepted. Export to markdown, organise with directories, and track decision evolution over time.
ADRs follow a lifecycle from initial draft through to acceptance or rejection. Status tracking, markdown export, and organisation features help you manage your decisions effectively over time.
The ADR Lifecycle
A typical ADR moves through these states.
Alternative Paths
Status Transitions
Status Colours
The ADR panel and viewer use colours to indicate status.
| Status | Colour | Meaning |
|---|---|---|
| Draft | Yellow | Work in progress |
| Proposed | Blue | Under review |
| Accepted | Green | Approved |
| Rejected | Red | Declined |
| Deprecated | Orange | No longer valid |
| Superseded | Grey | Replaced |
Markdown Export
NeoArc automatically generates markdown for each ADR.
Export Uses
Share with Stakeholders
Share with stakeholders who prefer markdown
Pull Requests
Include in pull requests for code review
Documentation Sites
Publish to documentation sites
Version Control
Archive decisions in version control
Organising ADRs
The ADR Panel
Navigate your ADRs using the sidebar panel.
The ADR Viewer
View ADRs in a formatted display.
Linking Decisions
Build a decision graph by linking related ADRs.
Best Practices
Write Early
Capture decisions when context is fresh
Keep Focused
One decision per ADR
Update Status
Update status promptly to reflect current state
Link Generously
Connect related decisions and diagrams
Review Periodically
Check for deprecated decisions
Consistent Naming
Use clear, descriptive titles