Índice e jornadas de leitura¶
O repositório usa documentos modulares como fonte canônica. Escolha uma jornada; não é necessário ler tudo em sequência.
Vai implantar? Use as trilhas de leitura, que dão uma ordem só e terminam em decisões. Esta página é referência para localizar assuntos — ela oferece muitos caminhos de propósito, e isso atrapalha quem precisa de um.
Por onde começar, conforme o estágio da organização¶
As jornadas por persona respondem "o que eu leio". Esta tabela responde antes: por onde a organização entra.
| Estágio | Entrada recomendada | Por quê |
|---|---|---|
| sem programa formal | brief executivo → decisão arquitetural → descoberta do estate → capability map | não comece comprando ferramenta; comece por escopo, estate e mandato |
| com pilotos em andamento | maturity model → gestão de riscos → Minimum Production Bar | descubra os gaps e defina o piso de controles antes de escalar o que já existe |
| já operando em escala | control catalog → evidence pack por tier → catálogo de artefatos | use os domínios como modelo de auditoria e o catálogo como índice de completude |
Os únicos gates canônicos são G0–G7. O programa de 24 semanas, o roadmap de 90 dias e o plano de piloto são recortes adaptáveis do mesmo conjunto de gates — não programas concorrentes nem prazos de compliance.
Jornada por persona¶
Conselho, executivo ou sponsor¶
Objetivo: decidir mandato, apetite a risco, funding e accountability.
Decisões esperadas: sponsor, escopo, risk appetite, autoridade de contenção e critérios de valor.
CISO, DPO, jurídico, compliance ou Responsible AI¶
Objetivo: definir controles, assurance, exceções e evidências.
- Policy modular
- Gestão de riscos
- Segurança
- Responsible AI
- Human oversight
- Auditabilidade
- Control catalog
Decisões esperadas: triggers de assessment, risk acceptance, human approval, retenção, monitoramento e waiver.
Arquitetura e plataforma¶
Objetivo: construir o control plane e integrar os sistemas especializados.
- Arquitetura de referência
- Design patterns
- Estate, registry e taxonomia
- Identidade
- Dados
- Tools e MCP
- Modelos e provedores
- Schemas
Decisões esperadas: source of truth, blueprint, workload identity, gateways, enforcement points e adapters por plataforma.
Product owner, maker ou engenharia¶
Objetivo: levar um agente da hipótese à operação com evidência suficiente.
- Implementation playbook
- Roadmap sugestivo de 90 dias
- Risk pre-screen
- Evaluations
- Adoção e suporte
- Templates
- Examples
- Publication checklist
Decisões esperadas: escopo, risco, dados, tools, evals, release, rollback e sunset.
Operações, SOC, suporte ou SRE¶
Objetivo: observar comportamento e executar resposta proporcional.
- Operações
- Auditabilidade
- Lifecycle, mudança material e retirement
- Runtime observability and quarantine pattern
- Lifecycle attestation and sunset pattern
- Sunset plan
Decisões esperadas: SLOs, alertas, incident severity, quarantine, reactivation, attestation e retirement.
Auditoria, assurance e challenge¶
Objetivo: verificar design, operação e evidência sem assumir o papel do owner nem presumir independência não demonstrada.
Decisões esperadas: suficiência de evidência, grau de segregação/independência quando aplicável, findings, prazo de remediação e attestation.
Líder de transformação¶
Objetivo: conduzir diagnóstico, target state, roadmap e transferência de capacidade.
- Handbook
- Implementation playbook
- Programa sugestivo de 24 semanas
- Plano opcional de piloto
- Maturity model
- Design patterns
- Toolkit
Decisões esperadas: baseline, gaps, target operating model, backlog priorizado, entregáveis e critérios de aceite.
Jornada por objetivo¶
| Objetivo | Documentos principais |
|---|---|
| definir policy e accountability | Policy modular + operating model |
| inventariar agentes | Estate e registry + descoberta e forecast + schemas |
| decidir se o caso pede um agente | Decisão arquitetural + intake |
| mapear capacidades atuais e alvo | Capability map + maturity model |
| planejar artefatos, owners e fases | Catálogo de artefatos + programa de 24 semanas |
| classificar risco e admissibilidade | Risk-tiered governance + risk management + Agent Risk Record |
| governar identidade e dados | Identity + data access |
| governar tools e MCP | Tool governance + MCP gateway pattern |
| governar modelos e provedores | Model governance + evaluations |
| governar mudança e retirement | Lifecycle + lifecycle pattern |
| publicar com evidência | Evaluations + control catalog + release manifest |
| operar e conter | Operations + runtime pattern |
| medir maturidade | Maturity model + assessment example |
| medir portfólio e valor | Strategy and value + lifecycle pattern |
| estruturar adoção e suporte | Adoption + operations |
| estudar um caso Microsoft opcional | Customer Zero case + crosswalk histórico |
| ver o framework aplicado ponta a ponta | Casos de referência + implementation playbook |
| seguir uma leitura linear | Handbook |
Navegação por pasta¶
O handbook e as jornadas acima são a leitura orientada. Quem prefere navegar a estrutura direto no repositório encontra um índice curto em cada pasta:
| Pasta | Índice |
|---|---|
| arquitetura | docs/architecture/ — visão, princípios, atributos de qualidade, riscos, diagramas e decision log |
| executivo | docs/executive/ — conteúdo orientado a decisão |
| governança | docs/governance/ — policy modular e operating model |
| guias | docs/guides/ — playbook, roadmaps e piloto |
| referência técnica | docs/reference/ — glossário, catálogo de artefatos e checklist de autossuficiência |
| fontes | references/ — regras de proveniência, ledger de fontes e bibliografia |
Esses índices existem para navegação de pasta e não constituem uma segunda ordem editorial. A ordem canônica é a do handbook.
Camadas do conhecimento¶
- Normativo: policy modular e decisões formalmente aprovadas.
- Arquitetural: princípios, operating model, boundaries e patterns.
- Operacional: playbooks, controls, schemas, templates e checklists.
- Explicativo: rationale, casos, mappings e referências.
Um documento de guidance não altera a policy. Um estudo de caso não comprova eficácia causal. Um mapping de fornecedor não redefine o núcleo.
Leitura completa¶
Para leitura linear, use o handbook. A geração de uma publicação fica para uma etapa futura, quando o conteúdo estiver maduro.