ROADYOM
PT
Começar
Modelo gratuito · Log de decisões

Decisões duram mais que as reuniões. Registre os motivos.

Pessoas tomam decisões e seguem em frente. A decisão permanece, mas os motivos partem com elas. Um log de decisões mantém o 'porquê' ao lado do 'quê', para o colega que não estava na sala.

Em árabe: XLSX · CSV

Opções rejeitadas e o motivo Datas de revisão com alertas automáticos Inglês e árabe

Uma mesa com arquivos empilhados e uma página impressa ao lado de uma janela
Por que isso é importante

O olhar retrospectivo reescreve a memória. Um registro não.

Sem os motivos, uma equipe só pode manter uma decisão que não entende mais, ou revertê-la e trazer de volta o problema que ela resolveu.

1975

O psicólogo Baruch Fischhoff demonstrou que, uma vez que as pessoas conhecem o resultado, elas o julgam como mais previsível do que realmente foi. Ele chamou isso de “determinismo progressivo”.

Journal of Experimental Psychology
Esquecido

A orientação de arquitetura da Microsoft: uma decisão nunca registrada “provavelmente será esquecida, levando a debates repetitivos”. Mantenha o log apenas para adições, com um nível de confiança para cada decisão.

Microsoft Learn
2011

Michael Nygard propôs o registro de decisão: título, contexto, decisão, status, consequências. “Todas as consequências devem ser listadas aqui, não apenas as ‘positivas’.”

Michael Nygard
Adotar

A Thoughtworks colocou registros de decisão leves no anel Adopt de seu Technology Radar, sua recomendação mais forte.

Thoughtworks
O modelo

Uma linha por decisão. As mais recentes primeiro.

De uma clínica, uma escola, um centro de serviços e uma agência bancária: os mesmos campos registram qualquer decisão significativa.

IDTítuloDecididoResponsávelDecisãoResultado esperadoConfiançaRevisãoStatus
D-005Agendamentos antecipados para abertura de conta2026-10-20Gerente da agênciaOfereceremos horários agendados para abertura de conta, mantendo também o atendimento por ordem de chegada.Menores tempos de espera para solicitações rápidas.Baixa2027-02-28Proposto
D-004O papel de coordenador adiciona chamadas de alta2026-06-12Gerente de operaçõesAdicionaremos chamadas de alta ao papel de coordenador a partir de julho.Enfermeiros gastarão menos tempo em chamadas até dezembro.Média2026-12-15Aceito · substitui D-001
D-003O balcão de atendimento abre às 7:30 às segundas-feiras2026-05-05Gerente do centro de serviçosAbriremos o guichê às 7:30 todas as segundas-feiras a partir de junho.A espera média às segundas-feiras cai até o final de setembro.Alto2026-10-15Aceito · revisão pendente
D-002Duas avaliações mais curtas substituirão o exame de final de período2026-04-22Vice-diretor acadêmicoA partir de setembro, realizaremos duas avaliações mais curtas por período do 7º ao 9º ano.Os professores agirão sobre os resultados de meio de período em até duas semanas.Média2027-01-31Aceito
D-001Chamadas de acompanhamento passam para um coordenador2026-02-10Gerente de operaçõesA partir de 1 de março, as chamadas de acompanhamento passarão para um coordenador dedicado.A taxa de conclusão aumenta em três meses.Média2026-06-01Substituído por D-004

O XLSX sinaliza 'Revisão pendente' quando uma data de revisão passa sem um resultado registrado. Os arquivos adicionam contexto, opções consideradas, evidências, o que permanece incerto e o resultado da revisão, além de uma folha de registro de uma página.

Opções consideradas

Incluindo as rejeitadas e o motivo. O campo que mais falta e o que mais é necessário.

Decisão

Uma frase na voz ativa que comece com “Nós iremos...”.

Evidências

Vincule a pesquisa, relatório ou registro em si, para que leitores futuros possam julgar se ele ainda é válido.

Resultado esperado

O que deve ser verdade se funcionar, e até quando. Escrito antes de você saber.

Confiança

Alto, médio ou baixo, com uma linha sobre o que permanece incerto.

Status

Proposto, aceito, substituído ou aposentado. 'Substituído' vincula ao seu substituto.

Como usar

