Escreva uma decisão que possa rever mais tarde

Preserve o raciocínio

Uma reunião de decisão produz uma escolha. Um registo de decisão preserva as razões que tornaram essa escolha adequada.

Sem esse raciocínio, uma equipa posterior pode confundir uma restrição temporária com um princípio permanente. Pode também repetir uma avaliação já concluída pela organização.

A AWS descreve os registos de decisão de arquitetura como um meio de documentar decisões e o seu contexto. A mesma estrutura concisa pode ajudar num modelo operacional de desenvolvimento com IA. Mantenha o registo suficientemente curto para que os responsáveis o leiam.

Compare alternativas realistas

Uma empresa fictícia precisa de manter a sua aplicação de contratos. Considera três opções:

Use o mesmo âmbito da aplicação, período, pressupostos sobre dados e expectativas de serviço. Evite comparar um serviço adquirido já maduro apenas com o custo do protótipo de um sistema interno.

Uma combinação também pode ser adequada. Uma plataforma existente pode fornecer ambientes e deployment enquanto uma fábrica de software coordena o desenvolvimento. Explique a interface e as responsabilidades, em vez de impor uma escolha artificial de tudo ou nada.

Escreva seis partes

1. Contexto. Indique o problema e a consequência de o deixar por resolver.
2. Requisitos. Enumere as condições que uma opção tem de satisfazer.
3. Alternativas. Registe as opções plausíveis e os principais compromissos entre os seus objetivos.
4. Evidências. Inclua ligações para as avaliações, os pressupostos de custo e as perguntas por resolver.
5. Decisão. Identifique a opção escolhida, o âmbito, o responsável e os limites aceites.
6. Revisão. Defina a data ou o acontecimento observável que exige uma reavaliação.

Distinga o que observou do que espera. «A avaliação concluiu esta alteração de manutenção» é uma observação. «O serviço reduzirá para metade o custo anual de manutenção» é uma previsão que exige evidências e pressupostos explícitos.

Inclua a objeção mais forte

Na aplicação de contratos, um serviço adquirido pode reduzir o trabalho de integração, mas criar uma dependência de um fornecedor externo. Registe essa objeção e o exercício de exportação que responde a parte dela. Não retire a objeção por a equipa preferir essa opção.

Indique que pontos por resolver bloqueiam a ativação. Atribua responsáveis e datas aos restantes. Uma decisão de avançar não transforma uma pergunta sobre controlos sem resposta num resultado verificado.

Reveja o registo quando os requisitos ou as evidências mudarem. Acrescente uma nova decisão quando a escolha mudar e preserve o raciocínio anterior. Prossiga para os cenários práticos com a Taiga para aplicar estes princípios aos fluxos do produto.