Mais sobre o tema
Um ADR tem três campos obrigatórios: contexto (a situação que forçou a decisão), decisão (o que foi escolhido) e consequência (o que aceitamos perder em troca). Vive no repositório, versionado como o código. Cada ADR ganha um número, um título descritivo e fica imutável depois de aceito — se a decisão muda, cria-se um novo ADR que substitui o anterior. Na Nextside, todo projeto começa com 3-5 ADRs já na Sprint Zero (stack, deploy, segurança), e novos ADRs são criados sempre que uma decisão de arquitetura é tomada.