O que é Architecture Decision Record (ADR)?
Um ADR torna uma decisão compreensível para os futuros colegas de equipe. Ele normalmente registra o contexto (quais forças estavam em jogo), a decisão, as alternativas consideradas e as consequências (os trade-offs com os quais você agora convive). Os ADRs são versionados junto com o código e são substituídos em vez de editados — o histórico do raciocínio é tão valioso quanto a resposta atual.
Também conhecido como: adr.
Termos relacionados
- Drift de Arquitetura — A lacuna cada vez maior entre a arquitetura documentada e o sistema que de fato roda em produção.
- Documentação Viva — Documentação que é gerada ou validada a partir do sistema em execução, de modo que permanece precisa à medida que o sistema evolui.