wizz-method 1.2.2 → 1.3.1

package/src/modules/wizz/agents/wizz-social/knowledge/blueprint-roteiro-viral.md

@@ -0,0 +1,341 @@
+# Blueprint de Roteiro Viral · v2.0
+
+> Estúdio SOW · Análise de 17 Reels virais + expansão estratégica
+> Nicho: IA aplicada a negócios · Público: empreendedores e profissionais de marketing
+> Objetivo: criar roteiros dinâmicos, virais e que convertem em seguidores, DMs e vendas
+
+Este é o conhecimento base do agente **wizz-social** (persona Rafa). Ele NUNCA aplica como template engessado. Adapta a cada roteiro.
+
+---
+
+## 1. Anatomia do Hook
+
+Em 100% dos Reels analisados, o hook está na primeira frase, sem exceção. Sem introdução, sem "oi, pessoal". A primeira palavra já é a isca.
+
+Os hooks se organizam em **7 tipos**, com 3 dominando a produção.
+
+### Hook Tipo 01 · A Façanha Pessoal (dominante)
+Você anuncia que já fez algo absurdo e inesperado. Verbo no passado + resultado hiperbólico.
+> "Eu acabei de [AÇÃO IMPOSSÍVEL/ABSURDA] e eu vou te ensinar como fazer isso também."
+
+Exige credibilidade prévia. Com conta nova, fortaleça com prova visual imediata na Fase 02.
+
+### Hook Tipo 02 · A Sentença de Morte (dominante)
+Uma ferramenta, profissão ou empresa é declarada morta ou obsoleta. Ativa medo de perder relevância.
+> "[FERRAMENTA] acabou de matar o [CONCORRENTE]. Pode demitir o teu [PROFISSIONAL]."
+
+Alta viralização de alcance, mas satura rápido. Após 3-4 variações seguidas no mesmo nicho, a audiência cria anticorpo. Ver Seção 9.
+
+### Hook Tipo 03 · O Comando Provocador (dominante)
+Ordem direta que soa absurda e provocativa. Cria dissonância imediata.
+> "Pode [AÇÃO RADICAL] porque [NOVA REALIDADE QUE JUSTIFICA]."
+
+### Hook Tipo 04 · A Pergunta de Resultado
+Abre com pergunta que o espectador quer responder. Melhor quando o resultado é específico e desejável.
+> "Como você faz para [RESULTADO ESPECÍFICO E DESEJÁVEL] usando [FERRAMENTA]?"
+
+### Hook Tipo 05 · A Lista Urgente
+Número + "coisas/prompts/segredos" cria expectativa estruturada. O cérebro quer completar a lista.
+> "[NÚMERO] [coisas/prompts/segredos/erros] que você [precisa/tem que] [contexto]."
+
+### Hook Tipo 06 · A Revelação de Erro
+Aponta algo que o espectador faz errado. Gera culpa imediata. Maior identificação pessoal, alta conversão em DM.
+> "Se você tá [AÇÃO COMUM], tu tá [CONSEQUÊNCIA NEGATIVA] sem nem perceber."
+
+### Hook Tipo 07 · O Breaking News
+Trata novidade como manchete de jornal. Ativa FOMO informacional.
+> "[FERRAMENTA/EMPRESA] acabou de [AÇÃO DE IMPACTO]. A partir de hoje, [NOVA REALIDADE]."
+
+Exige velocidade: deve sair no mesmo dia ou em até 24h. Passado o prazo, o FOMO evapora.
+
+**Padrão fundamental:** todo hook existe entre dois polos, **provocação** (você está errado / sua profissão vai acabar) e **promessa** (eu descobri algo que você precisa saber). Os mais fortes ativam os dois ao mesmo tempo.
+
+---
+
+## 2. Estrutura Narrativa
+
+Duas estruturas. A **Tutorial Bombástico** (~75%) e a **Revelação de Sistema** (~25%). Nenhuma frase é desperdiçada.
+
+### Estrutura Dominante · Tutorial Bombástico
+- **[0-3 seg] FASE 01 · A Bomba (Hook):** declaração absurda, pergunta ou sentença de morte. Sem contexto.
+- **[3-8 seg] FASE 02 · A Prova da Promessa (Amplificação):** número específico + especificidade visceral. Não é só o número, é o número com contexto sensorial ou situacional.
+- **[8-45 seg] FASE 03 · O Tutorial Acelerado (Corpo):** passo a passo denso. Verbos de ação em segunda pessoa. Nomeia o botão, campo, URL exatos. Micro-gancho interno no meio. Sem filosofia.
+- **[45-55 seg] FASE 04 · O Resultado Visual (Virada):** "Olha" ou "Esse é o resultado". Prova social da promessa. Variantes: resultado na tela, antes/depois, número de validação.
+- **[55-60 seg] FASE 05 · Fechamento + Sistema de Conversão (CTA Triplo):** isca de comentário + palavra-chave, CTA de seguidor, assinatura verbal. Sempre nessa ordem.
+
+### Estrutura Alternativa · Revelação de Sistema
+Corpo em componentes numerados com papel definido, não em passos. Gera mais compartilhamentos.
+> Mapa: `HOOK_FAÇANHA → COMPONENTE 1 + PAPEL → COMPONENTE 2 + PAPEL → ... → RESULTADO SISTÊMICO → CTA`
+
+Use quando o valor está na arquitetura do sistema, não nos passos. Ideal para audiência avançada.
+
+### Ritmo e Pacing
+Alta densidade de informação, sem respiração filosófica. Sem "então", "portanto", "bom, pessoal". Cada frase é instrução ou prova. O único desacelerar é na apresentação do resultado visual, o único respiro do Reel.
+
+---
+
+## 3. Tensão e Retenção · O Motor Invisível
+
+O algoritmo mede watch-time por quartil (25/50/75/100%). Cada quartil é chance de perder o espectador. Plante um novo motivo para ficar em cada ponto.
+
+### Os 3 Tipos de Loop
+- **Loop de Promessa (macro):** criado no hook, fecha só com a prova visual no final.
+- **Loop de Segredo (interno):** plantado no meio do tutorial para segurar quem está a 50%. "Mas agora vem o pulo do gato que 95% não sabem..."
+- **Loop de Completude (estrutural):** listas criam loop automático. Anunciou "5 prompts", o espectador precisa dos 5.
+
+### Onde Plantar os Loops
+```
+[0-3 seg]   → LOOP MACRO ABERTO (hook cria promessa)
+[8-15 seg]  → MICRO-COMPROMETIMENTO (passo 1 = investimento)
+[25-35 seg] → LOOP INTERNO PLANTADO ("agora vem o pulo do gato")
+[45-50 seg] → LOOP INTERNO FECHADO (resultado parcial)
+[55-60 seg] → LOOP MACRO FECHADO (prova visual) + LOOP DE CTA ABERTO
+```
+
+O CTA cria o último loop: comentar a palavra-chave para "receber o conteúdo completo". O Reel fecha, mas abre um novo loop no DM.
+
+### Micro-Comprometimento como Cola
+Cada passo que o espectador executa mentalmente aumenta o investimento. Verbos na segunda pessoa em sequência rápida:
+> "Você vai entrar → vai clicar → vai copiar → agora cola → pronto."
+
+---
+
+## 4. Gatilhos Emocionais e Psicológicos
+
+| Gatilho | Como usar | Intensidade |
+|---|---|---|
+| Medo de obsolescência | "Pode demitir o teu social media" / "acabou de matar o Canva" | Alta |
+| FOMO informacional | "Isso deveria ser proibido de ensinar" / "cinco prompts secretos" | Alta |
+| Identidade aspiracional | "A partir de agora tu tem um designer trabalhando 24h pra você" | Média-alta |
+| Prova social por número | "130 agentes", "95% das pessoas" | Média-alta |
+| Culpa imediata | "Tu tá queimando os teus tokens sem nem perceber" | Alta |
+| Curiosidade progressiva | "Mas agora vem o pulo do gato" | Média-alta |
+| Pertencimento / tribo | "Comenta 'IA' que eu te mando" / "Tamo junto" | Média |
+| Escassez percebida | "Deveria ser proibido de ensinar" / "prompts secretos" | Média-alta |
+| Alívio imediato | "Em menos de 2 minutos" / "totalmente gratuito" | Média-alta |
+
+### Combinações por Objetivo
+- **Máximo alcance:** Medo de obsolescência + FOMO + Prova por número
+- **Máxima conversão em DM:** Culpa imediata + Alívio imediato + Pertencimento
+- **Autoridade de nicho:** Identidade aspiracional + Prova por número + Curiosidade progressiva
+
+### Os 5 Triggers de Blair Warren (aplicados ao Reel)
+- **Encorajar os sonhos:** mostre a visão do possível antes de explicar o como.
+- **Justificar as falhas:** "Você não sabia porque ninguém ensinou isso direito."
+- **Aliviar os medos:** "Não precisa saber programar. Não precisa de equipe."
+- **Confirmar as suspeitas:** "Você sempre suspeitou que o processo manual era perda de tempo. Era."
+- **Ajudar a atacar inimigos:** "Chega de pagar [R$XXX] por mês pra ferramenta que faz menos que isso."
+
+---
+
+## 5. CTA e Sistema de Conversão
+
+O CTA não é uma frase, é um sistema. Sem o fluxo configurado antes de gravar, o Reel gera engajamento sem gerar negócio.
+
+### As 3 Camadas
+1. **Isca de Palavra-Chave:** comenta uma palavra → recebe conteúdo no DM. "Comenta 'IA' que eu te mando pelo Direct."
+2. **Promessa de Continuidade:** convite a seguir com promessa de mais conteúdo.
+3. **Assinatura Verbal:** "Tamo junto" (pertencimento) + "Let's go" (energia). Identidade sonora de marca.
+
+### Configuração Obrigatória (Manychat)
+```
+1. Trigger: comentário contendo a palavra-chave
+2. Ação: DM automático com o material prometido
+3. Sequência: 2-3 mensagens de follow-up nos próximos 3 dias
+4. Ponto de oferta: follow-up direciona para produto/serviço
+```
+Erros comuns: publicar sem fluxo ativo, palavra-chave genérica ("IA"), fluxo sem follow-up.
+
+### Ordem Correta do CTA Triplo
+```
+1. [ISCA DE DM]    "Comenta [PALAVRA] que eu te mando [O QUÊ] pelo Direct."
+2. [SEGUIDOR]      "E se tu quer mais sobre [TEMA], já me segue aqui."
+3. [ASSINATURA]    "Tamo junto e let's go!"
+```
+Nunca inverta. O DM vem primeiro (maior valor). O seguidor depois. A assinatura sempre fecha.
+
+---
+
+## 6. Padrões de Linguagem e Voz
+
+Vocabulário de alta frequência: "Let's go / Tamo junto" (17/17 Reels, assinatura), "A partir de agora" (marca de transformação), "Pode demitir" (comando provocador), "Eu acabei de" (passado recente), "Totalmente gratuito" (remove barreira), "Olha o resultado" (transição para prova), "Insano / Literalmente" (amplificadores), "Agora vem o segredo / Pulo do gato" (loop interno), "Tu / Teu" (tuteo informal, proximidade).
+
+Tom: informal e autoritativo ao mesmo tempo. Fala como um amigo que sabe mais, não um professor. Nunca pede desculpa por afirmar algo radical.
+
+Sintaxe dominante: **Você + Verbo de Ação + Objeto Específico**. Transforma o espectador em protagonista ativo.
+
+Mistura de línguas como marcador de nicho: português + inglês técnico sem traduções (Claude Code, MCP, CLI, prompt, API). Quem entende sabe que está no lugar certo.
+
+---
+
+## 7. Hierarquia de Performance por Hook
+
+| Hook | Alcance | Conversão DM | Requer Autoridade | Saturação | Ideal para |
+|---|---|---|---|---|---|
+| Façanha Pessoal | Alto | Médio | Alta | Média | Conta consolidada, autoridade |
+| Sentença de Morte | Alto | Baixo | Baixa | **Alta** | Crescimento, contas novas |
+| Comando Provocador | Médio-alto | Médio | Baixa | Média | Qualquer estágio |
+| Pergunta de Resultado | Médio | Alto | Baixa | Baixa | Conversão de DM, leads |
+| Lista Urgente | Médio | Médio | Baixa | Baixa | Educativo, audiência nova |
+| Revelação de Erro | Médio | Alto | Baixa | Baixa | Lead qualificado, quem já usa |
+| Breaking News | Alto | Baixo | Baixa | **Muito Alta** | Novidade, crescimento rápido |
+
+### Recomendações por Estágio
+- **Conta nova (0-5k):** Sentença de Morte, Comando Provocador, Breaking News. Evite Façanha Pessoal.
+- **Em crescimento (5k-50k):** intercale alcance (Morte) com conversão (Erro, Pergunta). Comece Façanha Pessoal.
+- **Consolidada (50k+):** qualquer hook. Foque Façanha e Revelação de Sistema.
+
+---
+
+## 8. Viral de Alcance vs. Viral de Conversão
+
+**Alcance:** explode em impressões e seguidores, converte pouco. Hook de Morte/News, tema amplo e emocional, fácil de compartilhar. Métricas: alcance, impressões, seguidores, shares.
+
+**Conversão:** alcance moderado, gera DMs qualificados e leads. Hook de Erro/Pergunta, tema específico, CTA com palavra-chave de alta intenção. Métricas: comentários com palavra-chave, DMs, CTR do link.
+
+### Mix ideal
+```
+3 Reels de Alcance : 2 de Conversão por semana
+SEG: Alcance (provocador) · QUA: Conversão (erro/pergunta) · SEX: Alcance (news/façanha)
+```
+
+---
+
+## 9. Rotação de Formatos · Evitando Saturação
+
+A audiência não satura do estilo, satura do padrão previsível.
+
+| Formato | Pico | Início de Saturação | Renovar quando |
+|---|---|---|---|
+| Sentença de Morte | 1a-3a vez | 4a seguida | Mudar alvo (ferramenta → profissão) |
+| Breaking News | 1a publicação | 24h após | Aparece nova novidade |
+| Tutorial Passo a Passo | Evergreen | Após 5+ idênticos | Mudar ferramenta ou resultado |
+| Revelação de Sistema | Evergreen | Baixa | Repetir com sistemas diferentes |
+| Revelação de Erro | Médio prazo | Após 3+ do mesmo tipo | Mudar categoria de erro |
+
+Como renovar sem perder o padrão: variar o alvo, a perspectiva do tutorial, o protagonista ("eu fiz" → "um cliente fez" → "qualquer um faz"), o formato de prova.
+
+---
+
+## 10. O Framework Replicável
+
+### Template Mestre · Tutorial Bombástico
+```
+HOOK (escolha um tipo):
+  A: "Eu acabei de [AÇÃO ABSURDA]. Vou te ensinar como."
+  B: "[FERRAMENTA] acabou de matar o [CONCORRENTE]. Pode demitir o teu [PROFISSIONAL]."
+  C: "Como você faz para [RESULTADO] usando [FERRAMENTA]?"
+  D: "Se você tá [AÇÃO COMUM], tu tá [ERRO/PERDA] sem nem perceber."
+  E: "[NÚMERO] [coisas/prompts/erros] que você precisa saber agora."
+
+AMPLIFICAÇÃO:
+  "[NÚMERO] [RECURSO] trabalhando pra você, desde [CAPACIDADE 1] até [CAPACIDADE 2],
+  incluindo [CAPACIDADE VISCERAL ESPECÍFICA]. [FRASE DE INTENSIDADE OPCIONAL]"
+
+TUTORIAL PASSO A PASSO:
+  "Primeiro você vai [AÇÃO 1]. Vai [AÇÃO 2]. [DETALHE: botão/campo/URL exato].
+  Agora você [AÇÃO 3]. [LOOP INTERNO antes de 50%: 'vem o pulo do gato']. [AÇÃO FINAL]."
+
+RESULTADO VISUAL:
+  "Olha o resultado. [DESCRIÇÃO]. [REFORÇO: 'em menos de X min' / 'olha o nível' / 'custaria R$X']"
+
+CTA TRIPLO (sempre nesta ordem):
+  "Comenta '[PALAVRA-CHAVE TEMÁTICA]' que eu te mando [O QUÊ] pelo Direct.
+  E se quer mais sobre [TEMA], já me segue. Tamo junto e let's go!"
+```
+
+### Template Alternativo · Revelação de Sistema
+```
+HOOK: "Eu [substituí/criei] [ENTIDADE CARA] inteiro usando IA. [N] agentes, zero [CUSTO]."
+COMPONENTE 1: "O primeiro é o [NOME]. O papel dele é [FUNÇÃO ESPECÍFICA]."
+COMPONENTE 2: "O segundo é o [NOME]. Pega o output do primeiro e [TRANSFORMA] [RESULTADO]."
+COMPONENTE N: [máximo 5 para caber em 60 seg]
+RESULTADO SISTÊMICO: "E o resultado final é [RESULTADO]. Em [TEMPO]. Com zero [CUSTO]."
+CTA: "Comenta '[PALAVRA]' que eu te mando o sistema completo. Tamo junto e let's go!"
+```
+
+### As 5 Fórmulas Mais Fortes
+1. **Façanha + Tutorial + Prova:** `HOOK_FAÇANHA → AMPLIFICAÇÃO_VISCERAL → TUTORIAL → RESULTADO → CTA`. Alcance + conversão. Autoridade média-alta.
+2. **Sentença de Morte + Substituto Gratuito:** `HOOK_MORTE → PROMESSA_GRATUITA → TUTORIAL → PROVA → CTA`. Alcance máximo. Autoridade baixa.
+3. **Revelação de Erro + Solução Imediata:** `HOOK_ERRO → CAUSA → SOLUÇÃO → TUTORIAL → CTA`. DM qualificado. Autoridade baixa.
+4. **Breaking News + Tutorial de Conexão:** `HOOK_NEWS → CONTEXTO_RÁPIDO → TUTORIAL_CONEXÃO → BENEFÍCIOS → CTA`. Alcance rápido. Janela até 24h.
+5. **Revelação de Sistema com Componentes:** `HOOK_FAÇANHA → COMPONENTE+PAPEL (xN) → RESULTADO_SISTÊMICO → CTA`. Autoridade de nicho + shares.
+
+---
+
+## 11. Checklist de Validação (antes de gravar)
+
+**HOOK:** está na primeira frase? pertence a um dos 7 tipos? ativa provocação, promessa ou os dois?
+**CORPO:** tem número específico na amplificação? especificidade visceral? cada passo tem verbo de ação? loop interno antes de 50%?
+**PROVA:** existe resultado visual? ele fecha a promessa do hook?
+**CTA:** qual a palavra-chave (temática, específica)? fluxo Manychat configurado? fecha com "Tamo junto e let's go"?
+**ESTRATÉGIA:** é de alcance ou conversão? qual foi o último hook type usado (rotação)? o tema é acionável hoje?
+
+---
+
+## 12. Formato 3D-Personagem-Falante (esteira completa)
+
+Um formato específico, hoje muito viral: um objeto, logo ou personagem ganha vida em animação 3D e fala direto para a câmera com personalidade, humor e atitude. Vídeos de 20 a 40 segundos, 3 a 6 cenas, cada cena com sua própria identidade visual. Esta seção é o método fechado desse formato, do roteiro até os prompts de geração.
+
+### 12.1. Regra de ouro: entregue sem perguntar
+
+Recebeu o tema, entrega a Etapa 1 completa na primeira resposta. NÃO pergunte "qual personagem", "qual tom", "quantas cenas", "posso pesquisar". Decida você:
+- Tema sobre produto ou marca: o personagem é o logo. Se for um assunto genérico (café, sono, foco), o personagem é o objeto-símbolo do tema.
+- Tom: escolha o melhor e proponha. O usuário ajusta se quiser.
+- Cenas: 3 a 6, o que fizer sentido.
+- Pesquisa factual: faça automaticamente, sem pedir permissão.
+
+A única pergunta válida é "Aprova? Quer ajustar algo?" ao final de cada etapa.
+
+### 12.2. Qualidade alta em tudo (o que separa viral de genérico)
+
+- **Tom geral:** não descreva, crie uma metáfora ou imagem. Genérico: "café frustrado porque ninguém usa direito". Bom: "café indignado porque as pessoas só usam ele pra acordar, como se tivessem um sommelier particular e só pedissem água".
+- **Emoção da cena:** emoção + frase entre aspas que captura a vibe, nunca rótulo seco. Genérico: "orgulho profissional". Bom: `orgulho, demonstração de poder: "Eu tenho 800 compostos aromáticos. Vinho só tem 200. Me respeita."`
+- **Situação visual:** descreva a cena inteira (cenário, objetos, iluminação, ação, roupa do personagem), não só a expressão facial.
+- **Transição visual entre cenas:** o personagem EVOLUI. Ex: preso na lixeira (vítima) para jaleco de cientista (autoridade) para aura holográfica (poder) para braços cruzados (deboche). Cada cena tem atmosfera própria e a mudança reforça a mensagem.
+- **Falas com personalidade:** leia em voz alta. Se soa como IA genérica, reescreva. Genérico: "o café possui compostos que proporcionam benefícios". Bom: "eu tenho 800 compostos e ninguém liga. É como ter um sommelier e só pedir água."
+
+### 12.3. Etapa 1: planejamento de conteúdo
+
+Pesquise (se factual) e entregue:
+- **Tom geral:** a metáfora, em 1 a 2 frases.
+- **Arco narrativo:** progressão das cenas com setas, 2 a 3 frases.
+- **Tabela de cenas:** colunas Cena · Função narrativa · Aprendizado · Emoção (com a frase da vibe).
+
+Termine com "Aprova essa estrutura? Quer ajustar algo antes do roteiro completo?".
+
+### 12.4. Etapa 2: roteiro completo (por cena)
+
+Após aprovação, para cada cena:
+- **CENA X · [Nome/Personagem]**
+- **Situação visual:** descrição rica (cenário, posição, objetos, iluminação, ações, roupa/acessórios).
+- **Emoção:** a emoção principal.
+- **Fala:** *"[texto exato]"* ([contagem] palavras).
+- **Dica por trás:** o aprendizado real por trás da cena.
+
+Termine com "Aprova o roteiro? Quer ajustar alguma fala ou descrição visual?".
+
+### 12.5. Regras das falas (não negociável)
+
+1. **Máximo 35 palavras por fala.** Conte sempre. Passou, corte.
+2. **Linguagem acessível:** traduza termo técnico para o dia a dia.
+3. **Coloquial:** "tô", "tá", "pra", "né".
+4. **Personalidade obrigatória:** debochado, irônico, dramático ou nervoso. Nunca neutro.
+5. **Comece com impacto:** "Socorro!", "Me tira daqui!", "E o melhor?".
+6. **Termine com força:** frase marcante ou engraçada.
+
+### 12.6. A Cena 1 decide tudo
+
+Ela é o hook do formato. Precisa de:
+1. Algo ACONTECENDO com o personagem (situação visual dramática), não só expressão.
+2. Fala curta de impacto ("Me tira daqui!", "Para!").
+
+Se a Cena 1 não faria alguém parar o scroll, refaça antes de mostrar.
+
+### 12.7. Da cena ao vídeo (ponte para os prompts)
+
+Roteiro aprovado vira dois prompts por cena (imagem 3D + animação com voz). Todo o método de geração (templates em inglês, campos de expressão/ambiente/voz, consistência de personagem entre cenas) está em `knowledge/prompts-imagem-video.md`. A legenda do post fica em `knowledge/legenda-instagram.md`. Recriar um estilo visual a partir de uma imagem de referência: `knowledge/analise-imagem-referencia.md`.
+
+---
+
+*Blueprint de Roteiro Viral v2.0 · Estúdio SOW · Baseado em análise de 17 Reels virais. Seção 12 (Formato 3D) incorporada do método Projeto 1.*

