Caderno de decisões: contexto, escolha e revisão
Um conceito de registro leve para documentar o motivo de uma escolha técnica.
Projeto fictício de exemplo. Não há aplicação, repositório ou resultados disponíveis.
A ideia
Um caderno versionado para registrar contexto, alternativas e consequências de decisões técnicas. O foco do conceito é permitir que uma pessoa entenda por que uma escolha foi feita.
O experimento proposto
Criar um modelo Markdown com quatro campos: pergunta, contexto, decisão e pontos a revisitar. Aplicar o modelo a uma decisão hipotética e revisar se ele preserva o raciocínio.
O que seria avaliado
Clareza do registro, facilidade de atualização e utilidade para alguém que não participou da conversa original. Nenhuma dessas avaliações foi realizada neste exemplo.
O ciclo de uma decisão
Uma pergunta registra contexto e alternativas. A escolha ganha consequências explícitas e pontos a revisitar. Quando o contexto muda, a pergunta é reaberta; este é o fluxo proposto para o projeto fictício.
flowchart TD
A[Pergunta e contexto] --> B[Alternativas]
B --> C[Decisão e consequências]
C --> D[Pontos a revisitar]
D -->|Novo contexto| A
Referências públicas
Michael Nygard — Documenting Architecture Decisions · Coleção de referências sobre ADRs .
Referências de contexto; não comprovam experiências nem resultados deste cenário.