Pular para o conteúdo
Beneverso
Equipe

Guia

Anexos de sistema — ecossistema de agentes e padrões de frontmatter

‹ Guias

Dois dos três anexos do 99_Sistema: o mapa de quem faz o quê na operação de IA (com fluxo, disparo e status de cada agente) e o padrão de metadado de cada tipo de arquivo.

Sistema

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

Ressalva: O TERCEIRO ANEXO NÃO ENTROU. A pasta tem três arquivos; o que falta aqui é o `Infraestrutura_VPS_OpenClaw.md`. Ele traz IP público do servidor, endereço e usuário de SSH, nomes de container e o procedimento de rotação de chaves. O próprio documento avisa, com razão, que não contém segredo nenhum — mas esta área da equipe está SEM SENHA desde 13/08/2026, e um mapa de onde bater não deixa de ser um mapa de onde bater só porque as chaves estão noutro lugar. Ele continua no vault, para quem precisar. O ECOSSISTEMA DE AGENTES É DE 09/05/2026 E ENVELHECEU EM DOIS PONTOS QUE IMPORTAM. (1) O Pesquisador Semanal aparece aqui como “a migrar”; a migração foi feita em 19/05 e o cron foi desativado — ver [Pesquisador Semanal](/guias/pesquisador-semanal). (2) O Roteirista aparece como operacional; desde então o Felipe determinou que ele **não deve ser usado** — ver [Regras de trabalho](/guias/regras-de-trabalho). Não corrigi o documento: as duas notícias estão nos guias que as trazem. Custos e modelos são os de maio/2026.

1. Ecossistema de Agentes Beneverso

Mapa do que cada agente faz, onde roda, quando dispara, e como os agentes se conectam pra produzir conteúdo.

Norte editorial unificado (leitura obrigatória dos agentes)

Toda SKILL operacional (Clipper, Carrossel News, Imagem Carrossel, Roteirista, Auditor, Visual, Editor de Pauta) DEVE ler estes 3 docs no início de cada run:

  1. Estratégia Editorial — objetivo final, escopo de pesquisa ampliado (política + pop + esporte + viral), 3 linhas editoriais (deboche / militância / meme-pop), mapping pauta×linha×formato×personagem, regras NUNCA transversais
  2. Tom de Voz — voz constante + 5 tons flexíveis + vocabulário Beneverso ("tamo junto", "ó gente", "aquilombar", etc) + mix semanal 8 posts
  3. Limites Editoriais — PODE / NÃO PODE / CUIDADO detalhados

Sem essa leitura no início, agentes geram output mecânico (formato sem tom). Esses 3 docs são carregamento obrigatório no contexto antes de qualquer produção.

Visão geral (fluxo de produção)

┌─────────────────── ENTRADA (humano + cron) ─────────────────┐
│                                                             │
│  Equipe → Telegram grupo                                    │
│                  ↓                                          │
│            [Inbox Bot] ✅                                    │
│                  ↓                                          │
│            00_📥_Inbox/                                     │
│                                                             │
│  Cron 02h-BR → [Clipper] ✅ → 25_📰_Noticias_Clipadas/      │
│                              + 27_😂_Memes_em_Alta/         │
│                                                             │
└─────────────────────────────────────────────────────────────┘
                          ↓
┌─────────────── ORGANIZAÇÃO (cron 04h-BR) ──────────────────┐
│                                                            │
│  [Organizador] ✅                                           │
│   - Move inbox → pastas certas                             │
│   - Atualiza dashboards                                    │
│   - Gera Relatório Diário                                  │
│   - Cria pendências para humano                            │
│                                                            │
└────────────────────────────────────────────────────────────┘
                          ↓
┌────────────── PRODUÇÃO (cron + sob demanda) ───────────────┐
│                                                            │
│  Cron 06h-BR → [Carrossel de Notícias] ✅                  │
│                  ↓                                         │
│              10_🎬_Conteudo/Carrosseis/                    │
│                  ↓                                         │
│  Cron 06h30-BR → [Imagem Carrossel] ✅                     │
│                  ↓ Gemini 3 Pro Image (Nano Banana 2)      │
│              80_📤_Outputs/Imagens_Geradas/                │
│                                                            │
│  @beneverso-roteirista → [Roteirista] ✅                   │
│                  ↓ pega tema do Felipe                     │
│              10_🎬_Conteudo/<formato>/<personagem>/        │
│                  ↓                                         │
│  @beneverso-auditor → [Auditor Editorial] ✅               │
│                  ↓ check vs Tom_de_Voz + Limites           │
│              edita arquivo: revisao_editorial: aprovado    │
│                  ↓                                         │
│  @beneverso-visual → [Gerador Visual] ✅                   │
│                  ↓ lê Character Pack via Vision            │
│              80_📤_Outputs/Briefings_para_Designer/        │
│              + roteiro com Prompts Visuais preenchidos     │
│                                                            │
└────────────────────────────────────────────────────────────┘
                          ↓