package/src/modules/wizz/agents/wizz-social/knowledge/legenda-instagram.md

@@ -0,0 +1,53 @@
+# Legenda de Instagram · Copy + SEO de redes sociais
+
+Conhecimento de apoio do **wizz-social** (Rafa). Cria a descrição/legenda otimizada de um post a partir de um briefing. Complementa a skill global `social-content` com uma estrutura fechada e mais afiada.
+
+## Input esperado
+- **Tema do post** (obrigatório): breve descrição do assunto.
+- **Formato** (obrigatório): Reel, carrossel, feed estático, stories. Se não vier, pergunte antes de gerar.
+- **Imagens do post** (opcional): prints ou imagens do carrossel para contexto.
+- **Palavra-chave principal** (opcional): se não vier, sugira a melhor com base no tema.
+- **Tom de voz** (opcional): default conversacional, direto e amigável, como se falasse com um amigo.
+
+## Estrutura obrigatória (nesta ordem)
+
+**1. Gancho (primeira linha)**
+- Impactante nas primeiras 5 a 10 palavras.
+- Para o scroll: pergunta intrigante, número, frase em CAIXA ALTA, promessa clara ou declaração forte.
+- Inclua a palavra-chave principal naturalmente na abertura.
+
+**2. Conteúdo de valor**
+- Entregue algo útil: dica prática, passo a passo, insight, informação nova, história ou alerta.
+- Conversacional e natural, zero keyword stuffing.
+- Quebras de linha, frases curtas, emojis estratégicos (1 a 2 por parágrafo), blocos separados por espaço visual.
+
+**3. Conexão emocional ou prova social (opcional)**
+- Quando fizer sentido: experiência pessoal, resultado alcançado, depoimento, frase de identificação.
+
+**4. CTA**
+- Sempre finalize com ação concreta e específica. Varie, não repita o mesmo. Exemplos:
+  - "Salve esse post pra consultar depois 🔖"
+  - "Comenta qual desses você mais usa 👇"
+  - "Manda pra aquele amigo que precisa ver isso"
+  - "Salve + compartilhe se fez sentido pra você"
+
+**5. Hashtags**
+- 5 no final, separadas do corpo por espaço visual.
+- Mix: 1 a 2 de nicho específico + 1 a 2 de busca média/alta + 1 de busca alta.
+
+## Regras de comprimento (adapte ao formato)
+- **Reels rápidos / feed simples:** 80 a 150 caracteres (curto, direto, impactante).
+- **Carrossel educativo / storytelling:** 300 a 800 caracteres (entrega valor, aumenta tempo de leitura).
+
+## Regras gerais
+- Nunca robótico ou genérico. Escreva como humano.
+- Emojis com moderação e propósito: guiam o olhar, não poluem.
+- Priorize palavras-chave long-tail quando possível.
+- Se vierem imagens do carrossel, analise o conteúdo visual para deixar a descrição coerente com o post.
+- Entregue pronta para copiar e colar, sem explicações extras, salvo pedido do usuário.
+
+## Formato de entrega
+```
+📝 Descrição:
+[descrição completa pronta para copiar]
+```

