Skill oficial · Operações e administração

Registro de decisão (decision log)

Registra uma decisão como uma entrada curta no registro de decisões: a decisão, o contexto, as opções consideradas, o porquê, quem decidiu, a data, o status e um gatilho de revisão.

Funciona no Claude, no ChatGPT e em agentes de programação. Nos planos Team e Business, a skill oficial no seu pod se atualiza sozinha quando a melhoramos.

Quando usar

O que você passa para ela

O que você recebe

Uma entrada numerada do registro de decisões em Markdown, com status, quem decidiu, contexto, opções, motivos, consequências e um gatilho de revisão.

Como funciona

  1. Escreva a decisão em uma frase, na voz ativa Nygard escreve a seção da decisão “in full sentences, with active voice” (em frases completas, na voz ativa), em geral começando com “We will” (em português, “Vamos”). Exemplo: “Vamos usar o Dealbook como nosso CRM a partir de 1º de março.”
  2. Escreva o contexto em 2 a 4 frases Os fatos e as pressões que obrigaram a escolher: prazo, custo, um cliente, uma restrição. Nygard diz que esta seção “is value-neutral. It is simply describing facts.” (é neutra; apenas descreve fatos). As opiniões ficam nos motivos.
  3. Liste as opções consideradas Uma linha para cada, com o principal custo-benefício. A prática DACI da Atlassian mantém uma tabela de opções com prós, contras e custo. Inclua “não fazer nada” se foi uma opção real. Liste só opções que foram de fato discutidas.
  4. Dê os motivos De 2 a 4 tópicos que se liguem ao contexto: por que esta opção venceu as outras. Depois liste as consequências, boas e ruins. Nygard: “All consequences should be listed here, not just the 'positive' ones.” (todas as consequências devem ser listadas, não só as “positivas”).
  5. Diga quem decidiu e quem foi consultado Uma pessoa que decide (a prática DACI da Atlassian a chama de Approver, “the one person (yes: one!) who makes the decision”, a única pessoa, sim, uma só, que toma a decisão) e as pessoas consultadas. O framework de ADR do governo britânico também registra as partes interessadas consultadas.
  6. Defina um gatilho de revisão Uma condição específica que reabriria o assunto: uma data, um número ou um evento (“se passarmos de 20 vendedores”, “se o preço passar do nosso orçamento”, “rever em 1º de março do ano que vem”). Padrão desta skill: todo registro tem um; “nunca” só vale quando a decisão é de fato permanente, e aí diga por quê.
  7. Defina o status e o número Proposta, aceita ou substituída. Numere as entradas em ordem e nunca reutilize um número, como faz o formato de Nygard. Se esta decisão substitui uma mais antiga, marque a antiga como “Substituída pela #[n]” e mantenha-a; Nygard mantém as decisões revertidas no registro, marcadas como substituídas.

Compartilhe com a sua equipe

Adicione a skill a um AI Skill Pod e todo mundo da equipe, prestadores de serviço incluídos, usa a mesma versão na própria IA. Veja as melhores formas de compartilhar skills de IA com uma equipe

Adicionar ao pod da minha equipe

Histórico de mudanças

Fontes

  1. Documenting architecture decisions (Michael Nygard, Cognitect) (lida em 2026-11-04)
  2. Architectural Decision Records (ADRs) (lida em 2026-11-04)
  3. Architectural Decision Record Framework (GOV.UK) (lida em 2026-11-04)
  4. DACI: a decision-making framework (Atlassian Team Playbook) (lida em 2026-11-04)