ORG-0001 — Registrar decisões em dois níveis

Uma stack toma dezenas de decisões técnicas, e quem chega depois (uma pessoa ou um agente numa sessão nova) precisa saber o que foi decidido e por quê, sem reconstituir a conversa. Parte dessas decisões vale para toda stack da Hibex; parte vale só para uma. Numa sequência única, as duas se misturam e os números colidem quando a organização acrescenta uma decisão a stacks que já existem.

1. Toda decisão técnica com alternativas vira um registro curto, com contexto, decisão, alternativas consideradas e consequências.
2. Duas famílias, cada uma com a sua sequência desde 0001:
   • ORG (Organization Architecture Decision Record): vale para toda stack. Nasce no repositório stack-architecture, em docs/decisoes/organizacao/ORG-NNNN-slug.md;
   • ADR (Architecture Decision Record): vale para uma stack. Nasce nela, em docs/decisoes/ADR-NNNN-slug.md.
3. Cada família tem o seu template.md, e as duas entram no mesmo índice, docs/decisoes/README.md, as ORGs primeiro.
4. Na stack, as ORGs são uma cópia da pasta docs/decisoes/organizacao/, na versão do arquivo ARQUITETURA, nunca editada à mão.
5. Registro escrito por agente nasce proposto; só o mantenedor aceita. Registro aceito não se reescreve: vira substituído, com link para o que o substitui. Revisão que só re-fundamenta leva uma linha "Revisão: data — motivo" no cabeçalho.
6. Divisão de papéis: ORG/ADR dizem como e por quê (técnico); a spec diz o que o produto faz; a solução diz como algo foi montado em detalhe; o guia diz como operar.

• Quem lê o identificador sabe de onde a decisão veio; as duas famílias nunca colidem.
• Uma versão nova da arquitetura acrescenta ORGs sem tocar na numeração das ADRs das stacks.
• A pasta organizacao/ da stack só muda numa change de atualização da arquitetura.

O detalhe está na documentação da arquitetura.