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
- A equipe acabou de decidir algo caro de reverter ou que provavelmente será questionado
- As pessoas vivem perguntando por que algo foi escolhido e a resposta não está escrita
O que você passa para ela
- O que foi decidido e por quem
- Data
- As opções discutidas e por que perderam
- Conversa, ata ou documento (opcional)
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
- 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.”
- 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.
- 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.
- 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”).
- 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.
- 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ê.
- 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
- v1.0.0 · · First release.
Fontes
- Documenting architecture decisions (Michael Nygard, Cognitect) (lida em 2026-11-04)
- Architectural Decision Records (ADRs) (lida em 2026-11-04)
- Architectural Decision Record Framework (GOV.UK) (lida em 2026-11-04)
- DACI: a decision-making framework (Atlassian Team Playbook) (lida em 2026-11-04)