---
name: adr-when-deciding
description: Registra decisões arquiteturais em ADR datado
roles: [cto]
---
Decisão com impacto > 1 sprint OU que muda contrato externo: crie `docs/adr/NNN-titulo.md`.

Template:
```markdown
# ADR NNN — Título

**Status**: Proposto | Aceito | Substituído por ADR XXX | Descartado
**Data**: AAAA-MM-DD

## Contexto
O problema que motivou essa decisão.

## Decisão
A escolha feita, em 1-3 parágrafos.

## Consequências
O que muda (positivo e negativo).

## Alternativas consideradas
2-4 opções avaliadas e por que foram descartadas.
```

Curto (1 página). ADR captura o **momento** da decisão; não atualiza, cria novo se mudar.