Skip to content

Parte VII — ADRs: a memória das decisões

A pergunta desta parte: seis meses depois, quando alguém perguntar "por que foi feito assim?", onde está a resposta?

Analogia âncora: a ata da decisão — sem ela, o debate que já foi resolvido recomeça do zero a cada novo dev que chega.

ADR (Architecture Decision Record) é o registro do projeto, não da feature. Esta Parte mostra o filtro de 5 critérios que decide o que merece virar ADR, o ciclo de vida de uma decisão e como o Gate 1 já pega violações triviais de ADR antes que cascateiem.

Capítulos desta parte

O que vira ADR
Os 5 critérios e as 14 tags. Capítulo 20 →
O lifecycle
Nygard, status e supersede. Capítulo 21 →
ADR Compliance Light
O sweep grep no Gate 1. Capítulo 22 →

Ao final, faça os exercícios da Parte VII para fixar (gabarito no Apêndice F).

AgentSpec Framework · Spec-driven com IA sobre Claude Code