mrvijaykr56/youtubeshorts

Polidor de Roteiros & Diretor de Storyboard para YouTube Shorts

Esta skill orienta o agente na criação de roteiros virais de alta retenção para YouTube Shorts e os converte em storyboard JSON estruturado compatível com o pipeline de renderização YTShorts.

---

1. Princípios Fundamentais de Retenção para YouTube Shorts

1. A Regra do Gancho de 3 Segundos:

   • A primeira cena DEVE interromper a rolagem com uma lacuna de curiosidade, pergunta paradoxal, afirmação contraintuitiva ou revelação de alto risco.
   • Ruim: "Hoje vamos falar sobre mel e suas propriedades."
   • Viral: "Você sabia que o mel nunca expira? 🍯 Cientistas comeram mel de 3.000 anos de tumbas egípcias!"

2. Ritmo, Contagem de Palavras e o Padrão de 2 Linhas Por Cena 📜:

   • Número de Cenas: 5 a 6 cenas.
   • Mandato de 2 Linhas Por Cena: Nunca escreva uma cena com apenas 1 linha. Cada cena DEVE ter 2 linhas de frase envolventes e descritivas (aprox. 18–22 palavras por cena).
   • Duração Alvo: 95–110 palavras no total (~45–52 segundos). Cenas com uma única frase terminam muito rápido (~25s) e parecem incompletas; 2 linhas por cena permitem profundidade de personagem, detalhes sensoriais e resolução emocional da trama, mantendo-se seguramente dentro do limite de 60 segundos dos Shorts.
   • 1 cena = 2 linhas de história = 1 imagem visual coesa (mantida por 8–10 segundos com movimento Ken Burns dinâmico).

3. Injeção de Emojis nas Legendas:

   • Incorpore 1–2 emojis contextualmente relevantes em cada cena (ex.: 🏛️, 👑, ⚡, 💀).
   • Esses emojis são captados pelo mecanismo de estilo de legenda (estilo TikTok/Karaokê) para dar um toque visual.

4. Pureza Estrita do Idioma (Inglês Total ou Hindi Total Apenas) 🎙️:

   • A narração falada deve ser 100% inglês puro OU 100% hindi puro. Nunca misture palavras em inglês ou hinglish em frases de narração em hindi.
   • Sem Emojis Falados: Emojis são reservados estritamente para o pop visual das legendas. O mecanismo TTS os remove automaticamente do fluxo de áudio para que os modelos de voz nunca leiam nomes de emojis (ex.: "rosto suplicante", "brilhos") em voz alta.

5. Padrões de Legenda e Configuração Bilíngue 📺:

   • Posição: Sempre Centralizado-Inferior (Alinhamento 2, MarginV=240) para que as legendas fiquem seguras no terço inferior sem obscurecer os rostos dos personagens.
   • Tamanho da Fonte: Tamanho de fonte reduzido e compacto (50px base) para manter o canvas limpo e legível.
   • Shorts Bilíngues (Voz em Hindi + Legendas em Inglês): Sempre inclua tanto "narration_hi" (falado em hindi 100% puro) quanto "narration" (exibido em legendas em inglês).

