.agent/global/skills/reels/SKILL.md
2026-09-28 22:18:39 -03:00

7.8 KiB
Raw Blame History

type name description scope updatedAt
workflow reels Criar cadeia de roteiros de Reels para divulgação de funcionalidades e módulos local 2026-06-01

Workflow: Criar Roteiros de Reels

Este workflow gera cadeias de roteiros de Reels (vídeos curtos de 30 a 60 segundos) organizados por tema. Os roteiros são escritos em tom provocativo, informal e direto — prontos para gravar falando para a câmera ou com narração em off. O resultado é salvo em ./COMERCIAL/<nome-do-modulo>-reels.md.

É OBRIGATÓRIO seguir a regra global de Escrita Natural (escrita-natural) em toda produção textual deste workflow.


Público-Alvo dos Reels

Os vídeos serão assistidos pelo público-alvo do produto. O agente deve identificar quem são os usuários e decisores com base no contexto do projeto.

Regra geral: a linguagem deve ser coloquial, direta e sem jargões de TI. Siglas devem vir acompanhadas do nome por extenso quando citadas pela primeira vez.


Pré-requisitos

Antes de gerar roteiros, o agente deve entender as funcionalidades reais do módulo. Se já existir o arquivo comercial (./COMERCIAL/<nome-do-modulo>.md), usá-lo como base. Caso contrário, ler o código-fonte para mapear o que o módulo entrega de fato.


Passos

1. Identificar o tema

  1. Consultar <base_projeto>/memorias-ia/modulo.yml para obter modulo-descricao, modulo-tipo e modulo-id.
  2. Perguntar ao usuário:
  • Qual módulo ou funcionalidade será o tema dos reels?
  • Quantos roteiros deseja na cadeia? (padrão: 6)
  • Algum tom específico? (provocativo, educativo, humorístico)

2. Levantar contexto

Mapear:

  • Quais funcionalidades do módulo geram mais impacto visual e prático?
  • Quais dores reais o público-alvo enfrenta sem a solução?
  • Existe legislação ou norma que possa ser usada como argumento de urgência?
  • Quais comparações do dia a dia fazem sentido para o público?

3. Redigir a cadeia de roteiros

Cada cadeia deve conter 4 a 8 roteiros, todos conectados pelo mesmo tema mas com abordagens diferentes. Cada roteiro segue a estrutura abaixo.


Estrutura de um Roteiro

Cada roteiro deve ter entre 6 e 12 frases curtas, organizadas em 4 blocos:

Bloco 1 — Abertura (1-2 frases)

A primeira frase é a mais importante. Ela decide se o espectador para ou rola.

Técnicas obrigatórias (usar pelo menos uma por roteiro):

Técnica Exemplo
Provocação direta "Se você ainda faz isso manual… tá perdendo dinheiro."
Referência pop "Tá mais perdido que timeline de fofoca da Virgínia?"
Formato "Plot twist" "Plot twist: você perde cliente não é pelo preço…"
Convocação "Se sua proposta fosse convocada hoje… ela jogaria?"
Contraste chocante "Expectativa: vou organizar meus processos. Realidade: caos."
Pergunta retórica "Quantas horas você perdeu esse mês montando relatório?"
Afirmação polêmica "A maioria dos consultores está jogando dinheiro fora."

Bloco 2 — Dor / Cenário ruim (2-3 frases)

Descrever o cenário do público-alvo SEM a solução. Usar linguagem do dia a dia — como se estivesse conversando com um colega.

Regras:

  • Frases curtas e ritmadas (máximo 12 palavras por frase)
  • Usar repetição para ritmo ("proposta pra um lado, orçamento pra outro…")
  • Descrever ações reais, não conceitos ("anota no papel, perde foto, esquece detalhe")
  • Pode usar humor leve e ironia

Bloco 3 — Virada / Solução (2-3 frases)

Apresentar o produto como a virada. O nome do produto aparece aqui — naturalmente, sem parecer propaganda.

Regras:

  • O produto é mencionado uma única vez, pelo nome
  • Descrever o que o produto faz em ações concretas, não em conceitos
  • Usar verbos de ação: "monta", "registra", "envia", "centraliza"
  • Mostrar resultado imediato: "menos retrabalho", "mais fechamento"

