Decisões
ADR-0001 — Nome e escopo do repositório
- Status: aceita
- Data: 2026-10-18
- Cumpre: ORG-0001
Contexto
A arquitetura de stacks vale para toda stack web da Hibex, de qualquer plataforma. O nome do
repositório precisa dizer isso e combinar com o nome das stacks (<plataforma>-stack-<produto>).
E o repositório precisa deixar claro o que guarda e o que não guarda.
Decisão
- O repositório se chama
stack-architecture, sem prefixo de plataforma: ele é transversal. - Ele guarda:
- a documentação da arquitetura (
README.mdedocs/01–20) e o site gerado dela; - as ORGs, em
docs/decisoes/organizacao/, e as ADRs deste repositório, emdocs/decisoes/; - o modelo zerado de uma stack (ADR-0002);
- os scripts que o acompanham (
eng/), incluindo o kit de rabiscos (ADR-0005).
- a documentação da arquitetura (
- Ele não conhece as stacks que usam o modelo: não lista, não acompanha nem edita nenhuma delas. O que uma stack aprende chega aqui como pedido.
Alternativas consideradas
| Alternativa | Por que não |
|---|---|
enterprise-stack-architecture | Por que não: o prefixo prende a arquitetura a uma plataforma |
Documentação dentro do repositório do design system ou do toolbox | Por que não: assuntos e ritmos diferentes; o design system é uma camada, a plataforma é outra |
Consequências
- A pasta local
architecture/segue até o repositório ser criado no GitHub pelo mantenedor. - Quem procura "como toda stack da Hibex funciona" tem um lugar só.