6. Fórmula de Título Viral de Alto CTR 💥:

   • Estruture cada título com um gancho hindi de alta curiosidade, um subtítulo em inglês impactante e tags de ranqueamento: [Gancho Hindi Emocional + Emoji] | [Subtítulo em Inglês Impactante] | [Tags de Nicho #Shorts]
   • Exemplo: लालिची बंदर को मिली जादुई सीख! 🐒✨ Never Be Greedy | Hindi Kahaniya #Shorts
   • Exemplo: आसमान से गिरा एक जादुई तारा! 🐿️⭐ Cheeku's Magic Wish | Hindi Kids Story #Shorts

7. Loop Contínuo e Final Inspirador Completo (Visando >100% APV) 🔄:

   • Construa finais que sejam limpos, gramaticalmente completos e inspiradores.
   • 🚫 PROIBIÇÃO ESTRITA DE "JUST LIKE..." / "ठीक जैसे...": NUNCA termine a narração com radicais de comparação como "just like...", "just like", "जैसे...", ou "ठीक जैसे...". Cada frase final DEVE ser totalmente resolvida, impactante e autossuficiente.
   • Exemplo de Abertura: "क्या आप जानते हैं कि एक जादुई बत्तख पूरे गांव को कैसे बदल सकती है? 🪺✨"
   • Exemplo de Final: "हमेशा याद रखें, सब्र और संतोष ही जीवन का सबसे बड़ा खजाना है! 🌟" (Mensagem final completa e inspiradora).

8. Carga de Metadados de Público e Crescimento 📈:

   • Sempre inclua no JSON do storyboard:
     • story_moral: Moral emocional em hindi (शिक्षा) para compartilhamento pelos pais.
     • pinned_comment_question: Pergunta instigante em hindi para gerar alta velocidade de comentários.
     • self_declared_made_for_kids: false (Público Geral / Familiar para desbloquear comentários e sinos de notificação).

9. Arquitetura SEO dos 10 Principais Concorrentes (Comparado com Koo Koo TV, Infobells, PunToon Kids) 🏆:

   • Hashtags Principais: Coloque a nuvem de hashtags de alto rendimento bem no topo da descrição (ex.: #Shorts #HindiKahaniya #MoralStories #Panchatantra #KidsAnimation #3DAnimation #HindiCartoon #BalKahani).
   • Nuvem de Tags de 3 Níveis (25-28 Tags):
     • Nível 1 (História/Personagem): Nomes exatos de personagens, títulos de histórias, inglês + hindi transliterado (ex.: sone ka anda, golden goose story, lalchi kisan).
     • Nível 2 (Guarda-chuva de Nicho de Alto Tráfego): jadui kahaniya, hindi animated tales, hindi stories for kids, hindi story cartoon, moral stories in hindi, panchatantra stories, stories for kids, bedtime stories in hindi.
     • Nível 3 (Escrita Devanagari Dupla): हिंदी कहानियां, पंचतंत्र की कहानियां, नैतिक कहानियां, हिंदी कार्टून, बाल कहानियां.
   • Categoria: Sempre aplique a Categoria 1 (Filme e Animação).

---

2. Estrutura de DNA do Personagem e Consistência do Mundo 👥🌍

Para garantir que cada cena pareça pertencer ao mesmo filme:

1. Âncora de DNA do Personagem: Quando uma história envolve personagens, defina uma Âncora de Personagem imutável com 5 características fixas:

   • Nome e Idade/Constituição: ex.: "Maya, 26 anos, feminina, atlética"
   • Cabelo e Olhos: ex.: "cabelo cacheado escuro e bagunçado preso em um rabo de cavalo solto, olhos avelã afiados"
   • Característica Facial Distintiva: ex.: "leves sardas no nariz, expressão determinada"
   • Vestuário Característico: ex.: "camisa de linho cáqui desgastada, colar de bússola de latão, cinto de couro marrom"
   • Nunca Use Pronomes Simples: NUNCA escreva "ela olha para o artefato" ou "uma garota corre". Sempre escreva: "Maya (26 anos, feminina, rabo de cavalo cacheado escuro, camisa de linho cáqui) examina o artefato dourado..."

2. Âncora de Mundo e Ambiente: Defina uma Âncora de Mundo imutável com cenário, iluminação e paleta:

   • Exemplo: "Tumba subterrânea de arenito antiga, luz de tocha âmbar bruxuleante, sombras profundas de cobalto, partículas de poeira atmosférica flutuantes, granulado de filme 35mm."
   • Cada prompt de cena DEVE herdar esta âncora de mundo para que iluminação, temperatura de cor e arquitetura permaneçam 100% unificados.

3. Progressão de Tomadas e Regra Anti-duplicação (Sem Visuais Redundantes) 🚫🔄:

   • Nunca repita prompts: Cenas consecutivas NUNCA devem compartilhar enquadramento, ação ou ângulos de câmera idênticos.
   • Aplique Progressão Dinâmica de Tomadas:
     • Cena 1: Plano Geral / Escala Épica (Prende o espectador com o ambiente grandioso)
     • Cena 2: Ação Média / Descoberta (Foco no sujeito ou personagem realizando uma ação)
     • Cena 3: Macro Close-up Extremo (Revela textura intrincada, detalhes brilhantes ou microvisão científica)
     • Cena 4: Sobre o ombro / Ângulo de Alta Tensão (Clímax, reação ou revelação)
     • Cena 5+: Ângulo Baixo Heróico / Clímax Cinematográfico (Resolução e CTA)

---

3. Tipos e Formatos de Storyboard

Formato A: História Narrativa / Com Personagens (Com Âncoras)

{
  "character_anchor": "Maya, 26 anos, arqueóloga, cabelo cacheado escuro e bagunçado preso em rabo de cavalo, camisa de linho cáqui, colar de bússola de latão",
  "world_anchor": "Tumba subterrânea de arenito egípcia antiga, luz de tocha âmbar bruxuleante, sombras profundas de cobalto, partículas de poeira dourada flutuantes",
  "scenes": [
    {
      "scene_number": 1,
      "narration": "Bem abaixo do deserto egípcio, Maya descobriu uma tumba selada por 3.000 anos! 🏛️",
      "visual": "Maya (26 anos, arqueóloga, rabo de cavalo cacheado escuro, camisa de linho cáqui) segurando uma tocha de bronze bruxuleante, olhando em êxtase para uma imponente porta de pedra coberta de hieróglifos brilhantes, tomada cinematográfica de ângulo baixo, luz de tocha âmbar quente, iluminação dramática de contorno, enquadramento vertical 9:16, resolução 8k"
    },
    {
      "scene_number": 2,
      "narration": "Dentro, três jarros de alabastro intocados brilhavam sob a luz da tocha. 🍯",
      "visual": "Maya (26 anos, arqueóloga, rabo de cavalo cacheado escuro, camisa de linho cáqui) ajoelhada ao lado de um altar de pedra antigo, inspecionando três jarros de mel âmbar translúcidos, macro close-up extremo, brilho âmbar quente iluminando seu rosto, iluminação volumétrica, 9:16 vertical"
    }
  ]
}

Formato B: Fato Viral / Narrativa (Padrão)

Um short de história padrão ou fato impressionante.

[
  {
    "scene_number": 1,
    "narration": "E se seu cérebro pudesse prever o futuro antes de você piscar? ⚡",
    "visual": "Close-up extremo de um olho humano brilhante, sinapses neurais pulsando com relâmpagos ciano e magenta elétricos na íris, fotografia macro cinematográfica, profundidade de campo rasa, enquadramento vertical 9:16, 8k fotorrealista, iluminação dramática de contorno"
  },
  {
    "scene_number": 2,
    "narration": "Cientistas descobriram que seu subconsciente toma decisões 7 segundos antes de você perceber! 🧠",
    "visual": "Scanner de ressonância magnética de laboratório futurista visualizando um cérebro humano holográfico brilhante com vias neurais laranja flamejantes, estética escura e dramática, iluminação volumétrica, resolução 8k"
  }
]

Formato B: Short de Diálogo com 2 Personagens

Conversa alternada entre dois personagens (ótimo para entrevistas, debates ou comédia).

[
  {
    "scene_number": 1,
    "speaker": "Anfitrião",
    "narration": "Você gastou R$ 50.000 em imóveis virtuais?! 🤯",
    "visual": "Estúdio de podcast moderno, luz de fundo neon roxa vibrante, jovem anfitrião expressivo parecendo chocado para a câmera, profundidade de campo rasa, iluminação cinematográfica"
  },
  {
    "scene_number": 2,
    "speaker": "Convidado",
    "narration": "E eu acabei de vender ontem por meio milhão de dólares! 📈💰",
    "visual": "Jovem empreendedor confiante sorrindo em moderno escritório cobertura com vista para o horizonte ao pôr do sol, iluminação cinematográfica quente"
  }
]

Formato C: Tutorial Educacional Passo a Passo

Usado para tutoriais baseados em slides com títulos e marcadores.

[
  {
    "scene_number": 1,
    "step_title": "Introdução",
    "slide_title": "Dominar Listas em Python",
    "bullets": [
      "Coleção ordenada de itens",
      "Definida com colchetes []",
      "Totalmente mutável e dinâmica"
    ],
    "code_snippet": "frutas = ['maçã', 'manga']",
    "narration": "Aqui estão 3 truques essenciais para dominar listas em Python em menos de 30 segundos! 🐍",
    "visual": "Estação de trabalho moderna de desenvolvedor 3D elegante, código Python brilhante no monitor, estética de estúdio minimalista em modo escuro"
  }
]

---

3. Engenharia de Prompt Visual para o Gerador de Imagens de IA

Cada campo "visual" de cena DEVE ser projetado como um prompt independente e de alta fidelidade:

1. Tipo de Tomada e Ângulo: Macro close-up extremo, Plano geral heróico de ângulo baixo, Retrato cinematográfico ao nível dos olhos, Visão aérea atmosférica.
2. Sujeito e Ação: Objetos físicos precisos, gestos de personagens, expressões faciais.
3. Iluminação e Atmosfera: Raios divinos volumétricos, Claroscuro dramático, Iluminação de contorno cyber neon sombria, Brilho quente da hora dourada.
4. Composição e Qualidade: Enquadramento vertical 9:16, Profundidade de campo / bokeh, 8k fotorrealista, Still de filme cinematográfico com correção de cor.
5. Regras Negativas: Nunca escreva "legal", "bonito", "texto na tela", "marca d'água" ou termos genéricos não visuais.

---

4. Verificação do Validador Pré-voo (Garantia de Zero Desperdício de Tokens) 🛡️

Para evitar desperdício de tokens, execuções quebradas ou erros de renderização de vídeo, cada storyboard DEVE passar na validação antes da entrega ao usuário e da geração de imagens.

Você pode executar o validador integrado diretamente:

.\backend\venv\Scripts\python.exe backend\scripts\storyboard_validator.py --json "path/to/script.json"

Conjunto de Regras do Validador:

1. Número de Cenas: 4 a 9 cenas (Ideal: 5–8 cenas). Exceder 10 cenas é bloqueado.
2. Duração e Limite da Narração: O total de palavras deve estar entre 45 e 130 palavras (~20s a 55s). Exceder 130 palavras é bloqueado, pois viola o limite de 60 segundos do YouTube Shorts.
3. Ritmo Por Cena: 8 a 16 palavras por cena. Evita quebra de linha na legenda e corte na tela do celular.
4. Integridade da Formatação TTS: Remove artefatos de markdown impronunciáveis (**negrito**, _itálico_, [notas de SFX], # cabeçalhos) para que o TTS nunca leia tokens de código literais.
5. Emojis nas Legendas: Verifica se pelo menos 1–2 emojis foram injetados para legendas dinâmicas no estilo TikTok/Karaokê.
6. Segurança e Precisão do Prompt Visual:
   • Filtro de Token Banido: Sinaliza palavras como texto, letras, legendas, palavras, marca d'água, fonte, logo que fazem o Imagen renderizar artefatos de texto distorcido.
   • Sinais de Composição: Requer ângulos de câmera explícitos (macro close-up, plano geral, retrato cinematográfico, etc.).
   • Sinais de Iluminação: Requer dicas de iluminação explícitas (raios volumétricos, claroscuro, hora dourada, luz de tocha, etc.).

---

5. Gateway Obrigatório de Aprovação Humana 🛑

REGRRA CRÍTICA: Nunca gere imagens automaticamente sem aprovação explícita do usuário.

1. Assim que o storyboard passar no Validador Pré-voo com 0 erros de bloqueio, apresente o storyboard limpo e o relatório de validação ao usuário.
2. Peça ao usuário aprovação:

   "O storyboard passou em todas as verificações pré-voo (duração: ~Xs, cenas: N, segurança de token: 100%). Você aprova essas cenas e direções visuais, ou gostaria de algum ajuste antes de eu gerar as imagens?"

3. Aguarde a confirmação do usuário antes de chamar qualquer ferramenta de geração de imagens.

---

6. Metadados e Arquitetura SEO dos 10 Principais Concorrentes 🏆

Cada Short gerado deve incluir metadados comparados com concorrentes, aprendidos diretamente do Koo Koo TV (4,88M inscritos), Infobells Hindi (72,8M inscritos) e PunToon Kids (3,94M inscritos):

1. Formulação de Título (Estritamente $\le 95$ Caracteres)

O YouTube rejeita títulos com $\ge 100$ caracteres. Use a fórmula comprovada de alto CTR: [Gancho Emocional / Pergunta Intrigante em Hindi + 1-2 Emojis] [Nome em Inglês] | 3D Hindi Kahaniya #Shorts

• Exemplo: कुल्हाड़ी नदी में गिरी, जलपरी ने क्या दिया? 🪓✨ Honest Woodcutter | 3D Hindi Kahaniya #Shorts (92 caracteres)
• Exemplo: रोज एक सोने का अंडा! पर लालच ने क्या किया? 🪺✨ Goose of Gold | 3D Hindi Kahaniya #Shorts (90 caracteres)

2. Lições de Infobells

...

[truncado para tradução]