Haz un Video - La Habilidad de Principiante a MP4 Terminado
Dos fases, ocho compuertas secuenciales. Cada compuerta produce un artefacto concreto que la siguiente compuerta consume. No te saltes las compuertas.
Cuándo usar esta habilidad - y cuándo delegar
Usa esta habilidad cuando:
- El usuario es nuevo en HyperFrames y comienza desde un concepto, guión o esquema
- Quiere un recorrido completo, no material de referencia del framework
- Aún no ha decidido el formato
Delega cuando:
- El usuario pega una URL y quiere un video de ese sitio → invoca
/website-to-hyperframes - El usuario quiere explícitamente un video vertical 9:16 con cámara facial + superposiciones de escena → ejecuta las Puertas 1–4 aquí, luego invoca
/short-form-videodesde la Puerta 5 en adelante - El usuario pide reglas del framework, no un video → invoca
/hyperframes
Nota de ruta (pipeline AI Edit Video): cuando esta habilidad se ejecuta desde un resumen de proyecto, las secciones STYLE DESIGN y PHONG CÁCH DỰNG (estilo de video) del mensaje de edición anulan los valores predeterminados de la entrevista a continuación - no vuelvas a preguntar preguntas de estilo que el resumen ya responda.
Las dos fases
- Fase 1 - ENTREVISTA (Puertas 1–4): un solo pase conversacional para recopilar todo antes de tocar código. Intención, formato, guión, voz, estilo, activos, ritmo. Sintetiza en un
BRIEF.mdy espera la aprobación explícita. - Fase 2 - CONSTRUCCIÓN (Puertas 5–8): andamiaje → storyboard → composiciones → lint → vista previa en Studio → render de borrador → verificación visual → vista previa MP4 → render final.
Puerta 1 · Intención y formato
Haz una pregunta a la vez mediante AskUserQuestion, con opción múltiple cuando sea posible.
- ¿Para qué es este video? (promo · anuncio social · teaser de lanzamiento · demo de producto · tutorial · explicativo · tarjeta de intro/outro · otro)
- ¿Quién es la audiencia? (abierta)
- ¿Duración objetivo? (corto 10–20s · promo 20–45s · explicativo 45–90s · lección 1.5–3 min · personalizada)
- ¿Relación de aspecto? (16:9 1920×1080 · 9:16 1080×1920 · 1:1 1080×1080)
- ¿Fotogramas por segundo? (30 predeterminado · 60 para UI nítida · 24 cinematográfico)
- ¿Restricciones de plataforma / entrega? (tamaño de archivo · fecha límite · dónde se reproducirá)
Puerta: los seis capturados. Si la respuesta es 9:16 + cámara facial, planifica delegar a /short-form-video en la Puerta 5.
Banco completo de preguntas: Read: references/interview-questions.md
Puerta 2 · Guión y voz
- ¿Fuente del guión? (pegar · esquema → Yo redactaré · Yo grabaré · TTS desde texto · sin narración)
- Si es TTS: preferencia de voz. Ofrece opciones de
npx hyperframes tts --help. También captura el ritmo.hyperframes tts(Kokoro) es solo inglés - la narración en vietnamita pasa por el/api/ttsdel sistema (Gemini TTS o VieNeu). - Si hay cámara facial: ruta de grabación · colocación en pantalla completa o esquina · ¿necesita transcripción? (
npx hyperframes transcribe <archivo> --model small.en --json- solo inglés; para vietnamita usa faster-whisper según la habilidad noti-tiktok-vn) - ¿Subtítulos? (desactivados · hype · corporativo · karaoke-palabra-por-palabra · mínimo)
Puerta: guión capturado (o redactado), plan de audio capturado, plan de subtítulos capturado.
Puerta 3 · Recepción de estilo
Antes de preguntarle nada al usuario, inventaría los activos existentes. Revisa <workspace-root>/assets/ y cualquier carpeta assets/ del proyecto. No preguntes por lo que ya está ahí.
Luego pregunta progresivamente - no necesitan respuestas a todas estas:
- ¿Guía de estilo o documento de marca? (pegar/ruta · no)
- ¿Paleta de colores? (códigos hex · ninguno - usar valores predeterminados de MOTION_PHILOSOPHY)
- ¿Tipografías? (nombre(s) de Google Fonts · rutas de archivo · ninguna - usar valores predeterminados Inter + JetBrains Mono)
- ¿Archivo de logotipo? (ruta · ninguno). Si se nombra una marca pero no se da ningún archivo: busca en
assets/brand-logos/, o recupéralo conPOST /api/brand-logos {"name":"..."}- una marca de texto está permitida SOLO después de un404 BRAND_LOGO_NOT_FOUND. Nunca dibujes ni generes un logotipo. - ¿Videos de referencia para el ambiente? (URLs/rutas · ninguno)
- ¿Otros activos? (capturas de pantalla · fotos de producto · metraje B-roll · música - enumera rutas)
- ¿Estética MOTION_PHILOSOPHY (lienzo negro · tipo cromado · cuadrícula de perspectiva · transiciones whip) o una sensación diferente?
- ¿Ritmo? (cinético 1–2s · equilibrado 2–3s · relajado 3–5s)
- ¿Música? (ninguna · pad ambiental 0.15 · cama musical 0.4 · completa 0.8 - ruta de archivo si la tienen)
- ¿Texto de outro / llamada a la acción?
Nunca impongas una marca al usuario. Recurre a los valores predeterminados de MOTION_PHILOSOPHY solo cuando declinen explícitamente proporcionar un estilo.
Flujo de estilo completo + valores predeterminados de MOTION_PHILOSOPHY: Read: references/style-intake.md
Puerta 4 · Síntesis del resumen (COMPUERTA DURA antes de construir)
- Lee
MOTION_PHILOSOPHY.mdsi existe en la raíz del espacio de trabajo - obligatorio si está presente. Si falta, procede con los valores predeterminados enreferences/style-intake.mdy anota la ausencia en el resumen. - Pregunta dónde viven los proyectos si no es obvio:
- Si existe
video-projects/→ usavideo-projects/<slug>/ - De lo contrario → pregunta al usuario
- Si existe
- Escribe
<carpeta-proyecto>/BRIEF.md:- slug · intención · audiencia · dimensiones · fps · duración
- guión (completo o esquema)
- elección de voz · plan de subtítulos · plan de cámara facial
- perfil de estilo: paleta (hex), tipografías, ruta del logotipo, videos de referencia
- ritmo
- inventario de activos con rutas
- texto de outro / CTA
- Muestra el resumen. ESPERA la aprobación explícita. No continúes a la Puerta 5 sin un claro "sí, constrúyelo".
Puerta 5 · Andamiaje y storyboard
Primero, verifica la delegación
Si el resumen describe un video vertical 9:16 con cámara facial + superposiciones de escena, invoca /short-form-video AHORA y entrega el resumen. Su andamiaje de 4 capas está diseñado específicamente para ese formato.
De lo contrario, continúa:
Andamiaje
mkdir <carpeta-proyecto>- Si existe un proyecto hermano con formato similar, ofrece copiar sus
hyperframes.json+meta.jsoncomo plantilla. De lo contrario, desde dentro de la carpeta:npx hyperframes init - Edita
meta.jsoncon el slug, dimensiones y fps del usuario. - Copia los activos proporcionados en
<carpeta-proyecto>/assets/. - Crea
<carpeta-proyecto>/assets/style-profile.mda partir de la Puerta 3 - fuente única de verdad para paleta/tipografías/logotipo.
Storyboard
Genera <carpeta-proyecto>/STORYBOARD.md usando la plantilla en references/storyboard-template.md. Cada tiempo recibe:
Tiempo N - TÍTULO (inicio–fin, duración) - Concepto en una frase
Elementos visuales: [cada elemento, tamaño, animación, sincronización]
Lenguaje de movimiento: [tipo de movimiento]
Eases utilizados: [3–4 eases GSAP distintos]
Salida: [transición al siguiente tiempo]
Audio: [línea de VO / SFX / capa de música]
Al principio del archivo: una tabla de sincronización con escena · inicio · duración · archivo de composición.
Propón una estructura de regla de tres:
- Acto 1 (gancho) ≈ 20% de la duración
- Acto 2 (cuerpo) ≈ 55%
- Acto 3 (cierre + outro con retención de 4–6 segundos) ≈ 25%
(MOTION_PHILOSOPHY §0 Ley 9, §1.)
Asigna intenciones del usuario → bloques del catálogo: Read: references/catalog-intent-map.md
Puerta: muestra el storyboard + tabla de sincronización. Itera hasta que el usuario apruebe.
Puerta 6 · Construir composiciones
Invoca /hyperframes para las reglas del framework. Esta habilidad posee el andamiaje y la disciplina; /hyperframes hace cumplir las reglas.
Andamiaje de cada subcomposición
<div data-composition-id="scene-name" data-start="..." data-duration="...">
<style>[data-composition-id="scene-name"] { /* con ámbito */ }</style>
<!-- DOM -->
<script>
(function(){
const SLOT_DURATION = ...;
const tl = gsap.timeline({ paused: true });
// ... interpolaciones ...
tl.to({}, { duration: SLOT_DURATION }, 0); // ancla - MOTION_PHILOSOPHY Ley 11
window.__timelines["scene-name"] = tl;
})();
</script>
</div>
Plantilla completa + patrón de subtítulos + patrón de fondo ambiental: Read: references/composition-scaffold.md
Reglas de construcción
- Fondo ambiental en
data-track-index="0"durante toda la duración de la composición. - Aperturas con tipo cinético: escalonamiento por palabra 0.06–0.10s.
- Subtítulos como hermanos a nivel de cuerpo de la composición raíz en
index.html, cada uno condata-track-index ≥ 20. Nunca dentro de las líneas de tiempo de la escena (MOTION_PHILOSOPHY §3.13). - Bloques del catálogo instalados mediante
npx hyperframes add <nombre>.Inmediatamente delimita el CSS del bloque a[data-composition-id="..."]- los bloques del catálogo vienen con reglashtml, body { ... }que se filtran al documento padre cuando se cargan como subcomposiciones. - Vertical + cámara facial: envuelve el rostro nativo de 1920×1080 en una transformación (
translate+scale) para el modo de mitad inferior o pantalla completa. (Si terminas aquí en lugar de/short-form-video, considera seriamente la delegación.) - Aplica SOLO lo que el usuario proporcionó. Su paleta, sus tipografías, su logotipo. No inyectes nada más. Si eligieron los valores predeterminados de MOTION_PHILOSOPHY, extrae la paleta + el par de tipografías de
references/style-intake.md.
Determinismo
Sin Math.random(), sin Date.now(), sin fetch() en tiempo de render. Usa PRNGs con semilla o hashes armónico-seno (MOTION_PHILOSOPHY §3.10).
Puerta 7 · Lint → Vista previa en Studio (COMPUERTA DE VISTA PREVIA 1 - OBLIGATORIA)
npx hyperframes lint- corrige todos los errores, clasifica advertencias.npx hyperframes previewen segundo plano.- Espera a que aparezca "Studio running" en
http://localhost:3002. - Entrega al usuario la URL más las URLs de composición individuales (
http://localhost:3002/?comp=<id>). Si el proyecto tiene bloques de shader WebGL, empieza con las URLs individuales - la degradación de WebGL por software puede bloquear la composición maestra. - ESPERA un explícito "se ve bien, renderiza un borrador" antes de continuar. El silencio no es aprobación.
La recarga en caliente está activa: las ediciones se muestran en vivo.
Puerta 8 · Render de borrador → Verificación visual → Vista previa MP4 → Final
Render de borrador
npx hyperframes render --quality draft --output renders/<slug>-draft.mp4
Verificación visual (OBLIGATORIA antes de la entrega)
Que el lint pase no significa que el diseño funcione. Extrae fotogramas y míralos.
mkdir -p renders/frames- Para cada momento clave del tiempo Y cada transición:
ffmpeg -y -ss <t> -i renders/<slug>-draft.mp4 -frames:v 1 -q:v 2 renders/frames/t<t>.png - Llama a la herramienta
Readen cada PNG. La herramienta Read carga la imagen en el contexto - no te limites a enumerar nombres de archivo. - Confirma por fotograma: sin rostros recortados, modo de rostro correcto por escena, texto legible y dentro de la paleta, sin desbordamiento, las transiciones aterrizan en las palabras previstas, sin fotogramas en blanco.
- Si algo está mal: corrige → vuelve a renderizar → vuelve a verificar. Nunca entregues un borrador defectuoso.
Vista previa MP4 (COMPUERTA DE VISTA PREVIA 2 - OBLIGATORIA)
npx serve renders -p 8080 -n
NO uses http.server de Python - no admite solicitudes HTTP Range, por lo que la exploración se rompe.
Entrega al usuario http://localhost:8080/<slug>-draft.mp4. ESPERA la aprobación explícita sobre la reproducción y la sincronización de audio.
Render final
npx hyperframes render --quality standard --output renders/<slug>-final.mp4
En el pipeline AI Edit Video, este NO es el final: continúa con la habilidad video-pipeline (QC → ensamblaje final a través de la cola de render → outputs/<id>-v<N>.mp4 → actualiza meta.json → miniatura/publicación). Uso independiente fuera del pipeline: informa la ruta de salida. Listo.
Lista de verificación completa prevuelo y preentrega: Read: references/build-checklist.md
No negociables (soporte de carga - no los suavices)
- NO te saltes la COMPUERTA DE VISTA PREVIA 1 (Studio) ni la COMPUERTA DE VISTA PREVIA 2 (MP4 renderizado). Dos compuertas por construcción, siempre.
- NO afirmes que un render está terminado hasta que se hayan extraído los fotogramas Y se hayan leído mediante la herramienta Read.
- NO construyas en ningún lugar que no sea dentro de una carpeta de proyecto dedicada. Nunca coloques
index.htmlen la raíz del espacio de trabajo. - NO le pidas al usuario activos antes de inventariar su espacio de trabajo.
- NO te saltes la interpolación de ancla
tl.to({}, { duration: SLOT_DURATION }, 0)al final de cada línea de tiempo de subcomposición. MOTION_PHILOSOPHY Ley 11. - NO uses
Math.random()/Date.now()dentro de la lógica de render. Solo hashes con semilla. - NO agregues
class="clip"a las etiquetas<video>. Las rompe. - NO impongas una marca al usuario. Pregunta primero; recurre a los valores predeterminados de MOTION_PHILOSOPHY solo cuando ellos declinen explícitamente.
Referencias
references/interview-questions.md- banco completo de preguntas por Puertareferences/style-intake.md- entrevista de estilo + valores predeterminados de MOTION_PHILOSOPHYreferences/catalog-intent-map.md- "el usuario dice X → instala Y"references/storyboard-template.md- plantilla tiempo por tiempo + ejemplo resueltoreferences/composition-scaffold.md- estilos con ámbito + boilerplate GSAP IIFEreferences/build-checklist.md- compuertas prevuelo y preentrega
Externas (a nivel de espacio de trabajo):
MOTION_PHILOSOPHY.md- la única referencia externa que esta habilidad asume que existe. Línea base estética. El respaldo vive enreferences/style-intake.mdsi el archivo falta.
Habilidades relacionadas
/hyperframes- reglas del framework, invocar en la Puerta 6/hyperframes-cli- init · lint · preview · render · transcribe · tts/hyperframes-registry- instalación de bloques del catálogo/gsap- referencia de animación GSAP/short-form-video- delegar en la Puerta 5 para formato vertical 9:16 con cámara facial/website-to-hyperframes- delegar en la Puerta 1 si la entrada inicial es una URL