┌────────────── PESQUISA (semanal/mensal) ───────────────────┐
│                                                            │
│  Domingo 02h → [Pesquisador Semanal] 🔄                    │
│                ChatGPT Custom GPT (planejado migrar)       │
│                  ↓ Deep Research                           │
│              80_📤_Outputs/Relatorios_Semanais/            │
│              30_🚩_Pautas_e_Bandeiras/ (atualiza)          │
│              23_⚔️_Adversarios/ (atualiza)                 │
│                                                            │
│  Mensal (dia 1, 03h) → [Arquivista] ✅                     │
│                  ↓ coleta métricas + arquiva >30d          │
│              80_📤_Outputs/Relatorios_Mensais/             │
│              90_🗄️_Arquivo/<ano>/<ano-mes>/                │
│                                                            │
└────────────────────────────────────────────────────────────┘

Status por agente

#AgenteOnde rodaModeloDisparoStatus
1Inbox BotOpenClaw VPSGemini 2.5 FlashTelegram grupo✅ Operacional
2ClipperOpenClaw VPS (cron 02h)Claude Haiku 4.5Cron diário✅ Operacional
3OrganizadorOpenClaw VPS (cron 04h)Claude Haiku 4.5Cron diário✅ Operacional (iterando)
4Carrossel de NotíciasOpenClaw VPS (cron 06h)Claude Haiku 4.5Cron diário✅ Operacional
5Beneverso DMOpenClaw VPSClaude Haiku 4.5Você no DM✅ Operacional
6Pesquisador SemanalChatGPT Custom GPTGPT (Deep Research)Domingo manual🔄 A migrar (plano pronto)
7RoteiristaClaude Code (Felipe + Claude)Sonnet 4.5Sob demanda✅ Operacional
8Gerador VisualClaude CodeSonnet 4.5 + VisionSob demanda✅ Operacional
9Auditor EditorialClaude CodeSonnet 4.5Antes de publicar✅ Operacional
10ArquivistaOpenClaw VPS (cron mensal dia 1, 03h)Claude Haiku 4.5Cron mensal✅ Operacional
11Imagem CarrosselOpenClaw VPS (cron 06h30)Claude Haiku 4.5 + Gemini 3 Pro ImageCron diário (depois do Carrossel)✅ Operacional (testado 10/05)

Legenda: ✅ Operacional (rodando em produção) · 🆕 Em criação · 🔄 A migrar (funcionalidade existe mas em plataforma errada) · 📝 A criar (só doc/visão).

Filosofia: humano-no-loop

Bots fazem 90% do trabalho braçal (clipar, transcrever, classificar, formatar). Humano (Felipe + equipe) revisa, decide editorialmente, publica. Quando bot vacila, miss vai pra pendencias.md e a gente atualiza o SKILL pra próxima rodada melhorar.

Não é mágica, é iterativo. Cada vacilo aprendido vira regra explícita no SKILL.

Integrações externas

  • Telegram — recebe (inbox-bot) e envia (notificações)
  • GitHub — vault sincroniza via deploy key SSH
  • Anthropic API — modelos Claude
  • Google API — Gemini (em standby, problema com cron OpenClaw)
  • Ferramentas visuais (planejado): freepik, nano_banana (Gemini), veo3, kling, suno

2. Padrões de Frontmatter Beneverso

Documento de referência. Toda peça/nota nova no vault segue um dos schemas abaixo. Vault legível pra equipe humana + parseável pra IA.

Filosofia

  • Mínimo obrigatório: todo arquivo tem title, type, status, created, updated, tags
  • Específico por tipo: cada type tem campos próprios obrigatórios e opcionais
  • Datas em ISO 8601 com timezone quando relevante (2026-05-11T14:30:00-03:00)
  • Status enum fechado: rascunho | em_revisao | aprovado | em_producao | publicado | arquivado | ativo | gerado
  • Links Obsidian com [[Nome_da_Nota]] (sem path se possível, com path se ambíguo)

dashboard (docs de sistema, longa vida)

Para Tom_de_Voz, Limites_Editoriais, Estrategia_Editorial, Ecossistema_Agentes, este próprio doc, etc.

---
title: "🎯 Título com emoji opcional"
type: dashboard
status: ativo
created: YYYY-MM-DD
updated: YYYY-MM-DD
author: human:Felipe  # ou "bot:nome" se gerado por agente
tags: [sistema, <categoria>, <subcategoria>]
---

prompt_ia (SKILLs editoriais em 50_🤖_Agentes_e_Prompts/)

---
title: "Skill — <Nome do Agente>"
type: prompt_ia
status: ativo
finalidade: <verbo_no_infinitivo_com_underscore>
modelo_alvo: <claude-haiku-4.5 | claude-sonnet-4.5 | gemini-2.5-flash | etc>
versao: <N>
created: YYYY-MM-DD
updated: YYYY-MM-DD
tags: [prompt, agente/<slug>]
---