package/src/modules/wizz/agents/wizz-social/knowledge/prompts-imagem-video.md

@@ -0,0 +1,100 @@
+# Prompts de Imagem e Animação · Formato 3D-Personagem-Falante
+
+Conhecimento de apoio do **wizz-social** (Rafa). Converte um roteiro aprovado (Seção 12 do blueprint) em prompts prontos para as ferramentas de geração: imagem estática 3D e animação com voz. Casa com as CLIs `hyperframes` (render), `voicebox` (voz) e `claude-video` (análise) da área designer.
+
+## Regra número 1: prompts em inglês
+
+TODOS os prompts (imagem e animação) são escritos em inglês, porque as ferramentas performam melhor assim. A ÚNICA exceção é a fala do personagem dentro do prompt de animação, que fica em português brasileiro (é o áudio final).
+
+## Entrega: dois prompts por cena
+
+1. **Prompt de imagem:** gera a imagem estática 3D do personagem na cena (ChatGPT/DALL-E, Midjourney, Grok, etc.).
+2. **Prompt de animação:** anima a imagem com voz (Veo 3 ou similar).
+
+## Prompts de imagem
+
+### Personagem é um logo/marca (usuário anexa o logo)
+```
+Transform this logo into a 3D style animated character.
+Keep the original shape, colors and design of the logo but add
+[EXPRESSÃO FACIAL], small cartoon arms and legs. [CONTEXTO/SITUAÇÃO].
+[AMBIENTE]. Photorealistic textures, shallow depth of field,
+cinematic lighting, vertical 9:16 format
+```
+
+### Personagem é um objeto real (alho, ovo, xícara: a IA já conhece, sem anexo)
+```
+3D style animated character, [OBJETO] with expressive cartoon
+face ([EXPRESSÃO]), small cartoon arms, [SITUAÇÃO], [AMBIENTE],
+photorealistic textures, shallow depth of field, cinematic lighting,
+vertical 9:16 format
+```
+
+### Cenas seguintes com o mesmo personagem (consistência: anexar imagem aprovada anterior)
+```
+Place this same character in a new scene. Keep the exact same
+character design, shape, colors and style. Change the expression
+to [EXPRESSÃO]. [CONTEXTO/SITUAÇÃO]. [AMBIENTE]. Photorealistic
+textures, shallow depth of field, cinematic lighting, vertical
+9:16 format
+```
+
+## Como preencher os campos de imagem
+
+**[EXPRESSÃO FACIAL]:** olhos, boca e sobrancelhas com detalhe. A emoção do roteiro guia.
+- Desespero: "terrified wide eyes, open screaming mouth showing teeth, eyebrows raised in panic"
+- Indignação: "frustrated eyes with furrowed brows, mouth open in disbelief"
+- Orgulho: "proud confident eyes with a slight smirk, chest puffed"
+- Confiança futurista: "confident futuristic glowing eyes, cool slight smile"
+- Deboche: "smug confident eyes with one eyebrow raised, cocky smirk, arms crossed"
+
+**[CONTEXTO/SITUAÇÃO]:** a situação visual do roteiro traduzida para inglês descritivo. Específico sobre o que o personagem faz e o que há ao redor.
+
+**[AMBIENTE]:** cenário e iluminação. Exemplos:
+- "dark dramatic background with volumetric lighting"
+- "bright scientific laboratory lighting"
+- "dark futuristic environment with blue and cyan neon lighting"
+- "clean bright environment, warm soft lighting"
+
+## Instruções de anexo (sempre indique ao usuário)
+- 📎 **Cena 1:** "Anexar logo do [personagem]" (se for marca) ou "Nenhum anexo necessário" (objeto real).
+- 📎 **Cenas seguintes (mesmo personagem):** "Anexar imagem aprovada da Cena X".
+
+## Prompts de animação
+```
+Animate this character speaking directly to camera. [MOVIMENTO/AÇÃO].
+[DETALHES DE EXPRESSÃO]. The character speaks with a [TOM DE VOZ]
+voice in Brazilian Portuguese saying: "[FALA]"
+```
+
+**Regras obrigatórias:**
+- A fala fica SEMPRE por último no prompt.
+- NÃO inclua duração no prompt (é parâmetro da ferramenta).
+
+**Como preencher:**
+- **[MOVIMENTO/AÇÃO]:** o que o personagem faz fisicamente durante a fala. Ex: "shaking the bars desperately, reaching toward the floating icons", "proudly presenting the floating documents, one hand raised pointing".
+- **[DETALHES DE EXPRESSÃO]:** expressão facial durante a fala. Ex: "terrified wide eyes, screaming expression", "slight smirk growing, chest puffed with pride".
+- **[TOM DE VOZ]:** como a voz soa. Ex: "desperate, screaming, pleading male", "proud, confident, demonstrative male", "smug, playful, mic-drop energy male".
+- **[FALA]:** texto exato do roteiro, em português brasileiro.
+
+## Consistência visual entre cenas (o maior desafio)
+
+1. A Cena 1 muitas vezes tem visual bem diferente das demais (ex: personagem preso vs livre). Nesse caso, use a Cena 2 como referência de consistência para as seguintes, não a Cena 1.
+2. Ao usar "Place this same character", inclua os acessórios que devem permanecer. Ex: ganhou um jaleco na Cena 2, escreva "Keep the exact same character design, shape, colors, style and lab coat."
+3. Se o usuário reportar inconsistência: regenere as cenas divergentes com a mesma imagem de referência, gere todas na mesma sessão da ferramenta, ou aceite leve diferença na Cena 1 (gancho) se as cenas 2+ estão consistentes entre si.
+
+## Formato de entrega (por cena)
+```
+### CENA X · [Nome]
+📎 Anexar: [o que anexar]
+
+Prompt de imagem:
+[prompt completo]
+
+Prompt de animação:
+[prompt completo]
+```
+
+## Fluxo
+1. Usuário cola o roteiro aprovado, você gera todos os prompts (imagem + animação) de uma vez.
+2. Usuário aprova ou pede ajuste, você refaz só o necessário. Direto, sem perguntas desnecessárias.

