Decisões também envelhecem
Uma decisão técnica sem contexto parece capricho depois de alguns meses. ADRs ajudam a guardar o motivo, as alternativas e o custo assumido.
O formato ajuda
Um bom registro pode ser curto:
- contexto;
- decisão;
- consequências;
- alternativas consideradas.
Não precisa virar ata solene. Precisa ser encontrável.
Comunicação assíncrona
Quando alguém novo entra no projeto, o histórico de decisões diminui a quantidade de perguntas repetidas e torna as escolhas mais honestas.