Publish Contract | Contrato de Publicação
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:
| Caminho | Razã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 #sensivel | Guardrail de segurança |
Arquivos com publish: none | Opt-out explícito |
2. Default por pasta
Aplicado quando o arquivo não declara publish: no frontmatter.
| Pasta | Default | Justificativa |
|---|---|---|
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:
| Arquivo | Frontmatter explícito |
|---|---|
| Briefs executivos para board | publish: [internal, client, board] |
| Summaries de reunião para cliente | publish: [internal, client] |
| Entregáveis finais para Costal | publish: [internal, client] |
| Drafts em andamento | publish: [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.md→publish: [internal, client, board] -
README.md→publish: [internal, client, board] -
02-costal/plano/(todos os arquivos principais) →publish: [internal, client] -
05-arquitetura-empresarial/arquitetura-empresarial.md→publish: [internal, client] -
05-arquitetura-empresarial/modelo-global-dados.md→publish: [internal, client] -
00-projeto/governanca/visao-geral.md→publish: [internal, client] -
00-projeto/assessment/assessment-plan.md→publish: [internal, client] - Cada
*_summary_brief.mdimportante →publish: [internal, client] - Criar primeiro brief board dedicado:
00-projeto/board/brief-board-2026-q2.md→publish: [internal, client, board]
Os demais arquivos usam default da §2 e podem ser refinados depois.
5. Tratamento de links cruzados entre audiências
Problema: arquivo A publicado em client linka para arquivo B marcado [internal] — na wiki de cliente o link fica quebrado.
Regra:
- O build Quartz converte links quebrados por audiência em texto plano + aviso:
[Conteúdo interno — não disponível nesta wiki] - Time Anouk deve tentar não criar essas dependências, mas quando acontece, é aceitável
- O validador (futuro) relata esses links para revisão
6. Branding por wiki
| Wiki | Tema | Logo | Título |
|---|---|---|---|
internal | Dark, técnico | Anouk | ”Colliers × Costal — Interno” |
client | Light, limpo | Anouk + Costal | ”Colliers × Costal — Base de Conhecimento” |
board | Light, executivo | Anouk + 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
- Publish — visão geral
- audience-scheme — frontmatter
- deployment-guide
- cloudflare-setup
- MEMORY-CONTRACT §6