DECISIONS.MD
Por que escolhi isso, em uma linha.
ADR 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.
Exemplo prático
# 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.Esta ficha é parte do Claude Code OS, o blueprint completo das 25 práticas que separam quem segue tutorial de quem usa Claude de verdade.