Formato ADR-lite
Toda decisão segue uma estrutura compacta:
| Seção | Descrição |
|---|---|
| Contexto | Por que essa decisão é necessária |
| Decisão | O que foi decidido |
| Por quê | A razão mais forte |
| Em vez de | Máximo 3 alternativas consideradas |
| Implica | Consequências e áreas afetadas |
Para decisões complexas, um formato estendido adiciona uma seção Trade-offs.
Recursos inteligentes
Inferência automática de alternativas
Se você escrever só a decisão, a IA infere 1-2 alternativas comuns:
/note-decide Usar PostgreSQL no serviço de usuáriosA IA adiciona: Em vez de MongoDB, MySQL — porque essas são as alternativas comuns para uma escolha de banco.
Cadeias de decisão
O sistema busca notas de decisão existentes. Se sua nova decisão substitui uma antiga, ele cria um link “Substitui”:
Substitui: "Usar MongoDB no serviço de usuários" (10 de fev.)Isso constrói um histórico de decisões que você consegue rastrear.
Detecção de duplicatas
Antes de criar uma nova nota, o /note-decide busca decisões anteriores relacionadas e avisa você se uma decisão similar já existe.
Diretrizes para o título
Bons títulos são acionáveis e específicos:
- “Usar JWT para auth” (não “Autenticação”)
- “Deploy no Fly.io” (não “Deploy”)
- “Migrar de REST para GraphQL” (não “API”)
Quando usar /note-decide
Use isso quando quiser registrar por que você escolheu algo, não só o que escolheu. O log de decisões vira indispensável quando:
- Uma pessoa nova no time pergunta “por que a gente fez assim?”
- Você precisa revisitar uma decisão meses depois
- Você quer rastrear como sua arquitetura evoluiu