Quem pode criar um ADR?

Considere áreas como pessoas específicas, papéis específicos, equipes específicas ou departamentos específicos; considere também se há pessoas, papéis, equipes ou departamentos que podem encomendar um ADR, ou seja, solicitar um que outra pessoa irá redigir.

Exemplo de resposta: qualquer pessoa da nossa organização que tenha lido a página README sobre registros de decisão de arquitetura pode propor um ADR, ou seja, pode começar a escrevê-lo e compartilhá-lo com a equipe.

O que justifica abrir um ADR?

Considere áreas como as formas de trabalho das equipes da sua organização, a estrutura do seu sistema de software, a coordenação entre equipes, a manutenibilidade de longo prazo, as interfaces externas, quem você quer beneficiar e similares.

Exemplo de resposta: queremos criar um ADR quando queremos que desenvolvedores futuros entendam o “porquê” do que estamos fazendo.

O que justifica não abrir um ADR?

Considere áreas como decisões que não são sobre arquitetura, ou são minúsculas, por exemplo de risco mínimo, autocontidas ou de um único desenvolvedor, ou já estão totalmente cobertas em outro lugar, como em padrões, políticas ou documentação, ou são temporárias, como soluções paliativas, provas de conceito ou experimentos.

Exemplo de resposta: queremos dispensar um ADR quando uma decisão é limitada em escopo, tempo, risco e custo, ou já está coberta em outro lugar.

Qual é o ciclo de vida de um ADR?

Considere áreas como o processo de criação, o processo de pesquisa, o processo de decisão, o processo de implementação e o processo de desativação. Considere como acompanhar o ciclo de vida do ADR ao longo do tempo, como mover o ADR de um estado para o próximo e também como comunicar isso às partes interessadas.

Exemplo de resposta: queremos que um ADR tenha cinco estágios de ciclo de vida: Iniciando → Pesquisando → Avaliando → Implementando → Mantendo → Desativando.

Quais são os critérios para as etapas do ciclo de vida de um ADR?

Considere áreas como os critérios de aceitação de um ADR, ou seja, como você sabe que ele está bom o suficiente para avançar de uma etapa do ciclo de vida para a seguinte? O problema está claramente articulado? As alternativas foram consideradas? Os trade-offs estão bem compreendidos e documentados? Todo o contexto relevante está presente? Todas as partes interessadas relevantes estão envolvidas? Todo o feedback foi incorporado?

Exemplo de resposta: queremos que um ADR seja votado pelas partes interessadas quando a equipe ativa tiver 1) concluído sua pesquisa, 2) concluído sua avaliação, 3) publicado a proposta de ADR para as partes interessadas com um pedido de comentários e um prazo de uma semana, 4) incorporado e tratado todos os comentários das partes interessadas.

Quais papéis e responsabilidades interagem com um ADR?

Considere papéis como proponente, pesquisador, avaliador, revisor, aprovador, mantenedor e similares. Considere responsabilidades como comunicação com as partes interessadas, garantia de que as expectativas sejam atendidas, compartilhamento no site ou na intranet e revisão periódica do trabalho, especialmente quando ocorrerem mudanças relevantes.

Exemplo de resposta: queremos que cada ADR sempre tenha uma pessoa de contato principal, uma pessoa de contato secundária e uma equipe responsável; elas são responsáveis por comunicações, publicações, manutenção, revisão periódica pelo menos uma vez por ano e eventual desativação, conforme necessário.

Como a governança interage com um ADR?

Considere áreas como as formas de trabalho da sua organização, quaisquer necessidades especiais de conformidade, por exemplo em aspectos jurídicos ou de recursos humanos, e como você quer lidar com consenso versus conflito versus escalonamento. Existem áreas, pessoas ou equipes que podem ter mais influência que outras sobre um ADR, como poder aprová-lo, votar nele ou vetá-lo?

Exemplo de resposta: a governança de um ADR obedece a esta ordem de prioridade: o CEO, o CTO, o CLO, a equipe que implementa um ADR, os especialistas da equipe mais conhecedores do ADD. Ninguém mais tem governança, a menos que descrito no ADR.

Quais princípios interagem com um ADR?

Considere áreas como as formas de trabalho da sua organização, que incluem agir rápido versus agir devagar, consenso de decisão versus conflito de decisão, preferências de risco versus preferências de segurança, discussão pública versus discussão privada e similares.

Exemplo de resposta: usamos os princípios de liderança de viés para a ação, discordar e comprometer-se, estimativas de 70% são boas o suficiente para decisões facilmente reversíveis e facilmente isoláveis, e formas de trabalho públicas, com exceção de informações confidenciais conforme descrito no acordo de confidencialidade da nossa organização.