Decisões
ORG-0002 — Uma ADR nunca contradiz uma ORG
- Status: aceita
- Data: 2026-10-18
- Decide: a ADR decide dentro do que as ORGs deixam em aberto; o que uma ORG não permite vira pedido à arquitetura
Contexto
ORGs e ADRs valem como decisão para a stack. Sem uma regra de precedência, uma ADR local poderia afrouxar uma ORG "por enquanto", e a regra comum deixaria de ser comum sem que ninguém na organização soubesse. A arquitetura segue o princípio "a camada de cima vence": plataforma > arquitetura > stack.
Decisão
- Uma ADR decide dentro do que as ORGs deixam em aberto. Ela nunca afrouxa, contorna nem suspende uma ORG, nem temporariamente.
- Quando a stack precisa de algo que uma ORG não permite, o caminho é um pedido ao
repositório
stack-architecture. Até uma versão nova mudar a ORG, vale a ORG. - Toda ADR declara, no campo Cumpre do cabeçalho, as ORGs que atende.
- A revisão de toda change confere que nenhuma ADR nova ou alterada contradiz uma ORG.
- Quando uma versão nova da arquitetura substitui uma ORG, a change de atualização da arquitetura revê as ADRs que a cumpriam.
Alternativas consideradas
| Alternativa | Por que não |
|---|---|
| Permitir exceção local registrada em ADR | Por que não: a regra comum vira sugestão; cada stack diverge um pouco, e a organização não fica sabendo |
| Precedência só como recomendação no texto | Por que não: sem ser decisão, não há o que conferir na revisão |
Consequências
- O que falta numa ORG chega à arquitetura como pedido, e a melhoria vale para todas as stacks.
- A stack às vezes espera uma versão nova da arquitetura para fazer algo diferente.
- O campo Cumpre torna a revisão objetiva: cada ADR diz a que ORGs responde.
Mais
O detalhe está na documentação da arquitetura.