⚙️ Las 5 fases del motor
Cada skill hija se edita siguiendo el mismo proceso de cinco fases: corta, lee y planifica, arma motion y B-roll, aplica SFX y renderiza con QC, y por último pasa por un revisor en bucle. Cada fase tiene su control de calidad; eso es lo que hace que el resultado sea bueno de forma confiable, no por suerte.
⚙️ Fase 1 — Corte determinista
La primera fase es la más mecánica — y es la base de todo. El motor no «adivina» dónde cortar: mide la energía del audio y encuentra los fragmentos en los que realmente hablas (las islas de voz). Luego elimina los silencios, las pausas largas, los «déjame repetir» y los falsos comienzos, y siempre conserva la última toma de cada frase — la buena.
¿Nuevo por aquí? — «determinista» e «islote de voz»
Determinístico quiere decir: la misma entrada genera exactamente la misma salida, siempre —sin aleatoriedad. Islita de voz es cada tramo continuo en el que hay sonido de voz, separado de los tramos vecinos por silencio. El motor detecta las islas por energía (silencedetect), no por la transcripción.
Corte automático por energía de audio, conservando la última toma de cada frase.
Un corte predecible y limpio es la base sobre la que se apoyan todas las fases siguientes.
silencedetect, isla, última toma, determinismo.
👁️ Fase 1.5 — Leer el video y proponer un tratamiento
Entre el corte y el montaje existe una fase "intermedia" que marca toda la diferencia: el motor mira su propio corte. Usando /watch, observa los fotogramas, entiende de qué trata el video y propone un tratamiento: qué opening usar, qué tipo de B-roll encaja, dónde acelerar y dónde dar espacio. El resultado es un beat sheet — el plan de montaje.
¿Nuevo por aquí? — «/watch» y «beat sheet»
/watch es una capacidad de QC visual: el agente ve los frames del video, no solo el texto. Beat sheet es el mapa de los «golpes» (beats) de ritmo del reel: dónde entra el cold open, dónde va un B-roll, dónde se acelera. Es el guion de montaje antes de montar.
🎯 Por qué adaptar en lugar de aplicar una plantilla
Una noticia exige urgencia y datos; un tutorial, claridad y pasos; un anuncio, gancho y pruebas. Leer el video antes de montarlo permite que el motor elija el tratamiento adecuado para ESE contenido, en vez de aplicar siempre el mismo modelo, lo que generaría fatiga visual y un «look de IA».
Conceptos clave: /watch, tratamiento, beat sheet, opening, adaptación.
🎞️ Fases 2/3 — Motion graphics + B-roll real
Con el corte limpio y el plan en mano, el motor arma: el Hyperframes genera las animaciones (motion graphics) y el Firecrawl trae capturas reales de sitios y repositorios para el B-roll. Aquí se aplican dos reglas estrictas: cold open obligatorio (impacto en los primeros segundos) y nunca más de 4s sin un impacto visual.
✓ Lo que entregan estas fases
- ✓Cold open que engancha en los primeros 1–3s
- ✓Motion graphics con timeline determinista
- ✓B-roll real (captura del sitio/repo citado)
✗ Lo que impide la compuerta
- ✗Más de 4s de pantalla estática solo con el diálogo
- ✗Abrir sin gancho (sin cold open)
- ✗Imagen genérica de banco de imágenes en lugar de algo real
💡 Consejo de lectura
Hyperframes y Firecrawl vuelven a aparecer, con comandos reales, en el módulo 2.2. Aquí basta con fijar el papel de cada uno: Hyperframes = animación; Firecrawl = traer lo real desde afuera.
Conceptos clave: Hyperframes, Firecrawl, cold open, regla de los 4s.
🔊 Fase 4 — SFX, renderizado y QC
Ahora se agrega el sonido y sale el archivo. El motor superpone SFX sutiles (whoosh en las transiciones, ching en los números) debajo de la voz — y sin música por defecto, para que no compita con la voz. Después renderiza y ejecuta un QC automático que busca vacíos y superposiciones; cuando encuentra un problema, regenera ese fragmento.
SFX debajo de la voz
Efectos cortos y discretos que "producen" el corte sin convertirse en contaminación sonora. La música queda excluida por defecto.
Render
Las capas (video, motion, subtítulos, SFX) se «aplanan» en un solo MP4, manteniendo la resolución de entrada.
QC automático
Un análisis busca huecos en el ritmo y sonidos superpuestos; lo que falla vuelve a generarse, no se entrega.
Conceptos clave: SFX, render, QC (control de calidad), regeneración.
🔁 Fase 5 — Revisor independiente en bucle
La última fase es un bloqueo de seguridad: un revisor independiente — un subagente con contexto limpio — mira el render (mediante /watch) y emite un veredicto: PASS o FAIL. Si es FAIL, indica qué está mal, el motor lo corrige y el ciclo se repite. No se entrega nada antes de un PASS.
Conceptos clave: revisor, subagente, PASS/FAIL, bucle de calidad.
🧪 Por qué funciona un revisor separado
¿Por qué no dejar que el propio agente que armó el video juzgue el resultado? Porque quien lo construye se queda contaminado por lo que hizo: conoce la intención, «completa» mentalmente lo que faltó y no ve sus propios errores. El revisor es un subagente que nunca vio el montaje — juzga solo lo que está en pantalla, como lo haría un espectador.
🧠 La idea central
Una mirada sin contexto capta lo que la mirada comprometida pasa por alto. Es la misma razón por la que revisamos mejor el texto de otras personas que el nuestro: la distancia genera objetividad. El motor institucionaliza esa distancia al darle al revisor un contexto limpio.
Agente que lo armó
Conoce la intención de cada corte. Tiende a aprobar porque «sabe lo que quiso decir», aunque no se vea en pantalla.
Revisor independiente
No tiene esa memoria. Si algo no queda claro con solo verlo, lo reprueba — que es exactamente lo que sentiría un espectador.
Conceptos clave: contexto limpio, sesgo del autor, verificación independiente.
🗝️ Conceptos clave del motor
Tres ideas conectan todo lo que viste y vuelven en el módulo 2.2 (donde se convierten en scripts). Recuérdalas ahora: explican por qué el motor es confiable, no solo listo.
- Regla estricta
- Una verificación bloqueante: si no pasa, el proceso se detiene y nada avanza. Ej.: verify-cut.py (corte limpio) y lint-timeline.py (ritmo ≤4s).
- Beat sheet
- El plan de ritmo del reel: dónde entra el cold open, dónde va un B-roll y dónde se acelera. Sale de la Fase 1.5 y guía el montaje.
- Ciclo de calidad
- Repite revisar→corregir hasta un PASS. Convierte «¿quedó bien?» en una condición objetiva para detenerse.
Autorrecuperación (opcional): por qué el revisor de la Fase 5 es un subagente separado?
✅ Resumen del módulo
Siguiente módulo:
2.2 — Compuertas, scripts y determinismo (los comandos reales detrás de cada fase)