Decisões
ADR-0002 — O modelo zerado mora neste repositório
- Status: aceita
- Data: 2026-10-18
- Cumpre: ORG-0001, ORG-0006
Contexto
Toda stack nasce de um modelo zerado: os arquivos da Fase 0, com as ORGs copiadas, as ADRs
pré-escritas, a ficha e os demais pontos em {{LACUNA:<id>}}. Se o modelo vivesse num
repositório separado, a regra (aqui) e o modelo (lá) poderiam sair em versões diferentes.
Decisão
- O modelo zerado mora aqui, em
modelo/, versionado junto com a documentação e as ORGs. eng/new-stack.shcria uma stack copiandomodelo/edocs/decisoes/organizacao/na versão escolhida, e grava essa versão no arquivoARQUITETURAda stack. Antes da primeira versão, o modo--draftcopia a árvore de trabalho e gravaarquitetura-rascunho-<commit>.- Toda lacuna do modelo tem
idúnico e descrição;grep -rn '{{LACUNA:' modelo/lista todas. - Os scripts do modelo (lacunas, versões fixas, hooks) têm testes próprios, que rodam na CI deste repositório.
Alternativas consideradas
| Alternativa | Por que não |
|---|---|
| Repositório-modelo separado (GitHub template repository) | Por que não: regra e modelo mudariam em versões separadas |
| Gerador interativo (ex.: um CLI de scaffolding) | Por que não: mais uma ferramenta para manter; as lacunas já fazem o papel das perguntas |
Consequências
- Uma tag da arquitetura fixa, ao mesmo tempo, as regras, as ORGs e o modelo.
- Uma mudança de regra que afeta o modelo sai numa change só.