| name | adr-when-deciding |
| description | Registra decisão arquitetural em ADR datado (docs/adr/). Aciona quando brief envolve arquitetura, troca de tecnologia ou escolha entre frameworks/bancos. |
| roles | ["coordinator"] |
| category | task-aware |
Decisão com impacto > 1 sprint OU que muda contrato externo: crie docs/adr/NNN-titulo.md.
Template:
# 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.