O que o agente lê antes de pensar.
Como você cuida do contexto da sessão.
Como você opera dentro de uma task.
Como você fala com ele.
Tudo que você empilha em volta dele.
Por que escolhi isso, em uma linha.
enxuto. Formato: trocamos X por Y em DD/MM porque Z.
Quando o Claude (ou você) for tentar reverter algo daqui a três meses, esse arquivo evita o clássico ah, deve ter um motivo, deixa lá.
Só faça a entrada quando a decisão for não-óbvia. Não documenta o trivial.
# decisions.md ## 2026-05-18 · Hash → URL canônica em /aprenda-claude Motivo: OG image per-item precisa rota real, não só hash. Hash routing perde no share. ## 2026-04-22 · Convex Auth no lugar de Clerk Motivo: 1 backend só, sem ponte de identidade, custa metade no plano gratuito.