Escreva na semana em que decidir.

  1. Escolha o que conta

    Decisões que moldam como você trabalha, afetam a qualidade ou segurança, ou são difíceis de reverter. Não cada compra.

  2. Registre na mesma semana

    Um registro escrito na mesma semana é preciso. Um escrito meses depois é uma reconstrução.

  3. Nomeie as opções rejeitadas

    E o porquê de cada uma ter sido descartada. É isso que a próxima equipe desejará reabrir.

  4. Declare o que você espera

    O resultado, a data e sua confiança. O olhar retrospectivo tentará apagar os três.

  5. Revise na data

    Escreva o que realmente aconteceu ao lado do que você esperava. Evidências fracas, mudanças de condições ou má sorte: especifique qual.

  6. Substitua, nunca sobrescreva

    Um novo registro substitui o antigo e cria um vínculo com ele. O histórico de uma mudança de direção é, muitas vezes, a parte mais valiosa.

Erros comuns

Por que os registros de decisão morrem.

Registrar tudo

O registro vira uma ata. Ninguém lê, então ninguém escreve.

Apenas a opção vencedora

Sem as opções rejeitadas, o mesmo debate retorna em um ano.

Escrever meses depois

A essa altura, o resultado já é conhecido e o registro é moldado por ele.

Editando uma decisão aceita

O rastro desaparece. Escreva um novo registro e marque o antigo como substituído.

Sem data de revisão

Assim, ninguém jamais saberá se a decisão cumpriu o que prometeu.

Mantido em uma pasta separada

Um log ao lado dos planos e procedimentos que ele afeta é lido. Um em uma pasta, não.

Quando uma planilha deixa de ser suficiente

Quando o log precisa ter memória própria.

Uma planilha contém linhas. Ela não consegue mostrar o quanto se pode ter Confiança em cada uma, ou o que aconteceu depois.

  • As pessoas perguntam “por que decidimos isso?” e a resposta está na caixa de entrada de alguém.
  • Decisões, procedimentos e lições vivem em arquivos diferentes que nunca se encontram.
  • Você não consegue distinguir uma decisão ratificada de um palpite de alguém.
  • Os assistentes que sua equipe utiliza não conseguem ver por que você decidiu qualquer coisa.

ROADYOM PRISM

Cada decisão, com seu peso.

Prism armazena as decisões e o conhecimento de uma organização como itens com um nível de Confiança declarado: ratificada, evidenciada, observada ou inferida. Cada decisão se conecta às suas evidências, aos passos para executá-la e aos resultados e lições de Pause and Learn que se seguem. Quando uma decisão é substituída, a anterior permanece visível. As pessoas tomam as decisões. Prism guarda os motivos delas.

Perguntas, respondidas.

Isso é o mesmo que uma ata de reunião?

Não. Atas registram o que foi dito. Um registro de decisão mantém o que foi decidido, o porquê, o que mais foi considerado e o que você esperava. Uma página ou menos.

Quem deve escrever o registro?

O responsável pela decisão, ou alguém que ele nomear, na mesma semana. As pessoas consultadas devem ser capazes de fazer a leitura e corrigir os fatos.

E quanto às decisões que tomamos anos atrás?

Comece com as novas decisões. Depois, reconstrua as poucas do passado sobre as quais as pessoas mais perguntam e marque-as como reconstruídas.

Isso não é uma prática de engenharia de software?

Começou lá, com o registro de decisão de arquitetura. Nada nele é específico para software. Regras de admissão, políticas de avaliação e horários de funcionamento também têm contexto, opções e consequências.

O que a Confiança adiciona?

Ela registra o que você acreditava antes de saber o resultado. Na revisão, uma decisão confiante que falhou ensina algo diferente de uma decisão cautelosa.

Uma decisão deve ser deletada algum dia?

Não. Retire-a de circulação ou substitua-a. O registro de uma decisão revertida é como a próxima equipe evita repeti-la.

Fontes (5)
  1. Hindsight ≠ foresight: The effect of outcome knowledge on judgment under uncertainty. Journal of Experimental Psychology: Human Perception and Performance 1(3) (B. Fischhoff), 1975.
  2. Documenting Architecture Decisions. Michael Nygard, blog Relevance (agora Cognitect), 2011.
  3. Architecture decision record (Azure Well-Architected Framework). Microsoft Learn, 2024.
  4. Decision Log (Code-With Engineering Playbook). Microsoft, 2024.
  5. Lightweight Architecture Decision Records (Technology Radar). Thoughtworks, 2018.

Decida com propósito. Duas vezes.

Uma vez quando você escolhe. Outra quando você revisa. Gratuito, em inglês e árabe.