---
description: Draft an Architecture Decision Record from a question or decision.
argument-hint: <decision-title>
---

# /create-adr

## Purpose

Capture a load-bearing architectural decision as an ADR in MADR format.

## Required context

- `docs/decisions/0000-template.md`, existing ADRs in `docs/decisions/`

## Inputs

- `$1` — short decision title (e.g. "adopt-keyset-pagination")

## Execution steps

1. Find the next ADR number (highest in `docs/decisions/` + 1).
2. Copy `0000-template.md` → `NNNN-<kebab-title>.md`.
3. Fill: Context, Decision, Status (Proposed/Accepted), Consequences, Alternatives, References.
4. Link related ADRs.

## Validation checklist

- [ ] Numbered sequentially
- [ ] All sections filled
- [ ] Status set
- [ ] Linked from code comments if it constrains code

## Expected output

A new ADR file.

## Failure handling

If the decision contradicts an existing Accepted ADR, supersede it explicitly (mark the old one `Superseded by NNNN`).