roteiro (em 10_🎬_Conteudo/<formato>/<personagem>/)

---
title: "<título curto>"
type: roteiro
formato: <reels | carrossel | post_estatico>
personagem: <jornal | ets | miguel | bene | sem_personagem>
linha_editorial: <deboche | militancia | meme_pop>  # OBRIGATÓRIO (Estrategia_Editorial)
tom_especifico: <serio | meme | afetivo | educativo | escracho>  # ver Tom_de_Voz
plataforma: <instagram | tiktok | ambos>
pauta: "[[<nome-da-pauta>]]"
status: <rascunho | em_revisao | aprovado | em_producao | publicado>
revisao_editorial: <pendente | aprovado>
prompts_visuais_gerados: <true | false>
briefing_designer: "[[<path-briefing>]]"  # quando aplicável
created: YYYY-MM-DDTHH:MM:SS-03:00
updated: YYYY-MM-DDTHH:MM:SS-03:00
author: bot:roteirista  # ou human:Felipe se manual
tags: [roteiro, <personagem>, <pauta-slug>, <linha_editorial>]
fontes:
  - "[[<arquivo-noticia>]]"  # opcional, só rastreio de gancho — NÃO repostar
duracao_estimada: <Xs>  # reels
# OU
quantidade_slides: <N>  # carrossel
---

carrossel (em 10_🎬_Conteudo/Carrosseis/)

---
title: "YYYY-MM-DD — <título>"
type: carrossel
linha_editorial: <deboche | militancia | meme_pop>  # OBRIGATÓRIO
formato: Instagram_Carrossel
aspect_ratio: 4:5  # padrão
plataforma: instagram
quantidade_slides: <N>
status: <rascunho | em_revisao | aprovado | publicado>
imagens_geradas: <true | false>
imagens_path: "80_📤_Outputs/Imagens_Geradas/carrossel_YYYY-MM-DD/"
created: YYYY-MM-DDTHH:MM:SS-03:00
updated: YYYY-MM-DDTHH:MM:SS-03:00
author: bot:carrossel  # ou bot:roteirista pra avulso
tags: [carrossel, <linha_editorial>, <pauta-slug>]
fontes:
  - "[[<noticia>]]"  # se carrossel news, rastreio
data_publicacao_planejada: YYYY-MM-DD
---

Há ainda os schemas de briefing_designer, relatorio, noticia_clipada, pauta, personagem e referencia_visual — todos no mesmo padrão, no arquivo original.

⚠️ NUNCA declarar modelo no frontmatter sem realmente ter usado. Se você é Haiku, declara Haiku. Se é Sonnet, Sonnet. Mentir aqui quebra rastreabilidade de custo + qualidade.

Callouts Obsidian (use em outputs longos)

> [!nota] Contexto
> Texto da nota — informação adicional, link de referência

> [!aviso] Atenção
> Algo que precisa cuidado — ex: "pauta sensível, ler Limites_Editoriais antes"

> [!exemplo] Exemplo
> Demo concreta — ex: hook proposto, frase modelo

> [!sucesso] OK
> Item validado, passou no check

> [!erro] Bloqueio
> Algo que impede continuar — ex: typo de modelo, regra violada

> [!todo] Próximo passo
> Ação acionável — ex: "Felipe, decide entre A e B"

Naming consistente

Datas

  • YYYY-MM-DD sempre (2026-05-11, NÃO 11-05-2026)
  • YYYY-MM-DDTHH:MM:SS±HH:MM ISO 8601 quando timestamp preciso importa
  • Timezone padrão Beneverso: -03:00 (America/Sao_Paulo)

Slugs em filenames

  • kebab-case (bene-pesquisa-senado, NÃO BenePesquisaSenado nem bene_pesquisa_senado)
  • Lowercase ASCII (sem acento, sem ç, sem maiúscula)
  • 2-4 palavras máximo, palavra-chave + contexto curto
  • Filename completo: YYYY-MM-DD_<slug-curto>.md
  • ❌ 2026-05-10_geled_s_dom_stica_gr_vida_agredida_por_ex_patroa_no_ma_diz.md (transliteração quebrada)
  • ✅ 2026-05-10_domestica-gravida-ma.md

Conteúdo do título (campo title:)

  • Pode ter acento, maiúscula, ç, emoji
  • Curto: 5-12 palavras
  • Sempre entre aspas duplas se tiver dois-pontos ou caractere especial

Original completo

Beneverso_Vault/99_⚙️_Sistema/Anexos_Sistema/ — Ecossistema_Agentes.md, Padroes_Frontmatter.md e Infraestrutura_VPS_OpenClaw.md (este último não transcrito; ver a nota no topo). Os schemas de estrutura do vault estão em Schemas e vocabulários, e o detalhe de cada agente em Os agentes do vault.

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