mikeOnBreeze/cc-crossbeam

Vídeo de Demostración de Producto

Genera vídeos de demostración de producto de 2 minutos para proyectos técnicos con opciones de compilación en paralelo y revisión estructurada de críticos.

Cuándo Usarlo

• Demostrar un repositorio de GitHub, API o producto técnico
• Necesitas un vídeo explicativo profesional rápidamente
• Quieres múltiples opciones de enfoque (animado vs simple)

Flujo de Trabajo (7 Fases)

DESCUBRIMIENTO → GUIÓN → COMPILACIÓN PARALELA → CRÍTICAS PARALELAS → ITERAR → FINAL → ENTREGAR
       │           │           │                │              │          │         │
     5-10m      10-15m      30-60m           10-15m        0-3 bucles   compuerta  enviar

---

Fase 1: Descubrimiento

Clonar y analizar el repositorio:

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

Extraer:

• Qué hace (1 frase)
• Para quién es
• 3-5 características clave
• Arquitectura/flujo
• Activos visuales (logotipos, diagramas)

Preguntar (o usar valores predeterminados):

Pregunta	Valor Predeterminado
Duración	2 min
Audiencia	Mixta (técnica + negocio)
Tono	Profesional-conversacional
Formato	Explicador animado

---

Fase 2: Guion

Usar la estructura de references/script-template.md:

Escena 1: Gancho (0:00-0:15) — Declaración del problema
Escena 2: Contexto (0:15-0:30) — Por qué esto es importante
Escenas 3-5: Características (0:30-1:30) — 3 capacidades clave, 20s cada una
Escena 6: Técnica (1:30-1:50) — Arquitectura/credibilidad
Escena 7: Llamada a la acción (1:50-2:00) — Qué hacer a continuación

Directrices:

• 150 palabras/minuto
• Máximo 20 palabras/oración
• Voz activa
• Concreto sobre vago

---

Fase 3: Compilación en Paralelo

Generar 2 subagentes para construir opciones simultáneamente:

// Opción A: Remotion (animado)
sessions_spawn({
  label: "demo-video-option-a",
  task: `Construir video de demostración animado usando Remotion.
  
  Guion: [pegar guion]
  Voz: Usar ElevenLabs, ID de voz CcEB0ARKH8qIyzh2I1OR
  Salida: /tmp/demo-video/option-a.mp4
  
  Enfoque:
  1. Generar voz en off por escena (API de ElevenLabs)
  2. Crear proyecto Remotion con componentes de escena
  3. Sincronizar animaciones con el tiempo del audio
  4. Renderizar a 1080p 30fps`
})

// Opción B: Diapositivas + ffmpeg (simple)
sessions_spawn({
  label: "demo-video-option-b", 
  task: `Construir video de demostración basado en diapositivas.
  
  Guion: [pegar guion]
  Voz: Usar ElevenLabs, ID de voz CcEB0ARKH8qIyzh2I1OR
  Salida: /tmp/demo-video/option-b.mp4
  
  Enfoque:
  1. Generar voz en off (API de ElevenLabs)
  2. Crear diapositivas con Puppeteer (HTML → PNG)
  3. Combinar con ffmpeg, sincronizar con el audio
  4. Añadir transiciones simples`
})

Esperar a ambas. Presentar opciones al usuario o seleccionar automáticamente según la calidad.

---

Fase 4: Críticas en Paralelo

Generar 2 personajes críticos (ver references/ para rúbricas completas):

// Crítico de Negocio
sessions_spawn({
  label: "critic-business",
  task: `Revisar video de demostración como Crítico de Negocio "Mike".
  
  Video: [ruta]
  Guion: [contenido]
  
  Ver references/critic-business.md para el personaje completo y rúbrica.
  
  Puntuar: Claridad, Profesionalismo, Valor de negocio (1-10 cada una)
  Salida: Revisión estructurada con puntuación general y correcciones específicas.`
})

// Crítico Técnico  
sessions_spawn({
  label: "critic-technical",
  task: `Revisar video de demostración como Crítico Técnico "Ingeniero Senior".
  
  Video: [ruta]
  Guion: [contenido]
  
  Ver references/critic-technical.md para el personaje completo y rúbrica.
  
  Puntuar: Precisión técnica, Credibilidad, Integridad (1-10 cada una)
  Salida: Revisión estructurada con puntuación general y correcciones específicas.`
})

---

Fase 5: Iterar

Puertas de calidad:

Puerta	Acción
Ambos críticos ≥7.5, sin problemas críticos	→ Enviar
Algún crítico <7.0 O problema crítico	→ Iterar
Después de 3 iteraciones, aún fallando	→ Escalar a humano

Bucle de iteración:

1. Recopilar todos los problemas críticos/importantes
2. Corregir en orden de gravedad
3. Volver a renderizar solo las escenas afectadas (si es posible)
4. Volver a ejecutar críticos

---

Fase 6: Revisión Final

Antes de enviar, verificar:

• Ambos críticos aprobaron (7.5+)
• No quedan problemas críticos
• Audio sincronizado correctamente
• Todas las escenas se renderizan limpiamente
• La llamada a la acción es clara

---

Fase 7: Entregar

Salida:

✅ Video de demostración completado.

📹 Video: demo-video-final.mp4 (2:03)
🎯 Audiencia: [objetivo]
📊 Puntuaciones: Negocio 8.2/10 | Técnico 7.8/10

Cubre:
1. [Punto clave 1]
2. [Punto clave 2]  
3. [Punto clave 3]

Archivos guardados en: [ubicación]

Entregar a:

• Canal de Slack (si se especifica)
• Guardar en workspace/outputs/

---

Herramientas y Dependencias

Herramienta	Propósito	Requerida
ElevenLabs	Generación de voz en off	Sí
Remotion	Framework de video React (Opción A)	Una de A/B
ffmpeg	Procesamiento de video (Opción B)	Una de A/B
Puppeteer	Capturas de diapositivas (Opción B)	Una de A/B
sessions_spawn	Subagentes en paralelo	Sí

Voz predeterminada: CcEB0ARKH8qIyzh2I1OR (Jeremy - Narrador de Tutoriales Técnicos)

---

Referencias de Archivos

• references/critic-business.md — Persona crítico de negocio y rúbrica
• references/critic-technical.md — Persona crítico técnico y rúbrica
• references/script-template.md — Estructura de guion escena por escena
• templates/remotion/ — Andamio de proyecto Remotion con componentes
• scripts/generate-voiceover.py — Ayudante de TTS de ElevenLabs
• scripts/render-slides.sh — Combinador de diapositivas a video con ffmpeg