Docs / Engineering
ADRs
Architecture decision records: the decisions you made, why, and what follows from them.
When to use it
Every time the team makes a technical choice that someone may later ask about.
Start here
Click "+ New ADR" and record the context, the decision and the consequences.
How to use it
- Click "+ New ADR" (or "Create First ADR" when the list is empty). Enter a "Title", choose a "Status" and optionally add comma-separated "Tags".
- Fill in "Context" (what situation prompted the decision), "Decision" (what was decided) and "Consequences" (the good and bad outcomes).
- Click "✨ AI Suggest" at the bottom of the form to get a suggested next decision based on the project and its recent ADRs. It replaces the fields you have filled in, so edit the draft before saving.
- Click "Create" to save the record. It appears in the list as ADR-001, ADR-002 and so on, with its status, tags, context and decision.
- Use the status buttons above the list (All, Proposed, Accepted, Deprecated, Superseded) to filter. Each status button shows how many records have that status.
- Click "Edit" on a record to change it, for example to move a Proposed decision to Accepted, then click "Update".
- Click the round button at the bottom right ("Dev Agents") and choose "Technical Architect" to get an architecture proposal with suggested ADRs, then "Create ADRs from suggestions". The new records appear in the list straight away, with a message saying how many were created.
Good to know
- The four statuses are Proposed, Accepted, Deprecated and Superseded.
- "Delete" removes a record immediately, without a confirmation prompt.
- The "Technical Architect" agent needs a description of what to architect before "▶ Run Agent" is enabled.
Related
Last updated 6 October 2026