APRENDER. PRATICAR. EVOLUIR.Conceito e mecanismo
Uma decisão de arquitetura deve ser reconstruível: qual problema existia, que opções foram consideradas, que condições limitaram a escolha e quais consequências foram aceites. Um ADR mantém essa memória sem precisar de repetir todo o desenho detalhado. Quando uma decisão aceite muda, um novo registo deve explicar o motivo e ligar à decisão substituída, preservando o contexto anterior. Regista também incertezas relevantes. Uma prova de conceito pode responder a uma pergunta limitada, como compatibilidade ou desempenho num conjunto de dados, mas não estabelece por si só segurança, recuperação ou prontidão operacional. Define a hipótese e o critério de observação antes de iniciar a experiência.
Aplicação guiada
Num exercício fictício, uma pesquisa local é rápida com mil registos, mas o serviço precisa de suportar vinte milhões e uma dependência remota. A equipa não deve extrapolar o resultado sem analisar volume, distribuição de dados, rede e falhas. Prepara uma experiência representativa e identifica o que continua fora do seu alcance. Se o resultado alterar a opção escolhida, atualiza o histórico de decisão com a nova evidência e informa os consumidores afetados. Compara também competências disponíveis, manutenção e condições da plataforma. Uma opção tecnicamente possível pode continuar inadequada ao prazo ou à capacidade de suporte existente.
Uma prova de conceito valida uma hipótese delimitada; a passagem a produção exige trabalho adicional explícito.
Armadilhas comuns
Protótipo tratado como produto; ADR sem consequências; apagar decisões anteriores; benchmark sem contexto.
Tópicos relacionados: Mandato e direção técnica · Revisão, qualidade e feedback · Integração, fluxo e dívida técnica
Mantém razões, alternativas e limites da evidência acessíveis à equipa.
Referência: Maintain an architecture decision record · Google Engineering Practices, SRE and DORA; Microsoft architecture decision and collaboration guidance; OWASP threat modeling; UK lead developer framework; inspected 2026-10-01