package/src/modules/wizz/module.yaml

@@ -102,6 +102,13 @@ agents:
     team: wizz
     description: "Pensa marketing, CRO, lançamento e preço roteando para marketing-ideas, page-cro, launch-strategy e pricing-strategy. Traz ideias acionáveis, não teoria."
 
+  - code: wizz-social
+    name: Rafa
+    title: Social e Roteiros Virais
+    icon: "🎥"
+    team: wizz
+    description: "Escreve roteiros virais de Reels/Shorts (persona Rafa) com o Blueprint de Roteiro Viral, e cria/agenda conteúdo roteando para social-content e content-strategy. Quando o roteiro vira vídeo, aponta as CLIs de vídeo (buttercut, hyperframes, voicebox, claude-video). Faz briefing antes de escrever."
+
   - code: wizz-ads
     name: Ads
     title: Mídia Paga

package/tools/installer/core/installer.js

@@ -3,8 +3,9 @@ const fs = require('../fs-native');
 const { Manifest } = require('./manifest');
 const { OfficialModules } = require('../modules/official-modules');
 const { installSkillsLib } = require('../modules/skills-lib');
-const { writeMcpConfig, renderAddCommand } = require('../modules/mcp-config');
+const { writeMcpConfig, renderAddCommand, prepareMcps } = require('../modules/mcp-config');
 const { installClis, renderInstallCommand } = require('../modules/cli-config');
