Decisões
ORG-0006 — Estrutura de diretórios
- Status: aceita
- Data: 2026-10-18
- Decide: toda stack tem o mesmo esqueleto de pastas, seja qual for a tecnologia
Contexto
Quem trabalha em mais de uma stack (pessoas e agentes) perde tempo procurando onde fica cada coisa quando cada repositório inventa a própria organização.
Decisão
- Toda stack tem o esqueleto:
README.md,AGENTS.md,CLAUDE.md,ARQUITETURA,docs/,openspec/,e2e/,deploy/<app>/,eng/,vendor/hibex/,compose.yaml,.claude/e.github/. - Os módulos de código e o que cada um contém são decididos pela stack, numa ADR.
- Criar pasta fora da estrutura exige motivo; um tipo novo de pasta exige ADR.
Alternativas consideradas
| Alternativa | Por que não |
|---|---|
| Estrutura livre por stack | Por que não: cada repositório vira um mapa novo para aprender |
| Estrutura fixa até os módulos de código | Por que não: os módulos dependem da linguagem e do produto |
Consequências
- Scripts, guias e o agente podem presumir os mesmos caminhos em toda stack.
- A forma do código continua livre, dentro do esqueleto.
Mais
O detalhe está na documentação da arquitetura.