Pular para o conteúdo
Beneverso
Equipe

Guia

Schemas e vocabulários do vault

As regras de estrutura: o frontmatter mínimo de toda nota, as extensões por tipo (pauta, personagem, roteiro) e os quatro vocabulários fechados (type, status, source, tags).

Sistema

Original no vault: Beneverso_Vault/99_⚙️_Sistema/Schemas/

Esta página também reúne

  • Beneverso_Vault/99_⚙️_Sistema/Vocabularios/os quatro vocabulários fechados (type, status, source, tags), em pasta IRMÃ de Schemas/, não subpasta dela
Ressalva: INTERESSA A QUEM ESCREVE ARQUIVO NOVO NO VAULT, NÃO A QUEM SÓ CONSOME. É o que impede o vault de virar bagunça de frontmatter. Quem trabalha pelo site não precisa disto. SÃO DE 06/05/2026 E DESCREVEM UM DESENHO QUE FOI PARCIALMENTE SUPERADO. Três descompassos que não corrigi: (1) o `vocab_status` fala em “Líder editorial (humano)” movendo status, e a operação hoje é o Felipe; (2) o `schema_roteiro` traz um bloco de `performance` (views, curtidas, salvamentos) que nenhuma peça do site preenche; (3) o `vocab_type` e o [Padrões de Frontmatter](/guias/anexos-do-sistema) de 11/05 divergem no nome do tipo de roteiro — lá é `roteiro`, aqui são `roteiro_jornal`/`roteiro_ets`/`roteiro_miguel`. Os dois documentos estão no site como estão no vault.

Quatro schemas e quatro vocabulários fechados. O schema diz quais campos uma nota tem; o vocabulário diz quais valores cabem em cada campo.


Schema universal — frontmatter de toda nota

Toda nota deve ter este frontmatter mínimo:

---
title: "Título canônico"
type: <ver vocab_type>
status: <ver vocab_status>
created: 2026-05-06
updated: 2026-05-06
author: <human:<nome> | bot:<agente>>
source: <ver vocab_source>
tags: []
---

Campos obrigatórios

CampoTipoValidação
titlestringnão vazio
typeenumvalor de vocab_type
statusenumvalor de vocab_status
createddata ISOYYYY-MM-DD ou YYYY-MM-DDTHH:MM:SS
updateddata ISOigual ou posterior a created
authorstringpadrão human:<nome> ou bot:<agente>
sourcestringvalor de vocab_source
tagsarraytags do vocab_tags

Campos opcionais universais: aliases (outros nomes da nota, para busca) e cssclass (classe CSS do Obsidian, raro).

Validação

  • Frontmatter inválido bloqueia o agente — agente DEVE retornar erro e parar.
  • Migração: ao alterar schema, registrar em CHANGELOG.md e atualizar todas as notas afetadas via script.

Schema — Pauta

Estende o universal com:

prioridade: <alta | media | baixa>
ultima_atualizacao_pesquisa: 2026-05-06
posicionamento_oficial_benedita: ""
limites_editoriais_especificos: ""       # se houver cuidados além dos universais
dados_chave: []                          # links para fato_dado
adversarios_relacionados: []             # links para adversario
marcos_relacionados: []                  # links para marco_biografico
hashtags_padrao: []

Validação

  • Pauta com prioridade: alta deve ter ultima_atualizacao_pesquisa no máximo 30 dias
  • Pauta deve ter posicionamento_oficial_benedita preenchido (mesmo que com placeholder + <!-- PESQUISA_PENDENTE -->)
  • dados_chave deve linkar fatos com fonte primária

Schema — Personagens

Personagem (ficha)

papel: <ancora_jornal | et | miguel | respondente_miguel | benedita_animada | outro>
formato_visual: feltro
genero:
faixa_etaria:
voice_profile: [[Voice_Profile_<nome>]]
character_pack: [[Character_Pack_<nome>]]

Character Pack

personagem: [[Personagem_<nome>]]
ferramentas_visuais: [freepik, nano_banana, veo3, kling]
ultima_atualizacao_prompts: 2026-05-06
imagem_referencia_principal: "Anexos/<arquivo>.png"

Voice Profile

personagem: [[Personagem_<nome>]]
ferramenta_principal: <elevenlabs | minimax_audio>
voice_id: ""
modelo: ""                              # Multilingual v2 / Turbo v2.5
settings:
  stability: 0.5
  similarity: 0.75
  style: 0.0
  speaker_boost: true

Validação

  • Personagem requer ao menos voice_profile E character_pack linkados
  • Character Pack requer imagem_referencia_principal real (arquivo existente em Anexos/)
  • Voice Profile sem voice_id é considerado pendente — não usar em produção

Schema — Roteiros

Para reels, roteiro_jornal, roteiro_ets, roteiro_miguel, post_carrossel, post_estatico. Estende o universal com:

formato: <reels | carrossel | post_estatico>
personagem: <jornal | ets | miguel | sem_personagem>
duracao_segundos: 45                    # apenas para reels/vídeo
hook: ""
cta: ""
pauta: [direitos-domesticas]            # tags de pauta
plataformas_destino: [instagram, tiktok]
prompts_visuais_gerados: false
revisao_editorial: pendente             # pendente | em_curso | aprovado
trilha_sonora_sugerida: ""              # se aplicável
audio_trend: ""                         # se aplicável
performance:
  views:
  curtidas:
  comentarios:
  compartilhamentos:
  salvamentos:

Específicos por formato

Roteiro Jornal: ancoras: [<ancora1>, <ancora2>] · noticia_origem (link para nota em 25_📰_Noticias_Clipadas/) · escracho_nivel: <leve | medio | pesado>

