Skip to content
Alpha

This site is an alpha version and is still being developed in the open - your feedback will help us improve it. See the roadmap. Last updated: 14 October 2026.

Version in force: 0.3.0 (6 October 2026).

Architecture decision record template

Save as docs/adr/NNNN-short-title.md in your repository.

# NNNN. Title in the form of a short decision

- Status: Proposed | Accepted | Rejected | Superseded by [NNNN](NNNN-title.md) | Deprecated
- Date: YYYY-MM-DD
- Deciders: names or roles
- Decided by: team | SDA name | TDA | TGB
- Business capabilities: e.g. BC05 Issue licences and permits
- Technology capabilities: e.g. Manufacturing & Delivery (Business)
- Guardrails: e.g. GR-HOST-01 (met), GR-DEV-01 (departure - see below)
- Advice sought from: e.g. platform team, security architect, teams affected

## Context

What is the problem or opportunity? What constraints and forces are at play
(user needs, policy, deadlines, existing systems, skills, cost)? Write for someone
who was not in the room.

## Options considered

### Option 1: strategic option from the handrail

- Pros:
- Cons:

### Option 2:

- Pros:
- Cons:

## Decision

We will ... because ...

## Consequences

- What becomes easier?
- What becomes harder, or what risks are we accepting?
- What will we need to do as a result (follow-up work, exceptions, monitoring)?
- Exit: how would we reverse this if we needed to?