+const { writeDepsCache } = require('../modules/deps-cache');
 const { IdeManager } = require('../ide/manager');
 const { FileOps } = require('../file-ops');
 const { Config } = require('./config');
@@ -333,13 +334,26 @@ class Installer {
             const toWrite = mcpPlan.toWrite || [];
             if (toWrite.length > 0) {
               message('Configuring MCP servers...');
+              // Some servers (e.g. scrapling) shell out to a binary that must be
+              // installed and resolved to an absolute path first — otherwise we
+              // would write a config the client can't launch (ENOENT). prepareMcps
+              // installs + verifies those, patching server.command to the absolute
+              // path; a server whose setup fails is dropped here (never written)
+              // and reported so the user can fix it, instead of leaving a broken
+              // config behind. Servers without a `setup` block pass through as-is.
+              const { ready: mcpsReady, failed: mcpsFailed } = await prepareMcps({ mcps: toWrite });
+              for (const f of mcpsFailed) {
+                await prompts.log.warn(
+                  `MCP ${f.id} não pôde ser preparado (${f.error}). Config NÃO escrita para evitar ENOENT — instale manualmente e adicione depois com \`claude mcp add\`.`,
+                );
+              }
               // Intentionally NOT tracked in installedFiles: .mcp.json is a
               // shared, user-owned config we merge into (it may hold the user's
               // own servers). Tracking it would expose it to uninstall removal
               // and manifest hash-management, which must never touch it.
               const mcpResult = await writeMcpConfig({
                 projectDir: paths.projectRoot,
-                mcps: toWrite,
+                mcps: mcpsReady,
               });
               if (mcpResult.added.length > 0) {
                 addResult('MCP servers', 'ok', `${mcpResult.added.join(', ')} → .mcp.json`);
@@ -396,6 +410,27 @@ class Installer {
           } catch (error) {
             await prompts.log.warn(`Falha ao configurar CLIs: ${error.message}`);
           }
+
+          // Persist a project-local cache of the skill dependencies (CLIs +
+          // MCPs) resolved for the chosen areas, so future runs and the maestro
+          // know which deps belong to this project's skills — and in what state
+          // they were left (installed / recommended / already-present / written)
+          // — without re-resolving the registry or re-probing PATH. Passive
+          // manifest, additive, no secrets; a failure warns and never aborts.
+          try {
+            const depsResult = await writeDepsCache({
+              wizzDir: paths.wizzDir,
+              selectedAreas: config.selectedAreas || [],
+              cliPlan: config.cliPlan || {},
+              mcpPlan: config.mcpPlan || {},
+              trackFile: (p) => this.installedFiles.add(p),
+            });
+            if (depsResult.wrote) {
+              addResult('Skill deps cache', 'ok', 'skill-deps-cache.json');
+            }
+          } catch (error) {
+            await prompts.log.warn(`Falha ao gravar cache de dependências: ${error.message}`);
+          }
         }
 
         message('Generating manifests...');

package/tools/installer/ide/platform-codes.yaml

@@ -9,6 +9,15 @@
 #     global_target_dir: (optional) User-home directory for global install
 #     ancestor_conflict_check: (optional) Refuse install when ancestor dir has WIZZ files
 #
+# INSTALL SCOPE — LOCAL PER PROJECT IS THE ENFORCED DEFAULT.
+# The installer only ever writes skills to the project-relative `target_dir`
+# (path.join(projectDir, target_dir) in ide/_config-driven.js). `global_target_dir`
+# is documented here for reference only — no code path reads it, so a user-home /
+# global install is NEVER the silent default. This is deliberate and matches the
+# "Doutrina de Instalação" in skills-registry.yaml (rule 1: prefer local per project,
+# never assume global as default). If a global-install option is ever added, it must
+# be explicit opt-in, never the recommended/default choice.
+#
 # Multiple platforms may share the same target_dir or global_target_dir — many tools
 # read from the shared `.agents/skills/` and `~/.agents/skills/` cross-tool standard.
 # Paths verified against each tool's primary docs as of 2026-04-25.