versão 1

2026-06-18 11:59:57 -03:00 · 2026-06-18 11:59:57 -03:00 · 1cb4c14d33
commit 1cb4c14d33
85 changed files with 11836 additions and 0 deletions
--- a/agents/ag-comercial/workflows/comercial.md
+++ b/agents/ag-comercial/workflows/comercial.md
@ -0,0 +1,144 @@
+---
+type: workflow
+name: comercial
+description: Criar uma descrição comercial das funcionalidades e do sistema
+scope: global
+updatedAt: "2026-06-01"
+---
+
+# Workflow: Criar Descrição Comercial
+
+Este workflow gera uma descrição comercial de funcionalidades ou do sistema completo, escrita na pasta `./COMERCIAL/`. Cada módulo ou funcionalidade gera um arquivo separado com o padrão `./COMERCIAL/<nome-do-modulo>.md`.
+
+É **OBRIGATÓRIO** seguir a regra global de Escrita Natural (`escrita-natural.global.md`) em toda produção textual deste workflow.
+
+---
+
+## Passos
+
+### 1. Identificar as funcionalidades solicitadas
+
+Perguntar ao usuário quais módulos ou funcionalidades devem ser descritos. Se o pedido for genérico ("descreva o sistema"), listar os módulos principais do projeto e confirmar o escopo antes de redigir.
+
+### 2. Levantar contexto real de cada funcionalidade
+
+Antes de escrever, ler o código-fonte e os componentes relacionados para entender:
+
+- Qual **problema real** a funcionalidade resolve?
+- Quem são os **usuários diretos**? (consultor ambiental, gestor ambiental, gestor público, técnico de campo)
+- Qual é o **fluxo de uso** no dia a dia?
+- Quais **dificuldades operacionais** existiam antes da solução?
+
+### 3. Redigir a descrição comercial
+
+Para cada funcionalidade, produzir **dois blocos de texto** no arquivo `./COMERCIAL/<nome-do-modulo>.md`:
+
+#### Bloco A — Descrição Resumida (2 a 4 linhas)
+
+Texto curto que pode ser usado em páginas de divulgação, apresentações rápidas ou materiais institucionais.
+
+Estrutura obrigatória:
+- **Linha 1**: o problema/dificuldade que existe sem a solução
+- **Linha 2-3**: como funciona na prática (ação do usuário, sem termos técnicos de TI)
+- **Linha 4**: o impacto concreto (ganho mensurável)
+
+*Exemplo:*
+> Sem controle digital, registros de campo ficam em cadernos e planilhas isoladas — sujeitos a perda e erro de transcrição.
+> Com a solução, o técnico registra os dados direto no celular, mesmo sem internet, com validação automática.
+> Isso elimina falhas de preenchimento e garante rastreabilidade completa para auditorias.
+
+#### Bloco B — Descrição Detalhada
+
+Texto mais completo (5 a 15 linhas) que aprofunda o funcionamento e os diferenciais. Deve incluir:
+
+- Cenário de uso realista (quem faz o quê, quando e onde)
+- Recursos técnicos relevantes explicados de forma acessível (offline, sincronização, alertas automáticos)
+- Benefícios encadeados (causa → efeito)
+- **Implicações legais ou normativas** (quando aplicável): se a funcionalidade tem relação com legislação, normas regulatórias ou resoluções de órgãos competentes, **citar expressamente** a norma ou obrigação legal. Isso fortalece o argumento comercial e demonstra que a solução atende requisitos reais de conformidade.
+
+> **Regra de siglas**: toda sigla usada pela primeira vez no texto deve vir acompanhada do nome por extenso. Exemplo: "ANA (Agência Nacional de Águas e Saneamento Básico)". Nas ocorrências seguintes, pode-se usar apenas a sigla.
+
+### 4. Revisar contra o checklist de qualidade
+
+Antes de entregar, validar **cada bloco** contra as restrições abaixo:
+
+- [ ] O texto do Resumo começa pelo problema, não pela funcionalidade?
+- [ ] Há pelo menos um cenário de uso prático (quem, onde, como)?
+- [ ] Os parágrafos são curtos (2 a 4 linhas) com uma ideia principal cada?
+- [ ] A linguagem soa como alguém que vive o problema, não como manual de software?
+- [ ] Está **LIVRE** de jargões de TI e termos em inglês sem tradução?
+- [ ] Toda **sigla** está acompanhada do nome por extenso na primeira ocorrência?
+- [ ] Está **LIVRE** de termos vazios ("Inovador", "Eficiente", "Solução completa", "O presente projeto")?
+- [ ] Está **LIVRE** do padrão repetitivo "O sistema permite / A funcionalidade permite / A ferramenta permite"?
+- [ ] As frases variam de estrutura? (alternando "Na prática...", "Com isso...", "Isso reduz...", "Como resultado...")
+- [ ] Quando há implicação legal ou normativa, a norma/lei/resolução está **citada e destacada** no texto?
+- [ ] O texto é compreensível pelo **público-alvo do produto** sem conhecimento de TI?
+
+---
+
+## Público-Alvo
+
+Todo texto produzido por este workflow deve ser compreensível 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: nenhum dos perfis-alvo tem obrigação de conhecer termos de tecnologia. A linguagem deve ser **acessível, direta e sem jargões de TI**.
+
+---
+
+## Regras de Tom e Vocabulário
+
+| ✅ Usar | ❌ Evitar |
+|---|---|
+| "Na prática, o técnico..." | "O sistema permite..." |
+| "Com isso, a equipe..." | "A solução inovadora..." |
+| "Isso elimina..." | "O presente projeto visa..." |
+| "Como resultado..." | "Dessa forma..." |
+| "Sem a solução, o gestor precisa..." | "A ferramenta oferece..." |
+| "Entregamos controle sobre..." | "Nossa solução oferece..." |
+| "O gestor ganha visibilidade de..." | "A plataforma disponibiliza..." |
+| "página de divulgação" | "landing page" |
+| "frase de abertura" | "hook" |
+| "chamada para ação" | "CTA" (isolado, sem explicação) |
+| "texto persuasivo" | "copywriting" |
+| "linha do tempo, publicações" | "feed" |
+
+**Tom geral**: profissional, direto, sem burocracia institucional. O texto deve parecer escrito por quem constrói a solução e entende a operação do dia a dia do cliente.
+
+---
+
+## Formato de Saída
+
+Cada módulo ou funcionalidade deve gerar **um arquivo próprio** dentro da pasta `./COMERCIAL/`.
+
+**Regra de nomeação do arquivo:**
+- Usar o nome do módulo em **kebab-case** (minúsculo, separado por hifens)
+
+O arquivo `./COMERCIAL/<nome-do-modulo>.md` deve seguir esta estrutura:
+
+```markdown
+# [Nome do Módulo]
+
+## [Nome da Sub-funcionalidade]
+
+### Resumo
+
+[Bloco A — 2 a 4 linhas: problema → solução → impacto]
+
+### Detalhamento
+
+[Bloco B — 5 a 15 linhas: cenário real + técnico acessível + legal]
+
+---
+
+## [Próxima Sub-funcionalidade]
+
+...
+```
+
+---
+
+## Referências
+
+- Regra global: `.agent/rules/escrita-natural.global.md` (padrão obrigatório de redação)
+- Workflow: `.agent/workflows/orcamento.global.md` (texto para documentos de orçamento e proposta — apresentação + lista de funcionalidades)
+- Workflow: `.agent/workflows/marketing.global.md` (peças de marketing digital — LinkedIn, Instagram, WhatsApp, E-mail)
+- Workflow: `.agent/workflows/otimizar-codigos.global.md` (para documentação técnica, não comercial)
--- a/agents/ag-comercial/workflows/marketing.md
+++ b/agents/ag-comercial/workflows/marketing.md
@ -0,0 +1,209 @@
+---
+type: workflow
+name: marketing
+description: Criar peças de marketing digital para funcionalidades e módulos do sistema
+scope: global
+updatedAt: "2026-06-01"
+---
+
+# Workflow: Criar Peças de Marketing
+
+Este workflow gera peças de marketing digital prontas para uso em canais como LinkedIn, Instagram, WhatsApp e E-mail. O resultado é salvo na pasta `./COMERCIAL/` junto ao arquivo comercial do módulo correspondente, ou em arquivo separado `./COMERCIAL/<nome-do-modulo>-marketing.md`.
+
+É **OBRIGATÓRIO** seguir a regra global de Escrita Natural (`escrita-natural.global.md`) em toda produção textual deste workflow.
+
+O agente deve atuar como **especialista em marketing digital voltado para o setor do produto (venda entre empresas)**, aplicando técnicas comprovadas de texto persuasivo e engajamento.
+
+## Público-Alvo das Peças
+
+As peças serão lidas 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: nenhum dos perfis-alvo tem obrigação de conhecer termos de tecnologia. A linguagem deve ser **acessível, direta e sem jargões de TI**. Siglas devem vir acompanhadas do nome por extenso na primeira ocorrência.
+
+---
+
+## Pré-requisitos
+
+Antes de gerar peças de marketing, o arquivo comercial do módulo (`./COMERCIAL/<nome-do-modulo>.md`) já deve existir com os blocos A (Resumo) e B (Detalhamento). Se não existir, aplicar primeiro o workflow `/comercial.global`.
+
+---
+
+## Passos
+
+### 1. Identificar o módulo e o canal
+
+Perguntar ao usuário:
+- Qual módulo ou funcionalidade será divulgado?
+- Quais canais deseja? (LinkedIn, Instagram, WhatsApp, E-mail, ou todos)
+
+### 2. Ler o contexto comercial
+
+Ler o arquivo `./COMERCIAL/<nome-do-modulo>.md` para extrair:
+- O problema e impacto (Bloco A)
+- Os cenários de uso e referências legais (Bloco B)
+
+### 3. Redigir as peças de marketing
+
+---
+
+## Princípios de Engajamento
+
+1. **Abrir com uma provocação ou dado concreto** — nunca com o nome do produto. A primeira frase deve fazer o leitor parar de rolar as publicações.
+2. **Falar a língua do decisor** — usar o vocabulário do público-alvo do produto, não termos de tecnologia.
+3. **Criar urgência sem desespero** — mostrar o custo da inação (multa, retrabalho, perda de prazo) sem tom alarmista.
+4. **Fechar com uma chamada para ação clara** — sempre direcionar para o próximo passo: demonstração, contato, link ou agendamento.
+5. **Adaptar ao canal** — o mesmo conteúdo não funciona igual no LinkedIn, Instagram, WhatsApp e e-mail. Cada peça deve respeitar o formato e tom do canal.
+
+---
+
+## Técnicas Obrigatórias
+
+| Técnica | Como aplicar |
+|---|---|
+| **Frase de abertura impactante** | Pergunta retórica, dado alarmante ou afirmação provocativa nas primeiras 10 palavras |
+| **Prova social** | Mencionar o tipo de cliente que já usa (prefeituras, indústrias, consultorias), sem inventar números |
+| **Contraste antes/depois** | Mostrar o cenário ruim (planilha, papel, multa) ao lado do cenário com a solução |
+| **Especificidade** | Trocar "economiza tempo" por "reduz 4 horas semanais de consolidação manual" |
+| **Chamada para ação conectada ao problema** | A frase final deve se conectar ao problema apresentado, não ser genérica |
+
+---
+
+## Formatos por Canal
+
+### LinkedIn (Carrossel ou Post)
+
+- 3 a 5 parágrafos curtos (1-2 linhas cada)
+- Abrir com frase de abertura forte na primeira linha (antes do "ver mais")
+- Usar quebras de linha para facilitar a leitura
+- Emojis como marcadores (⚠️, ✅, 📊), no máximo 1 por parágrafo
+- Fechar com chamada para ação + hashtags relevantes (no máximo 5)
+
+*Exemplo de LinkedIn:*
+
+```
+⚠️ Sua equipe ainda controla [processo crítico] em planilha?
+
+A maioria das operações só descobre o problema 
+quando o órgão regulador notifica.
+Nessa hora, a multa já está lavrada.
+
+Com [nome do produto], cada registro é feito digitalmente 
+com cálculo automático. Se o valor ultrapassar 
+o limite autorizado, um alerta dispara na hora.
+
+✅ Controle em tempo real
+✅ Alertas automáticos de limite
+✅ Relatórios prontos para auditoria
+
+Quer ver funcionando? Fale com a gente.
+
+#Hashtag1 #Hashtag2 #Hashtag3
+```
+
+### Instagram (Stories / Reels / Carrossel)
+
+- Frases de impacto (no máximo 15 palavras por slide)
+- Visual > texto — cada slide deve ter uma ideia única
+- Usar contrastes visuais (❌ antes / ✅ depois)
+- Chamada para ação no último slide: "Link na bio" ou "Fale com nosso time"
+
+*Exemplo de Instagram:*
+
+```
+Slide 1: "Sua operação está em conformidade?"
+Slide 2: ❌ "Planilhas manuais. Registros esquecidos. Consolidação no fim do mês."
+Slide 3: ⚠️ "[Citação legal relevante]"
+Slide 4: ✅ "Registro digital com cálculo automático."
+Slide 5: ✅ "Alerta em tempo real quando o limite é atingido."
+Slide 6: "Conheça [nome do produto]. Link na bio."
+```
+
+### WhatsApp (Mensagem de prospecção)
+
+- No máximo 4 linhas + 1 chamada para ação
+- Tom pessoal, sem parecer mensagem em massa
+- Mencionar o contexto do destinatário (setor, dificuldade conhecida)
+
+*Exemplo de WhatsApp:*
+
+```
+Oi [Nome], tudo bem?
+
+Vi que vocês trabalham com [contexto do destinatário]. 
+Queria mostrar como estamos ajudando operações como a de vocês 
+a [benefício principal da solução].
+
+Posso te mandar um vídeo rápido de 2 min mostrando como funciona?
+```
+
+### E-mail (Prospecção ou Nutrição)
+
+- Assunto: direto, com gancho de dificuldade real (no máximo 60 caracteres)
+- Corpo: 3 parágrafos curtos — problema → solução → chamada para ação
+- Evitar formatação visual pesada — preferir texto limpo e direto
+
+*Exemplo de E-mail:*
+
+```
+Assunto: [Pergunta sobre dificuldade real do destinatário]
+
+Olá [Nome],
+
+[Parágrafo 1: descrever a dificuldade que o destinatário provavelmente enfrenta]
+
+[Parágrafo 2: como a solução resolve, com dados concretos]
+
+Se fizer sentido, posso agendar 15 minutos para mostrar como funciona 
+na prática. Qual o melhor horário para você?
+
+[Assinatura]
+```
+
+---
+
+## Checklist de Qualidade
+
+Antes de finalizar qualquer peça, validar:
+
+- [ ] A primeira frase **provoca, questiona ou surpreende**?
+- [ ] O texto fala a **língua do decisor** (público-alvo do produto), não de desenvolvedor?
+- [ ] Existe **contraste claro** entre o cenário sem e com a solução?
+- [ ] Os benefícios são **específicos** (números, tempo, ações concretas)?
+- [ ] Tem **chamada para ação clara** e conectada ao problema apresentado?
+- [ ] O tom está **adaptado ao canal** (LinkedIn ≠ WhatsApp ≠ E-mail)?
+- [ ] Está **LIVRE** de jargões de TI e termos em inglês sem tradução?
+- [ ] Toda **sigla** está acompanhada do nome por extenso na primeira ocorrência?
+- [ ] Menções legais são usadas como **argumento de urgência**, não como decoração?
+
+---
+
+## Formato de Saída
+
+O resultado deve ser salvo em `./COMERCIAL/<nome-do-modulo>-marketing.md` ou adicionado ao final do arquivo comercial existente, conforme preferência do usuário.
+
+```markdown
+# Marketing — [Nome do Módulo]
+
+## LinkedIn
+
+[Post pronto para publicação]
+
+## Instagram
+
+[Roteiro de slides para carrossel ou legenda para post]
+
+## WhatsApp
+
+[Mensagem de prospecção]
+
+## E-mail
+
+[Template de prospecção ou nutrição]
+```
+
+---
+
+## Referências
+
+- Workflow: `.agent/workflows/comercial.global.md` (gera os blocos A e B que alimentam o marketing)
+- Regra global: `.agent/rules/escrita-natural.global.md` (padrão obrigatório de redação)
--- a/agents/ag-comercial/workflows/orcamento.md
+++ b/agents/ag-comercial/workflows/orcamento.md
@ -0,0 +1,134 @@
+---
+type: workflow
+name: orcamento
+description: Criar texto de orçamento pronto para copiar e colar em peças de orçamento/proposta
+scope: global
+updatedAt: "2026-06-01"
+---
+
+# Workflow: Criar Texto de Orçamento
+
+Este workflow gera textos prontos para **copiar e colar dentro de documentos de orçamento e propostas comerciais**. O resultado é salvo na pasta `./COMERCIAL/` com o sufixo `-orcamento` (ex: `./COMERCIAL/<nome-do-modulo>-orcamento.md`).
+
+É **OBRIGATÓRIO** seguir a regra global de Escrita Natural (`escrita-natural.global.md`) em toda produção textual deste workflow.
+
+---
+
+## Público-Alvo
+
+O documento de orçamento será lido pelo **público-alvo do produto**. O agente deve identificar quem são os usuários e decisores com base no contexto do projeto.
+
+A linguagem deve ser **acessível, direta e sem jargões de TI**. Siglas devem vir acompanhadas do nome por extenso na primeira ocorrência.
+
+---
+
+## Pré-requisitos
+
+Antes de gerar o texto de orçamento, o agente deve ler o código-fonte do módulo para entender quais funcionalidades existem de fato. Se já existir o arquivo comercial (`./COMERCIAL/<nome-do-modulo>.md`), usá-lo como base para extrair contexto.
+
+---
+
+## Passos
+
+### 1. Identificar o módulo
+
+Perguntar ao usuário qual módulo ou funcionalidade será orçado.
+
+### 2. Levantar contexto
+
+Ler o código-fonte e os componentes relacionados para mapear:
+- Quais **funcionalidades** o módulo oferece de fato?
+- Existe **legislação ou norma** relevante que o módulo atende?
+- Quem são os **usuários diretos**? (consultor, gestor, técnico de campo)
+
+### 3. Redigir o texto de orçamento
+
+O texto deve ser **autocontido** — pronto para colar diretamente dentro de um documento de orçamento sem necessidade de edição. Estrutura obrigatória:
+
+#### Apresentação do Módulo (2 a 4 linhas)
+
+Texto que descreve o módulo de forma direta, mostrando **o que ele faz** e **qual problema resolve**. Se houver legislação ou norma relevante, **citar aqui** para demonstrar conformidade regulatória e fortalecer o argumento.
+
+Regras:
+- Começar pelo que o módulo entrega, não pelo problema
+- Se houver lei/norma relevante, citar com nome por extenso e artigo
+- Tom confiante e profissional — adequado para documento formal
+- Não usar termos de tecnologia
+
+#### Lista de Funcionalidades
+
+Após a apresentação, listar as funcionalidades do módulo em formato de **itens curtos** (1 a 2 linhas cada). Cada item deve:
+
+- Descrever **o que a funcionalidade faz na prática** (ação concreta, não conceito abstrato)
+- Ser compreensível por alguém que **nunca viu o sistema**
+- Ser suficientemente específico para justificar o valor cobrado
+
+Regras para cada item:
+- Começar com o **nome da funcionalidade** em negrito
+- Seguir com uma descrição curta do que ela faz
+- Opcionalmente, incluir o benefício direto entre parênteses ou traço
+
+### 4. Revisar contra o checklist de qualidade
+
+Antes de entregar, validar:
+
+- [ ] A apresentação do módulo é autocontida e compreensível isoladamente?
+- [ ] Cada funcionalidade está descrita de forma concreta (o que faz, não o que é)?
+- [ ] O texto está **pronto para copiar e colar** sem edição?
+- [ ] Está **LIVRE** de jargões de TI e termos em inglês sem tradução?
+- [ ] Toda **sigla** está acompanhada do nome por extenso na primeira ocorrência?
+- [ ] Legislação/norma relevante está **citada na apresentação** com nome por extenso?
+- [ ] O tom é profissional e adequado para um documento formal de orçamento?
+- [ ] É compreensível pelo **público-alvo do produto** sem conhecimento de TI?
+
+---
+
+## Regras de Redação
+
+- **Sem jargões de TI**: trocar termos técnicos por equivalentes acessíveis (ex: "painel" em vez de "dashboard", "código QR" em vez de "QR Code")
+- **Siglas por extenso**: toda sigla deve vir acompanhada do nome por extenso na primeira ocorrência
+- **Tom formal mas acessível**: adequado para um documento de orçamento/proposta enviado a um diretor ou secretário
+- **Funcionalidades concretas**: "Registro de leituras com cálculo automático de volume", não "Módulo de coleta de dados parametrizável"
+
+---
+
+## Formato de Saída
+
+O arquivo `./COMERCIAL/<nome-do-modulo>-orcamento.md` deve seguir esta estrutura:
+
+```markdown
+# [Nome do Módulo]
+
+[Apresentação do módulo — 2 a 4 linhas com legislação relevante, se aplicável]
+
+## Funcionalidades incluídas
+
+- **[Nome da funcionalidade 1]**: [descrição curta do que faz na prática]
+- **[Nome da funcionalidade 2]**: [descrição curta do que faz na prática]
+- **[Nome da funcionalidade 3]**: [descrição curta do que faz na prática]
+- ...
+```
+
+*Exemplo:*
+
+```markdown
+# [Nome do Módulo]
+
+[Apresentação do módulo com descrição direta do que faz, qual problema resolve e,
+se aplicável, legislação ou norma relevante citada por extenso.]
+
+## Funcionalidades incluídas
+
+- **[Funcionalidade 1]**: [descrição curta do que faz]
+- **[Funcionalidade 2]**: [descrição curta do que faz]
+- **[Funcionalidade 3]**: [descrição curta do que faz]
+- ...
+```
+
+---
+
+## Referências
+
+- Workflow: `.agent/workflows/comercial.global.md` (descrição comercial detalhada — Resumo e Detalhamento)
+- Workflow: `.agent/workflows/marketing.global.md` (peças de marketing digital)
+- Regra global: `.agent/rules/escrita-natural.global.md` (padrão obrigatório de redação)
--- a/agents/ag-comercial/workflows/reels.md
+++ b/agents/ag-comercial/workflows/reels.md
@ -0,0 +1,204 @@
+---
+type: workflow
+name: reels
+description: Criar cadeia de roteiros de Reels para divulgação de funcionalidades e módulos
+scope: global
+updatedAt: "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.global.md`) 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
+
+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:
+
+```markdown
+# 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: `.agent/workflows/comercial.global.md` (descrição comercial detalhada — base de contexto)
+- Workflow: `.agent/workflows/marketing.global.md` (peças de marketing por canal)
+- Regra global: `.agent/rules/escrita-natural.global.md` (padrão obrigatório de redação)