Start a new record
Open the step-by-step ADR form. One continuous single-page wizard that scores completeness as you complete it and renders a Markdown ADR.
Open the form →Decision register
Browse recorded decisions with their status, group, completeness, and open governance flags, and filter by status and group.
Open the register →About this work
- Purpose
- Capture a structured architecture decision — author and organization context, issue, decision, status and group, assumptions, constraints, the positions (alternatives) considered, argument, implications, the related decisions / requirements / artifacts / principles, notes, and sign-off — and produce a report — status, completeness, the chosen position, flags such as an approved record with no sign-off, and a commit-ready Markdown ADR.
- Specification
- Spec-driven: the living domain spec defines the data model, the completeness/status engine, and the flag rules. The same engine scores both the form and the register.
- Documentation
- Uses the Tyree & Akerman ADR template (not MADR). The Markdown output is ready to
commit to
docs/adr/NNNN-slug.md.