Roteiro ETs: ets_em_cena: [<et1>, <et2>] · absurdo_politico_alvo

Roteiro Miguel: respondente: <benedita | vovo_sabedoria | outro> · pergunta_central

Validação

  • Se personagem for jornal, requer ancoras
  • Se personagem for ets, requer ets_em_cena
  • Se personagem for miguel, requer respondente e pergunta_central
  • revisao_editorial = aprovado só após o Auditor Editorial visar
  • Status só vai para aprovado (universal) com revisao_editorial = aprovado e visto humano

Vocabulário — type

Toda nota tem type no frontmatter. Use APENAS valores desta lista. Ao precisar de novo, abrir duvidas_para_humano.

Conteúdo (vai virar post): post_estatico (imagem única + legenda) · post_carrossel (3-10 cards) · reels (vídeo curto Instagram/TikTok) · roteiro_jornal · roteiro_ets · roteiro_miguel

Conhecimento: pauta · bandeira (sinônimo de pauta — preferir pauta) · marco_biografico · citacao (frase da Bené com fonte) · adversario · fato_dado (dado quantitativo: IBGE, FBSP, ISP) · noticia · pesquisa_eleitoral

Personagens: personagem · character_pack · voice_profile

Eleitorado: persona_eleitor

Sistema: template · moc · dashboard · prompt_ia · glossario · referencia_visual · meme

Captura: ideia_brainstorm · clipping · transcricao


Vocabulário — status

ValorDescriçãoQuem move para esse status
inboxEntrada bruta, ainda não processadaInbox Bot
em_triagemCurador classificandoCurador Diário
rascunhoPrimeiro draft, geralmente do agenteRoteirista
em_revisaoAguardando review humano ou de auditorAuditor Editorial
aprovadoPassou pela revisão, pode produzirLíder editorial (humano)
em_producaoDesigner/editor está fazendoGerador Visual / Designer
agendadoProduzido, aguardando dataLíder editorial
publicadoFoi ao arLíder editorial
arquivadoTirado de circulaçãoArquivista
descartadoRejeitadoLíder editorial
ativoPara pautas, personagens, recursos vivosSistema

Fluxo padrão de uma peça:

inbox → em_triagem → rascunho → em_revisao → aprovado → em_producao → agendado → publicado → arquivado

Status terminais: publicado (com métricas coletadas) → arquivado; descartado não retorna. Pautas, personagens e recursos vivos são sempre ativo, e só viram arquivado se desativados (ex.: personagem aposentado).


Vocabulário — source

Origem da nota. Use APENAS valores desta lista (ou variantes documentadas).

Humanos: human:<nome>human:andre, human:marina, human:lider_editorial

Bots / agentes: bot:setup (Claude Code/Codex no setup inicial) · bot:inbox · bot:curador · bot:pesquisador · bot:roteirista · bot:auditor · bot:visual · bot:arquivista

Externas: external:<fonte>external:g1, external:camara, external:senado, external:tse, external:tre_rj, external:pt, external:instagram_oficial, external:folha, external:uol, external:cnn_brasil, external:isto_e, external:almapreta, external:brasil_247, external:geledes, external:carta_capital, external:voz_das_comunidades, external:revista_oeste, external:gazeta_do_povo, external:ibge, external:fbsp, external:isp_rj

Composições válidas: bot:roteirista, human:andre (revisão humana sobre output de bot) · external:g1+external:folha (duas fontes externas confirmando)

Em dúvida: se a fonte não cabe nesta lista, criar nota em 00_📥_Inbox/duvidas_para_humano/ propondo novo termo.


Vocabulário — tags

Hierarquia fechada. Sempre minúsculas, com - em palavras compostas.

Conteúdo: #conteudo/post-estatico · /carrossel · /reels · /stories

Formato: #formato/jornal · /ets · /miguel · /avulso

Tom: #tom/serio · /meme · /emocionante · /educativo · /escracho · /afetivo · /solene

Pauta: #pauta/igualdade-racial · /direitos-mulheres-negras · /favela-periferia · /trabalhadoras-domesticas · /cultura · /educacao · /juventude-negra · /lgbtqia · /idosos-previdencia · /evangelicos · /combate-fome · /habitacao · /maternidade-carcere · /seguranca-publica · /lula-governo

Personagem: #personagem/jornal · /ets · /miguel · /benedita-animada · /vovo-sabedoria · /sem-personagem

Plataforma: #plataforma/instagram · /tiktok · /stories

Fonte: #fonte/oficial · /imprensa · /redes-sociais · /comunidade

Agente: #agente/inbox · /curador · /pesquisador · /roteirista · /auditor · /visual · /arquivista

Biografia: #biografia/benedita · /infancia · /militancia · /vereadora · /deputada · /senadora · /governadora · /ministra

Sistema: #sistema · #editorial · #templates · #moc

Quando usar tag, link ou propriedade

Use…QuandoExemplo
Propriedade YAMLAtributo objetivo, filtrávelstatus: agendado
Tag (#)Categoria transversal#pauta/favela-periferia
Link [[]]Relação semântica com entidade que existe[[Benedita da Silva]], [[PEC das Domésticas]]

Original completo

Beneverso_Vault/99_⚙️_Sistema/Schemas/ (4 arquivos) e Beneverso_Vault/99_⚙️_Sistema/Vocabularios/ (4 arquivos). O documento irmão, com os schemas por tipo de arquivo de produção, é o Padrões de Frontmatter.

Transcrição do vault. Mudou o arquivo lá? Atualize lib/guias.ts — o vault é a fonte, esta página é o espelho.