Registro de Decisão de Arquitetura
Um ADR existe para que, daqui a dezoito meses, ninguém reabra uma questão já resolvida sem saber por que ela foi resolvida, e para que, quando o contexto mudar, a decisão possa ser revisitada deliberadamente.
Onde
docs/adr/NNNN-titulo-curto.md, numerado sequencialmente. Verifique o diretório para o próximo número e o template da casa; siga-o se existir um.
Template
# NNNN. <Título na forma da decisão: "Usar Aurora PostgreSQL para o serviço de pedidos">
Data: YYYY-MM-DD
Status: Proposto | Aceito | Substituído por NNNN | Depreciado
Decisores: <nomes ou time>
## Contexto
<Quais forças estão em jogo: requisitos, restrições, dor atual, prazos, conformidade,
habilidades do time, envelope de custos. Dois a quatro parágrafos. Fatos, não opiniões.>
## Decisão
<Uma ou duas frases, no presente: "Nós vamos …">
## Opções consideradas
### Opção A: <nome>
Prós / Contras / Custo aproximado / Carga operacional
### Opção B: <nome>
…
## Consequências
<O que fica mais fácil, o que fica mais difícil, o que agora precisamos fazer (migrações,
treinamento, novos runbooks), o que estamos aceitando explicitamente como risco.>
## Acompanhamentos
- [ ] <tarefas concretas com responsáveis, se conhecidos>
Orientações de redação
- Escreva o contexto para que um novato concorde que o problema é real antes de ler a decisão.
- Compare opções nos mesmos eixos: custo, carga operacional, dependência, familiaridade do time, tempo para entrega, segurança/conformidade. Coloque números onde você os tiver (estimativa de custo mensal, RTO/RPO, throughput).
- Seja honesto sobre os pontos fortes das opções perdedoras. Um ADR que distorce alternativas será desacreditado.
- As consequências incluem as negativas. "Agora temos dois bancos de dados para fazer backup" cabe ali.
- Mantenha abaixo de duas páginas. Link para spikes, benchmarks e tickets em vez de incluí-los inline.
- Ao substituir, atualize o status do ADR antigo e faça links em ambos os sentidos.
Quando $ARGUMENTS é fornecido
Use como título; derive o nome do arquivo a partir dele.