Consolidar Governança Corporativa Costal em 02-costal/governanca/ (17 docs em .md)

T-125 — Consolidar Governança Corporativa Costal em 02-costal/governanca/

Owner: Pedro Villa · Co-owner: Rafael · Frente: costal · Prazo: 2026-05-09 · Status: concluida · Prioridade: alta

Descrição

Pedro (04/05): “Precisamos criar 02-costal/governanca com este material consolidado e corretamente indexado em .md para que possamos utilizar no nosso trabalho de arquitetura de desenho dos agentes.”

Material-fonte: pasta 04-referencia/costal/COSTAL - GOVERNANÇA CORPORATIVA/ — 17 arquivos .docx (R00, 2026-03-14): 1 Declaração de Propósito + 1 Documento Mestre de Diretrizes + 15 Diretrizes individuais (DIR-01 a DIR-15). Igor (03/05) sinalizou que esse material já é a referência para a estruturação das diretrizes e processos da Costal, ainda que precise de validação final.

Origem

05 §4.3 + pedido explícito Pedro 04/05

Critérios de conclusão

• Pasta 02-costal/governanca/ criada
• 17 arquivos .docx convertidos para .md via pandoc
• Frontmatter padronizado adicionado a todos os 17 arquivos (script 99-operacao/scripts/add-governanca-frontmatter.py)
• Folder note 02-costal/governanca.md criada com índice canônico + mapa de relevância para os agentes (Atlas, Change Order, fornecedores, dados)
• 02-costal.md atualizado com link para governanca/ na seção de subpastas e nos documentos canônicos
• Wikilinks bidirecionais entre governanca.md ↔ orcamentacao-spec.md, atlas.md, decisoes.md
• Confirmar com Igor o status atual de validação/maturidade (R01+ a homologar) — pendente
• Atualizar AE Costal §referências externas linkando esse material — deferido (próxima passagem)

Estrutura criada

02-costal/
├── governanca.md                          ← folder note canônica (índice + mapa de relevância)
└── governanca/
    ├── 00-declaracao-proposito.md         ← Missão + Visão + Valores
    ├── 00-diretrizes-corporativas.md      ← Documento mestre (2569 linhas)
    └── dir-01 a dir-15 (.md)              ← 15 diretrizes individuais

Total: 17 arquivos .md + 1 folder note. ~18.5k linhas de conteúdo canônico Costal.

Mapa de relevância para os agentes Anouk

Diretriz	Por que é crítica para Anouk
DIR-01 (Governança)	Estrutura de alçadas → DP-3 (T-122)
DIR-04 (Gestão de Riscos)	Fundamenta R-022/R-023/R-024 e Análise de Riscos formal (spec §9a.2)
DIR-05 (Gestão de Projetos e Obras)	Fundamenta orcamentacao-spec, Change Orders (DP-3), cronograma 4 camadas
DIR-07 (Seleção de Mercado)	Critérios go/no-go (Igor 03/05 §3.3)
DIR-09 (Disciplina Financeira)	BDI, custo financeiro, alavancagem (spec §8)
DIR-10 (Margem)	KPIs (spec §15) e soft logic do cronograma (alta margem)
DIR-14 (Informação e Dados)	Bronze/Silver/Gold do Lake; LGPD
DIR-15 (Digitalização e Sistemas)	Estratégia de digitalização e governança de TI

Histórico de status

• 2026-05-04 — criada e concluída no mesmo dia · 17 arquivos consolidados · folder note + mapa de relevância
• 2026-05-04 (revisão) — Pedro identificou markdown incorreto (TOC bruto inline + headings setext + NBSP U+2011 + spans HTML de bookmarks Word + listas loose). Re-engenharia do pipeline:
  • novo script ingest-governanca.py substitui o anterior (add-governanca-frontmatter.py deprecated com stub)
  • re-execução com pandoc --to gfm --shift-heading-level-by=1 --wrap=none + pós-processamento Python
  • lixo residual zerado: 0 spans Toc, 0 TOC inline, 0 setext, 0 NBSP residuais
  • auditoria detectou 3 inconsistências no documento-fonte Costal (não na conversão): DIR-04 com POL-04.05 duplicado, DIR-13 e DIR-15 com conteúdo trocado entre si — documentadas na §“Inconsistências detectadas no documento-fonte” da folder note governanca.md. Levar à validação Igor antes de R01.

Ver também

• Governança Corporativa — folder note canônica (inclui auditoria das inconsistências fonte)
• 05 §4.3
• T-121 — boundary Tatiana + Pierangeli
• Script canônico: 99-operacao/scripts/ingest-governanca.py (idempotente; usar para reingerir R01+)