adr/ — Architecture Decision Records¶

Decisões arquiteturais não óbvias do Cadência. Cada ADR responde "por que isso é assim?" com contexto, decisão, consequências e alternativas descartadas.

Formato Matt Pocock minimalista (1-3 frases por seção). Imutáveis — não se reescreve ADR, abre-se um novo que supersede.

ADRs vigentes¶

Quando consultar uma ADR¶

• Antes de reverter decisão ("não seria melhor X?") — leia o ADR original primeiro.
• Antes de mexer em algo que parece estranho — pode ser decisão deliberada documentada aqui.
• Antes de abrir nova ADR — verifique se já não há uma cobrindo o tema.

Como criar uma ADR nova¶

1. Próximo número sequencial (0007-*.md).
2. Use o template de qualquer ADR existente como referência.
3. Status inicial proposto → após decisão Felipe, aceito.
4. Não edita ADR aceito — supersede com novo (e adiciona "Substituído por ADR-NNNN" no antigo).

Refs¶

• Voltar: ../README.md
• Skill: /documentar cria ADRs automaticamente quando detecta decisão não óbvia no código.