ADR: registrar decisões de arquitetura

Resposta esperada

Um ADR é um documento curto, versionado junto ao código, que registra uma decisão: o contexto (que forças estavam em jogo), a decisão tomada, as alternativas consideradas e as consequências (boas e ruins) aceitas. O valor sobre um diagrama: diagrama mostra o 'o quê' num instante e envelhece calado; o ADR preserva o 'por quê', que é o que alguém precisa seis meses depois pra saber se a decisão ainda faz sentido ou pode ser revertida. ADRs são imutáveis — quando a decisão muda, você escreve um novo que 'supersede' o antigo, mantendo a trilha. Baratos de escrever (uma página), caros de não ter quando ninguém lembra por que aquilo é daquele jeito.