Haz un video — La habilidad de principiante a MP4 terminado
Dos fases, ocho puertas secuenciales. Cada puerta produce un artefacto concreto que la siguiente puerta consume. No omitas puertas.
Cuándo usar esta habilidad — y cuándo transferir
Usa esta habilidad cuando:
- El usuario sea nuevo en HyperFrames y esté partiendo de un concepto, guion o esquema.
- Quiera un tutorial completo, no material de referencia del framework.
- Aún no haya decidido el formato.
Transfiere cuando:
- El usuario pegue una URL y quiera un video de ese sitio → invoca
/website-to-hyperframes - El usuario quiera explícitamente un video vertical 9:16 con cámara frontal + superposiciones de escena → ejecuta las Puertas 1–4 aquí, luego invoca
/short-form-videoa partir de la Puerta 5. - El usuario pregunte por reglas del framework, no por un video → invoca
/hyperframes
Las dos fases
- Fase 1 — ENTREVISTA (Puertas 1–4): una sola pasada conversacional para recopilar todo antes de tocar código. Intención, formato, guion, voz, estilo, recursos, ritmo. Sintetiza en un
BRIEF.mdy espera la aprobación explícita. - Fase 2 — CONSTRUCCIÓN (Puertas 5–8): andamio → storyboard → composiciones → lint → vista previa Studio → render 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? (promocional · anuncio social · teaser de lanzamiento · demo de producto · tutorial · explicativo · tarjeta de intro/outro · otro)
- ¿Quién es la audiencia? (respuesta libre)
- ¿Duración objetivo? (corto 10–20 s · promocional 20–45 s · explicativo 45–90 s · 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 IU 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 frontal, planea transferir a /short-form-video en la Puerta 5.
Banco completo de preguntas: Read: references/interview-questions.md
Puerta 2 · Guion y voz
- ¿Fuente del guion? (pegar · esquema → yo redacto · yo grabo · TTS desde texto · sin narración)
- Si es TTS: preferencia de voz. Ofrece opciones desde
npx hyperframes tts --help. También captura el ritmo. - Si es cámara frontal: ruta de grabación · pantalla completa o ubicación en esquina · ¿necesita transcripción? (
npx hyperframes transcribe <archivo> --model small.en --json) - ¿Subtítulos? (desactivados · atractivos · corporativos · karaoke palabra por palabra · mínimos)
Puerta: guion capturado (o redactado), plan de audio capturado, plan de subtítulos capturado.
Puerta 3 · Captura de estilo
Antes de preguntar nada al usuario, inventaría los recursos 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 todo:
- ¿Guía de estilo o documento de marca? (pegar/ruta · no)
- ¿Paleta de colores? (códigos hex · ninguno — usa valores predeterminados de MOTION_PHILOSOPHY)
- ¿Fuentes? (nombre(s) de Google Fonts · rutas de archivo · ninguna — usa valores predeterminados Inter + JetBrains Mono)
- ¿Archivo de logotipo? (ruta · ninguno — usa marca de texto)
- ¿Videos de referencia para el estilo? (URLs/rutas · ninguno)
- ¿Otros recursos? (capturas de pantalla · fotos de producto · material complementario · música — lista de rutas)
- Estética MOTION_PHILOSOPHY (lienzo negro · texto cromado · cuadrícula de perspectiva · transiciones whip) o un estilo diferente?
- ¿Ritmo? (cinético 1–2 s · equilibrado 2–3 s · relajado 3–5 s)
- ¿Música? (ninguna · pad ambiental 0.15 · cama musical 0.4 · completa 0.8 — ruta de archivo si 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 rechacen explícitamente proporcionar un estilo.
Flujo de estilo completo + valores predeterminados de MOTION_PHILOSOPHY: Read: references/style-intake.md
Puerta 4 · Síntesis del brief (PUERTA ESTRICTA antes de construir)
- Lee
MOTION_PHILOSOPHY.mdsi existe en la raíz del workspace — obligatorio si está presente. Si falta, continúa con los valores predeterminados enreferences/style-intake.mdy anota la ausencia en el brief. - Pregunta dónde viven los proyectos si no es obvio:
- Si existe
video-projects/→ usavideo-projects/<slug>/ - En caso contrario → pregunta al usuario
- Si existe
- Escribe
<project-folder>/BRIEF.md:- slug · intención · audiencia · dimensiones · fps · duración
- guion (completo o esquema)
- elección de voz · plan de subtítulos · plan de cámara frontal
- perfil de estilo: paleta (hex), fuentes, logotipo, videos de referencia
- ritmo
- inventario de recursos con rutas
- texto de outro / CTA
- Muestra el brief. ESPERA la aprobación explícita. No continúes a la Puerta 5 sin un "sí, constrúyelo" claro.
Puerta 5 · Andamio y storyboard
Primero, verifica la transferencia
Si el brief describe un video vertical 9:16 con cámara frontal + superposiciones de escena, invoca /short-form-video AHORA y transfiere el brief. Su andamio de 4 capas está diseñado para ese formato.
De lo contrario, continúa:
Andamio
mkdir <project-folder>- Si existe un proyecto hermano con formato similar, ofrece copiar su
hyperframes.json+meta.jsoncomo plantilla. De lo contrario, dentro de la carpeta:npx hyperframes init - Edita
meta.jsoncon el slug, dimensiones y fps del usuario. - Copia los recursos proporcionados en
<project-folder>/assets/. - Crea
<project-folder>/assets/style-profile.mda partir de la Puerta 3 — fuente única de verdad para paleta/fuentes/logotipo.
Storyboard
Genera <project-folder>/STORYBOARD.md usando la plantilla en references/storyboard-template.md. Cada escena obtiene:
Escena N — TÍTULO (inicio–fin, duración) — Concepto en una frase
Elementos visuales: [cada elemento, tamaño, animación, temporización]
Lenguaje de movimiento: [tipo de movimiento]
Eases utilizados: [3–4 eases GSAP distintos]
Salida: [transición a la siguiente escena]
Audio: [línea de VO / SFX / capa de música]
Al inicio del archivo: una tabla de temporización con escena · inicio · duración · archivo de composición.
Propón una estructura de tres actos:
- Acto 1 (gancho) ≈ 20% de la duración
- Acto 2 (cuerpo) ≈ 55%
- Acto 3 (remate + outro con pausa de 4–6 segundos) ≈ 25%
(MOTION_PHILOSOPHY §0 Ley 9, §1.)
Asigna intenciones del usuario a bloques del catálogo: Read: references/catalog-intent-map.md
Puerta: muestra storyboard + tabla de temporización. Itera hasta que el usuario apruebe.
Puerta 6 · Construir composiciones
Invoca /hyperframes para las reglas del framework. Esta habilidad posee el andamio y la disciplina; /hyperframes aplica las reglas.
Andamio 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 });
// ... tweens ...
tl.to({}, { duration: SLOT_DURATION }, 0); // ancla — MOTION_PHILOSOPHY Ley 11
window.__timelines["scene-name"] = tl;
})();
</script>
</div>
Código base completo + 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: escalonado por palabra 0.06–0.10 s.
- 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 las escenas (MOTION_PHILOSOPHY §3.13). - Bloques del catálogo instalados mediante
npx hyperframes add <nombre>.Inmediatamente limita 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 frontal: envuelve el rostro nativo 1920×1080 en una transformación (
translate+scale) para modo mitad inferior o pantalla completa. (Si terminas aquí en lugar de en/short-form-video, considera seriamente la transferencia). - Aplica SOLO lo que el usuario proporcionó. Su paleta, sus fuentes, su logotipo. No inyectes nada más. Si eligieron los valores predeterminados de MOTION_PHILOSOPHY, toma la paleta y el par de fuentes de
references/style-intake.md.
Determinismo
No uses Math.random(), no uses Date.now(), no uses fetch() en tiempo de render. Usa PRNGs con semilla o hashes seno-armónicos (MOTION_PHILOSOPHY §3.10).
Puerta 7 · Lint → Vista previa Studio (PUERTA DE PREVISUALIZACIÓN 1 — OBLIGATORIA)
npx hyperframes lint— corrige todos los errores, clasifica las advertencias.npx hyperframes previewen segundo plano.- Espera a que aparezca "Studio running" en
http://localhost:3002. - Entrega al usuario la URL junto con las URLs de composición individuales (
http://localhost:3002/?comp=<id>). Si el proyecto tiene bloques de sombreado WebGL, comienza con las URLs individuales — la alternativa WebGL por software puede bloquear la composición maestra. - ESPERA un "se ve bien, renderiza un borrador" explícito antes de continuar. El silencio no es aprobación.
La recarga en caliente está activa: las ediciones aparecen en vivo.
Puerta 8 · Render borrador → Verificación visual → Vista previa MP4 → Final
Render borrador
npx hyperframes render --quality draft --output renders/<slug>-draft.mp4
Verificación visual (OBLIGATORIA antes de la entrega)
Que pase el lint no significa que el diseño funcione. Extrae fotogramas y revísalos.
mkdir -p renders/frames- Para cada momento clave de escena 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 solo enumeres 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 (PUERTA DE PREVISUALIZACIÓN 2 — OBLIGATORIA)
npx serve renders -p 8080 -n
NO uses http.server de Python — no admite solicitudes HTTP Range, por lo que la reproducció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
Informa la ruta de salida. Listo.
Lista de verificación completa prevuelo y preentrega: Read: references/build-checklist.md
Innegociables (críticos — no los suavices)
- NO omitas la PUERTA DE PREVISUALIZACIÓN 1 (Studio) ni la PUERTA DE PREVISUALIZACIÓN 2 (MP4 renderizado). Dos puertas por construcción, siempre.
- NO afirmes que un render está listo hasta que los fotogramas se hayan extraído Y leído mediante la herramienta Read.
- NO construyas fuera de una carpeta de proyecto dedicada. Nunca pongas
index.htmlen la raíz del workspace. - NO le pidas recursos al usuario antes de inventariar su workspace.
- NO omitas el tween 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 rechacen 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 escena por escena + ejemplo resueltoreferences/composition-scaffold.md— estilos con ámbito + código base GSAP IIFEreferences/build-checklist.md— compuertas prevuelo y preentrega
Externas (a nivel de workspace):
MOTION_PHILOSOPHY.md— la única referencia externa que esta habilidad asume que existe. Línea base estética. El recurso de respaldo está enreferences/style-intake.mdsi el archivo falta.
Habilidades relacionadas
/hyperframes— reglas del framework, invoca 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— transfiere en la Puerta 5 para formato vertical 9:16 con cámara frontal/website-to-hyperframes— transfiere en la Puerta 1 si la entrada inicial es una URL