APRENDER. PRATICAR. EVOLUIR.Conceito e mecanismo
O gestor precisa de criar condições para decisões técnicas informadas, envolvendo quem compreende o sistema e assumirá consequências. Uma divergência deve ser examinada através de requisitos, evidência, alternativas e compromissos, em vez de preferência pessoal ou hierarquia como critério único. Na revisão de código, distingue problemas que afetam qualidade de sugestões opcionais de apresentação. A orientação do Google privilegia melhoria da saúde do código sem exigir perfeição em todos os detalhes; não autoriza degradar qualidade só para terminar mais depressa. Quando a discussão escrita deixa de avançar, uma conversa curta pode esclarecer critérios, seguida de registo da decisão para quem não esteve presente.
Aplicação guiada
Uma equipa discute substituir middleware durante uma migração cloud. Compara suporte, competências, compatibilidade, recuperação, custo operacional e possibilidade de reversão. Uma experiência limitada pode resolver a dúvida técnica mais importante antes de um compromisso maior. Para uma escolha arquitetural significativa, regista contexto, opções rejeitadas, decisão, consequências e confiança. Se a escolha mudar, cria um novo ADR que substitui o anterior e liga os dois, preservando a razão histórica. Não reescrevas a decisão antiga como se a informação nova sempre tivesse existido. Define também quem decide e quando será reavaliada. O resultado esperado é uma decisão compreendida e sustentável, não a tecnologia preferida pelo participante com maior cargo.
Um ADR preserva por que se decidiu, incluindo consequências e alternativas.
Armadilhas comuns
Preferência como evidência; perfeccionismo; decisão sem dono; apagar história arquitetural.
Tópicos relacionados: Mandato, autonomia e delegação · Feedback e desenvolvimento de competências · Capacidade, carga operacional e toil
Usa critérios explícitos e preserva a razão das decisões.
Referência: Maintain an architecture decision record · GitLab Handbook 2026; DORA current five-metric model; SRE and engineering guidance reviewed 2026-09-30