ADR 0001 — Registrar decisões em ADRs

Status: Aceita · Data: 09/11/2026

Contexto

Quando as decisões ficam espalhadas em arquivos soltos e em conversas, fica difícil entender por que algo foi feito e o que pode ser mudado com segurança.

Decisão

Toda decisão de arquitetura ou de modelagem relevante vira uma página em docs/decisoes/, numerada, no mesmo commit da mudança.

Alternativas consideradas

• Wiki separada: fica desatualizada, porque vive longe do código.
• Só comentários no código: não explicam alternativas nem o contexto.

Consequências

Um pouco mais de escrita a cada decisão. Em troca, o histórico fica completo e pesquisável junto do código.