Diretrizes para alcançar decisões sustentáveis

Aprendemos as seguintes lições em nosso trabalho, que podem servir como diretrizes e avaliação para alcançar decisões sustentáveis:

Use uma abordagem enxuta/minimalista para a documentação inicial das decisões.
Priorize e capture todas as decisões importantes que sejam relevantes o bastante para documentar e entender a arquitetura-alvo.
Detalhe as decisões particularmente importantes com modelos completos somente depois que o trabalho inicial tiver sido feito (ou seja, quando os tomadores de decisão estiverem satisfeitos com as decisões de arquitetura tomadas e confiantes de que elas não precisarão ser revistas tão cedo).
Use as versões enxutas/minimalistas do passo 1 como uma versão curta das decisões documentadas, com o nível de granularidade adequado, para dar uma visão geral das decisões detalhadas, bem como para decisões triviais ou óbvias.
Sempre que possível, use conhecimento de arquitetura existente, seja de modelos de orientação ou de outras fontes. Revise e amplie esse conhecimento e ajuste-o ao contexto da decisão específica.
Garanta que sejam estabelecidos vínculos de rastreabilidade entre as decisões e tanto os requisitos quanto os designs/códigos de arquitetura.
Forneça verificação automatizada de consistência para garantir que os vínculos de rastreabilidade permaneçam sincronizados após uma mudança. Limite o número de dependências entre decisões e outros artefatos de software.
Aplique as diretrizes de justificativa de forma consequente e vigorosa — elas são a parte mais importante da documentação da decisão porque fornecem o raciocínio.