Creating ADRs
Use the ADR editor to document decisions with metadata, content sections, options analysis, and links to related diagrams and decisions.
The ADR editor provides a structured form for creating and editing Architecture Decision Records. Fields change based on the selected format, and changes are auto-saved with automatic markdown export.
Creating a New ADR
Core Fields
Every ADR has these fields.
Metadata Fields
Content Fields
Content fields use markdown and appear based on the selected format.
MADR Options
For MADR format, document the options you considered.
Linking Content
Auto-Save
The editor saves automatically.
Validation
The editor validates your input. Title is required for all formats. Invalid fields are highlighted. Save is blocked until validation passes.