How to Create an Architecture Decision Record

Goal

Create an Architecture Decision Record (ADR) using one of four supported formats. Document the context, decision, and consequences. Set the status, link to related diagrams and ADRs, and export to Markdown for external consumption.

Step 1: Navigate to the ADR Directory

Step 2: Create a New ADR

Step 3: Choose an ADR Format

NeoArc Studio supports four ADR formats. Select the format from the Type dropdown. The editor shows different fields based on the chosen format.

Step 4: Fill In Format-Specific Fields

For Nygard or Structurizr Format

For MADR Format

For Y-Statement Format

Step 5: Set the Status

There are 6 status values, each with a colour-coded badge.

Step 6: Add Links to Diagrams and Other ADRs

Step 7: Export to Markdown