Comentar sobre este guia

Criar Template de Comunicado

Objetivo

Padronizar a criação de templates de comunicado (hoje majoritariamente email, mas a skill é agnóstica de canal). Antes desta skill, o padrão existia só replicado manualmente em quatro arquivos que convergiram pro mesmo formato sem nenhuma skill impondo a estrutura:

Nenhum dos quatro segue as 9 seções abaixo à risca (Audiência só aparece em dois; a ordem varia; o mais recente saiu com numeração duplicada). Essa skill existe pra que o próximo template nasça certo, e pra eventualmente rodar sobre os quatro acima e alinhar todos ao mesmo formato — ver "Pendências" no fim.

Base genérica de "como virar processo" (tarefa vs. procedimento vs. princípio, regra de menos verbo) já existe em protocolar-skill — esta skill não reinventa aquilo, só especializa o formato de template de comunicado dentro dele.

Pergunta 1 — campanha ou produto/evento recorrente?

Antes de escrever qualquer coisa, classificar:

Se não estiver óbvio, perguntar a Hugo — não assumir.

Pergunta 2 — template ou pontual?

Hugo confirmou (2026-09-22) que ~90% das mensagens deste repo nascem como template reutilizável, não como peça de uso único. Assumir template por padrão. Só tratar como pontual (escrever direto no lugar de uso, sem passar pelo esqueleto de 9 seções) se Hugo confirmar explicitamente que é peça de uso único.

Esqueleto — 9 seções obrigatórias

Todo template novo (independente do canal) segue esta sequência, sem pular número e sem duplicar:

  1. Frontmatter — area, tipo: procedimento, tags, produtos, status, updated_at (ver seção "Frontmatter" abaixo).
  2. ## Objetivo — o que o comunicado faz, pra quem, e link pro precedente que inspirou tom/estrutura quando existir (ex.: o comunicado de convite vitalícia linka o de info presencial pra explicar a diferença de tom — ver linha 17-21 do arquivo de vitalícias).
  3. ## Quando enviar — gatilho/momento do envio.
  4. ## Audiência (quando não for óbvio por produto) — product_slug(s) exatos confirmados contra o sistema real (nunca inventados), ou lógica de DDD/person+lead, com o que fica explicitamente fora e por quê. Ver o exemplo de exclusão explícita na seção Audiência do comunicado de vitalícias (mrz3-presencial, mrz3-gold etc. fora por nome parecido mas produto diferente).
  5. ## Assunto (parametrizado) — bloco fixo ou com {variável}.
  6. ## Template — corpo (evergreen, parametrizado) — a copy REAL, completa, dentro de um bloco ```text , com {variáveis} no meio do texto corrido. Nunca uma descrição genérica de estrutura em bullets. (Esse foi um erro cometido numa versão anterior desta mesma sessão, corrigido por Hugo — a skill existe também pra não repetir isso.)
  7. ## Variáveis por edição — tabela com pelo menos 1-2 exemplos reais de edições diferentes (não inventados), mais observações sobre variáveis sensíveis: o que vem de API/planilha ao vivo (preço, data, link) vs. o que é constante e pode ser copiado (ver os dois exemplos lado a lado no comunicado de abertura de matrícula — Porto Alegre e Belo Horizonte).
  8. ## Comando padrão para disparar — briefing mínimo em texto livre que Hugo usa pra pedir o envio, mais o comando real (CLI do canal aplicável, ver seção "Canal de envio" abaixo).
  9. ## Canal de envio — email/WhatsApp/etc., qual script real, e qualquer regra de audiência que não pode ser esquecida (ex.: nunca usar produto genérico, sempre ler campo X ao vivo da API em vez de copiar da tabela).

Não pular número, não repetir número. Se uma seção não se aplica (ex.: Audiência óbvia por produto único), pode ser omitida, mas a numeração segue sem buraco — não criar um "5 bis".

Frontmatter

---
area: produtos            # ou "eventos", conforme kb/products/ vs kb/events/{produto}/
tipo: procedimento
tags: [produto, canal, palavra-chave-do-gatilho]
produtos: [mrz, mrzpr]     # slugs de produto/projeto envolvidos
status: mvp                # mvp | validado | descontinuado
updated_at: YYYY-MM-DD
---

Coleta mínima antes de escrever

Perguntar (ou confirmar o que já está claro na conversa) antes de gerar o arquivo:

Regra do corpo — copy real, nunca bullets

A seção 6 (Template — corpo) é a peça mais fácil de fazer errado. Ela precisa ser o texto que a pessoa de verdade vai receber, com quebras de linha, emoji, assinatura — dentro de um bloco de código, {variáveis} inline. Uma lista tipo "saudação → contexto → CTA → assinatura" não é template, é resumo de estrutura, e não serve pra ninguém copiar e disparar.

Quando for campanha

Além do template evergreen no KB, garantir/atualizar:

Canal de envio — onde ficam os scripts reais

Fonte canônica desta skill

Este arquivo é a fonte canônica (kb/operations/criar-template-comunicado-skill/SKILL.md), conforme a regra do AGENTS.md. Instalação de execução espelhada em .claude/skills/criar-template-comunicado/SKILL.md — ao editar, atualizar os dois juntos (ver drift real já existente entre kb/operations/protocolar-skill/SKILL.md e .claude/skills/protocolar/SKILL.md como exemplo do que não fazer).

Relação com outras skills

Status / pendências

Criada em 2026-09-22. Ainda não rodada retroativamente sobre os quatro precedentes. Pendências conhecidas, para uma próxima sessão: