mfrancime/trident-archive

Vídeo de Demonstração de Produto

Gere vídeos de demonstração de produto de 2 minutos para projetos técnicos, com opções de compilação paralela e revisão crítica estruturada.

Quando Usar

• Para demonstrar um repositório GitHub, API ou produto técnico
• Precisa de um vídeo explicativo profissional rapidamente
• Deseja múltiplas opções de abordagem (animado vs. simples)

Fluxo de Trabalho (7 Fases)

DESCOBERTA → ROTEIRO → COMPILAÇÃO PARALELA → CRÍTICAS PARALELAS → ITERAR → FINAL → ENTREGAR
     │           │             │                     │                │          │         │
  5-10m      10-15m        30-60m                10-15m          0-3 loops   portão    enviar

---

Fase 1: Descoberta

Clone e analise o repositório:

gh repo clone <owner/repo> /tmp/<repo>

Extraia:

• O que faz (1 frase)
• Para quem é
• 3-5 funcionalidades principais
• Arquitetura/fluxo
• Ativos visuais (logotipos, diagramas)

Pergunte (ou use padrões):

Pergunta	Padrão
Duração	2 min
Público-alvo	Misto (técnico + negócios)
Tom	Profissional-conversacional
Formato	Explicador animado

---

Fase 2: Roteiro

Use a estrutura de references/script-template.md:

Cena 1: Gancho (0:00-0:15) — Declaração do problema
Cena 2: Contexto (0:15-0:30) — Por que isso importa
Cena 3-5: Funcionalidades (0:30-1:30) — 3 capacidades principais, 20s cada
Cena 6: Técnico (1:30-1:50) — Arquitetura/credibilidade
Cena 7: CTA (1:50-2:00) — O que fazer a seguir

Diretrizes:

• 150 palavras/minuto
• Máximo 20 palavras/frase
• Voz ativa
• Concreto em vez de vago

---

Fase 3: Compilação Paralela

Gere 2 subagentes para construir opções simultaneamente:

// Opção A: Remotion (animado)
sessions_spawn({
  label: "demo-video-option-a",
  task: `Construa vídeo de demonstração animado usando Remotion.
  
  Roteiro: [cole o roteiro]
  Voz: Use ElevenLabs, ID de voz CcEB0ARKH8qIyzh2I1OR
  Saída: /tmp/demo-video/option-a.mp4
  
  Abordagem:
  1. Gere narração por cena (API ElevenLabs)
  2. Crie projeto Remotion com componentes de cena
  3. Sincronize animações ao tempo do áudio
  4. Renderize em 1080p 30fps`
})

// Opção B: Slides + ffmpeg (simples)
sessions_spawn({
  label: "demo-video-option-b",
  task: `Construa vídeo de demonstração baseado em slides.
  
  Roteiro: [cole o roteiro]
  Voz: Use ElevenLabs, ID de voz CcEB0ARKH8qIyzh2I1OR
  Saída: /tmp/demo-video/option-b.mp4
  
  Abordagem:
  1. Gere narração (API ElevenLabs)
  2. Crie slides com Puppeteer (HTML → PNG)
  3. Combine com ffmpeg, sincronize com áudio
  4. Adicione transições simples`
})

Aguarde ambos. Apresente as opções ao usuário ou selecione automaticamente com base na qualidade.

---

Fase 4: Críticas Paralelas

Gere 2 personas de críticos (veja references/ para rubricas completas):

// Crítico de Negócios
sessions_spawn({
  label: "critic-business",
  task: `Revise o vídeo de demonstração como Crítico de Negócios "Mike".
  
  Vídeo: [caminho]
  Roteiro: [conteúdo]
  
  Veja references/critic-business.md para persona e rubrica completas.
  
  Pontuação: Clareza, Profissionalismo, Valor de Negócio (1-10 cada)
  Saída: Revisão estruturada com pontuação geral e correções específicas.`
})

// Crítico Técnico
sessions_spawn({
  label: "critic-technical",
  task: `Revise o vídeo de demonstração como Crítico Técnico "Engenheiro Sênior".
  
  Vídeo: [caminho]
  Roteiro: [conteúdo]
  
  Veja references/critic-technical.md para persona e rubrica completas.
  
  Pontuação: Precisão Técnica, Credibilidade, Completude (1-10 cada)
  Saída: Revisão estruturada com pontuação geral e correções específicas.`
})

---

Fase 5: Iterar

Portões de qualidade:

Portão	Ação
Ambos críticos ≥7,5, sem problemas Críticos	→ Enviar
Qualquer crítico <7,0 OU problema Crítico	→ Iterar
Após 3 iterações, ainda falhando	→ Escalar para humano

Loop de iteração:

1. Colete todos os problemas Críticos/Importantes
2. Corrija em ordem de gravidade
3. Re-renderize apenas as cenas afetadas (se possível)
4. Reexecute os críticos

---

Fase 6: Revisão Final

Antes de enviar, verifique:

• Ambos críticos passaram (7,5+)
• Nenhum problema Crítico restante
• Áudio sincronizado corretamente
• Todas as cenas renderizam limpo
• CTA está claro

---

Fase 7: Entregar

Saída:

✅ Vídeo de demonstração completo!

📹 Vídeo: demo-video-final.mp4 (2:03)
🎯 Público-alvo: [alvo]
📊 Pontuações: Negócios 8,2/10 | Técnico 7,8/10

Cobre:
1. [Ponto principal 1]
2. [Ponto principal 2]
3. [Ponto principal 3]

Arquivos salvos em: [local]

Entregue para:

• Canal do Slack (se especificado)
• Salvar em workspace/outputs/

---

Ferramentas e Dependências

Ferramenta	Propósito	Obrigatório
ElevenLabs	Geração de narração	Sim
Remotion	Framework de vídeo React (Opção A)	Uma de A/B
ffmpeg	Processamento de vídeo (Opção B)	Uma de A/B
Puppeteer	Capturas de tela de slides (Opção B)	Uma de A/B
sessions_spawn	Subagentes paralelos	Sim

Voz padrão: CcEB0ARKH8qIyzh2I1OR (Jeremy - Narrador de Tutoriais Técnicos)

---

Referências de Arquivos

• references/critic-business.md — Persona e rubrica do crítico de negócios
• references/critic-technical.md — Persona e rubrica do crítico técnico
• references/script-template.md — Estrutura de roteiro cena por cena
• templates/remotion/ — Scaffold de projeto Remotion com componentes
• scripts/generate-voiceover.py — Helper TTS do ElevenLabs
• scripts/render-slides.sh — Combinador slide-para-vídeo do ffmpeg