Bloco 4 — Fechamento / Desafio (1-2 frases)

Fechar com uma pergunta ou desafio que provoque o espectador a agir.

Técnicas:

  • Desafio direto: "Quer ser titular ou continuar no banco?"
  • Escolha binária: "Você decide em qual nível quer jogar."
  • Pergunta provocativa: "Você tá otimizando ou só se ocupando?"
  • Chamada para ação suave: "Começa a jogar no nível profissional."

Estilos de Roteiro

Cada cadeia deve variar os estilos para manter o conteúdo diverso. O agente deve usar pelo menos 4 estilos diferentes numa cadeia de 6 roteiros.

Estilo Descrição Ritmo
Plot twist Começa com uma crença comum e inverte Surpreendente
Mais perdido que... Analogia cômica + caos do dia a dia Humorístico
Convocação Metáfora de seleção/time/jogo Competitivo
Raiz vs Smart Dois perfis contrastados Comparativo
Tempo é dinheiro Foco em produtividade e custo de oportunidade Urgência
Expectativa vs Realidade Contraste entre o plano e o caos Identificação
Se eu te contasse Narrativa de revelação progressiva Curiosidade
Checklist do fracasso Lista irônica do que NÃO fazer Irônico

Regras de Entonação

O roteiro deve indicar como falar cada trecho. Usar marcações simples:

Marcação Significado
Texto normal Tom de conversa, olhando pra câmera
Texto em itálico Tom irônico ou de provocação
Texto em negrito Ênfase, falar mais forte
[pausa] Pausa dramática de 1-2 segundos
[rápido] Falar em ritmo acelerado
[sussurrando] Tom baixo, como se contasse um segredo

Regras de Redação

  • Frases curtas: máximo 15 palavras por frase. Idealmente 8-12
  • Sem jargões de TI: trocar termos técnicos por equivalentes do dia a dia
  • Tom coloquial: "tá", "pra", "gente", "bobo" são permitidos e desejáveis
  • Referências culturais: usar quando fizerem sentido para o público (futebol, reality, memes do momento). Marcar como [ref: atualizar] se a referência puder ficar datada
  • Uma ideia por frase: cada frase deve ser compreensível isoladamente
  • Sem "Olá pessoal": nunca abrir com saudação genérica
  • Produto natural: o nome do produto aparece no máximo 1 vez por roteiro, no bloco de solução
  • Siglas: toda sigla usada pela primeira vez deve vir acompanhada do nome por extenso

Checklist de Qualidade

Antes de entregar, validar cada roteiro:

  • A primeira frase para o scroll? (provocação, surpresa ou identificação)
  • O cenário da dor é real e reconhecível pelo público-alvo?
  • O produto aparece naturalmente, sem parecer propaganda forçada?
  • O fechamento provoca ação (pergunta, desafio ou escolha)?
  • O roteiro tem entre 6 e 12 frases?
  • Cada frase tem no máximo 15 palavras?
  • O tom é coloquial e direto (não institucional)?
  • A cadeia usa pelo menos 4 estilos diferentes?
  • Está LIVRE de jargões de TI?
  • O roteiro funciona sendo falado em voz alta? (ler em voz alta para validar)

Formato de Saída

O arquivo ./COMERCIAL/<nome-do-modulo>-reels.md deve seguir esta estrutura:

# Reels — [Nome do Módulo]

> Cadeia de [N] roteiros sobre [tema]
> Tom: [provocativo / educativo / humorístico]
> Duração média: 30-60 segundos por reel

---

## 🎥 Roteiro 1 – "[Título criativo]"

"[Primeira frase — abertura impactante]

[Bloco de dor — 2-3 frases curtas]

[Bloco de solução — 2-3 frases com o produto]

[Fechamento — pergunta ou desafio]"

---

## 🎥 Roteiro 2 – "[Título criativo]"

...

Referências

  • Workflow: agents/comercial/workflows/comercial (descrição comercial detalhada — base de contexto)
  • Workflow: agents/comercial/workflows/marketing (peças de marketing por canal)
  • Rule: global/rules/escrita-natural (padrão obrigatório de redação)