ADR-0002 — Policy modular, neutralidade estrita e boundary comercial¶
Contexto¶
A primeira consolidação tratou a Policy v1 como baseline normativa, usou referências Microsoft para acelerar a arquitetura e colocou material comercial dentro da área executiva. Essa estrutura foi útil para iniciar o framework, mas cria três ambiguidades: a policy histórica parece ser fonte permanente, referências de fornecedor podem parecer componentes da solução e o conteúdo comercial pode ser confundido com conhecimento canônico.
O objetivo atualizado é que o corpus modular evolua para constituir a policy final, mantendo neutralidade real de fornecedor e mantendo o conteúdo comercial fora do framework público.
Forças e constraints¶
- preservar a rastreabilidade da Policy v1 sem mantê-la como dependência normativa;
- evitar uma policy monolítica divergente dos módulos canônicos;
- permitir referências e mappings sem lock-in conceitual ou técnico;
- reutilizar o conhecimento sem misturar conteúdo público, normativo e comercial;
- manter handbook e futuras publicações derivados da mesma fonte;
- adiar ebook até decisão posterior.
Opções consideradas¶
Opção A — Manter Policy v1 como baseline e material comercial em docs/executive/¶
Vantagens: menor mudança estrutural e narrativa normativa simples.
Desvantagens: perpetua lacunas da v1, multiplica citações históricas e mistura comunicação do framework com produto pessoal.
Opção B — Criar uma nova policy monolítica e manter mappings no núcleo¶
Vantagens: documento único de aprovação e leitura direta.
Desvantagens: duplica controls, arquitetura e playbooks; mappings podem contaminar o desenho canônico; manutenção tende a divergir.
Opção C — Policy modular canônica, vendors opcionais e conteúdo comercial fora do repositório¶
Vantagens: uma única fonte de verdade, portabilidade, evolução versionada e boundary comercial explícito.
Desvantagens: exige índices claros, disciplina de status e release, além de atualização de links e validações.
Decisão¶
Adotar a opção C:
docs/governance/policy.mdé a entrada normativa do framework modular e define a composição da policy candidate/final.- A Policy v1 é preservada byte a byte e indexada como origem histórica, sem ser citada repetidamente como fonte corrente.
- O núcleo define capabilities, outcomes, controls, evidências e boundaries sem exigir Microsoft, Agent 365, Cloudflare ou qualquer fornecedor.
- Conteúdo de fornecedor fica limitado a fontes, estudos de caso, assessments e mappings opcionais e removíveis.
- Conteúdo comercial é mantido fora do repositório público, separado da policy, do handbook e de
docs/executive/. - Publicações derivadas usam os módulos canônicos existentes.
- Ebook/PDF permanece adiado; publicação futura será derivada dos módulos canônicos.
Consequências positivas¶
- a policy final pode evoluir sem ficar limitada pela v1;
- vendors não se tornam dependências implícitas do framework;
- readers distinguem conhecimento, policy, evidência externa e produto comercial;
- o handbook continua uma ordem editorial pura;
- packaging e pricing podem evoluir sem alterar o conteúdo canônico.
Consequências negativas¶
- a adoção normativa exige release e authority explícitas;
- links históricos e crosswalks precisam ser mantidos separadamente;
- a modularidade requer boa navegação e prevenção de inconsistências entre módulos;
- propostas comerciais precisam declarar exatamente quais módulos foram incluídos.
Riscos e mitigação¶
| Risco | Mitigação |
|---|---|
| modularidade diluir a força normativa | entrada única de policy, statuses e release versionada |
| vendor retornar ao núcleo por exemplos | quality gate e revisão de paths/linguagem |
| conteúdo comercial redefinir o framework | boundary explícito e links unidirecionais para o conteúdo canônico |
| v1 ser apagada ou reescrita | arquivo histórico protegido por hash |
Critérios de validação¶
- a Policy v1 mantém o mesmo SHA-256 histórico;
docs/handbook/edocs/executive/não contêm produto comercial;- os nove módulos estão mapeados uma única vez para três pacotes;
- core docs não tratam produtos ou fornecedores como requisito da solução;
- a remoção de um mapping de fornecedor não quebra policy, controls, schemas ou gates;
- CI, links, schemas e lint permanecem verdes.
Evidência da decisão¶
Decisão aprovada por Rodrigo Garcia Guimarães em 2026-08-09, junto com tese, cinco planos, oito gates, maturity model, modelo comercial, visual, público principal, packaging 3 pacotes / 9 ofertas e autorização de merge após incorporação destas mudanças.