mikeOnBreeze/cc-crossbeam

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 construçã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 abordagens (animado vs. simples)

Fluxo de Trabalho (7 Fases)

DESCOBERTA → ROTEIRO → CONSTRUÇÃO PARALELA → CRÍTICOS PARALELOS → ITERAR → FINAL → ENTREGAR
   │           │           │                │              │          │         │
 5-10m      10-15m      30-60m           10-15m        0-3 loops   gate    ship it

---

Fase 1: Descoberta

Clone e analise o repositório:

gh repo clone <proprietario/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 é importante
Cenas 3-5: Funcionalidades (0:30-1:30) — 3 capacidades principais, 20s cada
Cena 6: Técnica (1:30-1:50) — Arquitetura/credibilidade
Cena 7: CTA (1:50-2:00) — O que fazer em seguida

Diretrizes:

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

---

Fase 3: Construção Paralela

Crie 2 subagentes para construir opções simultaneamente:

// Opção A: Remotion (animado)
sessions_spawn({
  label: "demo-video-opcao-a",
  task: `Construa vídeo de demonstração animado usando Remotion.

  Roteiro: [colar roteiro]
  Voz: Use ElevenLabs, ID de voz CcEB0ARKH8qIyzh2I1OR
  Saída: /tmp/demo-video/opcao-a.mp4

  Abordagem:
  1. Gerar narração por cena (API ElevenLabs)
  2. Criar projeto Remotion com componentes de cena
  3. Sincronizar animações com o áudio
  4. Renderizar em 1080p 30fps`
})

// Opção B: Slides + ffmpeg (simples)
sessions_spawn({
  label: "demo-video-opcao-b",
  task: `Construa vídeo de demonstração baseado em slides.

  Roteiro: [colar roteiro]
  Voz: Use ElevenLabs, ID de voz CcEB0ARKH8qIyzh2I1OR
  Saída: /tmp/demo-video/opcao-b.mp4

  Abordagem:
  1. Gerar narração (API ElevenLabs)
  2. Criar slides com Puppeteer (HTML → PNG)
  3. Combinar com ffmpeg, sincronizar com áudio
  4. Adicionar transições simples`
})

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

---

Fase 4: Críticos Paralelos

Crie 2 personas de crítica (veja references/ para rubricas completas):

// Crítico de Negócios
sessions_spawn({
  label: "critico-negocios",
  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: "critico-tecnico",
  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	→ Entregar
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 entregar, verifique:

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

---

Fase 7: Entregar

Saída:

✅ Vídeo de demonstração concluído!

📹 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 chave 1]
2. [Ponto chave 2]
3. [Ponto chave 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	Captura de tela de slides (Opção B)	Uma de A/B
sessions_spawn	Subagentes paralelos	Sim

Voz padrão: CcEB0ARKH8qIyzh2I1OR (Jeremy - Narrador de Tutorial Técnico)

---

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/ — Esqueleto de projeto Remotion com componentes
• scripts/generate-voiceover.py — Helper de TTS ElevenLabs
• scripts/render-slides.sh — Combinador de slides para vídeo com ffmpeg