Publish Contract | Contrato de Publicação

governanca publicacao

Contrato canônico que define o que é publicado em cada wiki. Prevalece sobre convenções informais. Alterações requerem entrada em decisoes. Aplicado por audience-scheme (frontmatter) + defaults desta tabela + denylist absoluta.


1. Denylist absoluta (NUNCA publicar em nenhuma wiki)

Estes caminhos são sempre bloqueados, mesmo com frontmatter contrário:

CaminhoRazão
agentes-core/axios/memory/**Memória privada do Axios
agentes-core/axios/memory/feedback/**Feedback, correções (privado)
agentes-core/axios/memory/sessions/**Sessões operacionais
99-operacao/scripts/**Scripts internos
.obsidian/**Configuração Obsidian
_bases/**Bases dinâmicas (não renderizam em HTML)
_templates/**Templates de autoria
_assets/** (exceto imagens referenciadas)Controlado pelo Quartz automaticamente
**/*sensivel*Qualquer arquivo com “sensivel” no nome
Arquivos com tag #sensivelGuardrail de segurança
Arquivos com publish: noneOpt-out explícito

2. Default por pasta

Aplicado quando o arquivo não declara publish: no frontmatter.

PastaDefaultJustificativa
HOME.md, README.md[internal, client, board]Ponto de entrada de todas as audiências
AXIOS-HANDOFF.md[internal]Instruções para agente, só time Anouk
00-projeto/ (raiz)[internal]Governança interna
00-projeto/governanca/visao-geral.md[internal, client]Visão do projeto — útil ao cliente
00-projeto/governanca/stakeholders.md[internal]Mapa executivo interno
00-projeto/governanca/glossario.md[internal, client]Terminologia compartilhada
00-projeto/governanca/MEMORY-CONTRACT.md[internal]Meta-documento Anouk
00-projeto/canonico/decisoes.md[internal]Log completo interno
00-projeto/canonico/riscos.md[internal]Estado cru Anouk
00-projeto/canonico/gaps.md[internal]Estado cru Anouk
00-projeto/canonico/dependencias.md[internal]Estado cru Anouk
00-projeto/reunioes/[internal]Atas internas
00-projeto/missoes/missao-*.md[internal]Missões da equipe
00-projeto/assessment/assessment-plan.md[internal, client]Plano do assessment — visível a Igor
00-projeto/assessment/plano-assessment-igor.md[internal, client]Feito para Igor
00-projeto/assessment/qa-igor.md[internal]Perguntas internas
01-colliers/[internal]Frente Colliers — interno (por ora)
01-colliers.md[internal, client]Visão alta para cliente (folder note)
02-costal.md[internal, client]Visão alta (folder note)
02-costal/plano/[internal, client]Plano estratégico — compartilhável
02-costal/agentes/[internal, client]Catálogo de agentes — visível ao cliente
02-costal/meetings/[internal]Atas internas
02-costal/meetings/*_summary_brief.md[internal, client]Briefs são para compartilhar
02-costal/pesquisa/[internal]Pesquisa bruta
02-costal/specs/[internal, client]Specs quando maduras — ver exceção abaixo
03-arquitetura/[internal, client]Arquitetura técnica compartilhada
04-referencia/[internal]PDFs originais (PDFs não publicam bem)
04-referencia.md[internal, client]Índice de referências (folder note)
05-arquitetura-empresarial/[internal, client]Modelo global de dados — Blaschek
00-projeto/directory/[internal]Diretório Anouk
00-projeto/directory.md, 00-projeto/directory/pessoas-index.md, 00-projeto/directory/times-index.md[internal]Folder notes sempre internos
99-operacao/[internal]Operação Anouk
99-operacao/publish/** (meta-config)[internal]Scaffolds da própria publicação — visíveis só na wiki interna
agentes-core/axios.md[internal]Visível Anouk (folder note)
agentes-core/axios/system-prompt.md[internal]Não compartilhar externamente
agentes-core/axios/operating-model.md[internal]Interno
agentes-core/axios/outputs/[internal]Outputs operacionais Anouk
Qualquer outro arquivo sem default explícito[internal]Conservador por padrão

3. Exceções nomeadas (override do default)

Arquivos específicos que quebram o default da pasta — marcar explicitamente no frontmatter:

ArquivoFrontmatter explícito
Briefs executivos para boardpublish: [internal, client, board]
Summaries de reunião para clientepublish: [internal, client]
Entregáveis finais para Costalpublish: [internal, client]
Drafts em andamentopublish: [internal] + tag #draft

4. Checklist para tagar o vault (primeira passada)

Antes do primeiro build, Pedro deve tagar manualmente os arquivos-chave. Ordem sugerida:

  • HOME.mdpublish: [internal, client, board]
  • README.mdpublish: [internal, client, board]
  • 02-costal/plano/ (todos os arquivos principais) → publish: [internal, client]
  • 05-arquitetura-empresarial/arquitetura-empresarial.mdpublish: [internal, client]
  • 05-arquitetura-empresarial/modelo-global-dados.mdpublish: [internal, client]
  • 00-projeto/governanca/visao-geral.mdpublish: [internal, client]
  • 00-projeto/assessment/assessment-plan.mdpublish: [internal, client]
  • Cada *_summary_brief.md importante → publish: [internal, client]
  • Criar primeiro brief board dedicado: 00-projeto/board/brief-board-2026-q2.mdpublish: [internal, client, board]

Os demais arquivos usam default da §2 e podem ser refinados depois.


Problema: arquivo A publicado em client linka para arquivo B marcado [internal] — na wiki de cliente o link fica quebrado.

Regra:

  1. O build Quartz converte links quebrados por audiência em texto plano + aviso: [Conteúdo interno — não disponível nesta wiki]
  2. Time Anouk deve tentar não criar essas dependências, mas quando acontece, é aceitável
  3. O validador (futuro) relata esses links para revisão

6. Branding por wiki

WikiTemaLogoTítulo
internalDark, técnicoAnouk”Colliers × Costal — Interno”
clientLight, limpoAnouk + Costal”Colliers × Costal — Base de Conhecimento”
boardLight, executivoAnouk + Colliers”Colliers × Costal — Board”

Assets em 99-operacao/publish/quartz/assets/ (a criar conforme necessidade).


7. Revisão

  • Owner: Pedro Villa
  • Cadência: mensal ou a cada mudança material no regime de publicação
  • Alterações: via commit direto com entrada em decisoes

Ver também