general-video — creación de composiciones generales
Confirma la ruta antes de construir. Esta es la alternativa para la creación de composiciones personalizadas. Si la entrada se ajusta claramente a un flujo de trabajo especializado, préfierelo: producto comercializado →
/product-launch-video; sitio web general →/website-to-video; explicador de temas →/faceless-explainer; PR de GitHub →/pr-to-video; material existente →/embedded-captions·/graphic-overlays; gráfico en movimiento corto sin narración →/motion-graphics; puerto de Remotion →/remotion-to-hyperframes. Fuera del alcance: datos en vivo / en tiempo de renderizado, edición estilo NLE de un video terminado, o producir material que HyperFrames no pueda capturar. ¿No estás seguro? Lee/hyperframesprimero.
Construye exactamente lo que se pidió. Una tarjeta de título es una tarjeta de título, no una tarjeta de título + tres escenas de apoyo + música ambiental + subtítulos. Si escenas o elementos adicionales mejoraran genuinamente la pieza, propónlos; no los añadas en silencio. Para ediciones pequeñas (corregir un color, ajustar una duración, añadir un elemento), omite los pasos de planificación y ve directamente a la construcción.
Enfoque
Descubrimiento — solo para solicitudes abiertas
Para solicitudes vagas y exploratorias ("haz algo para nuestra marca", "una intro genial") — comprende la intención antes de elegir colores:
- Audiencia — ¿quién lo ve? ¿desarrolladores / ejecutivos / consumidores generales?
- Plataforma — ¿dónde se reproduce? ¿red social (15s) / héroe del sitio web / demo de producto / interno?
- Prioridad — ¿qué importa más? calidad del movimiento / precisión del contenido / fidelidad de la marca / velocidad?
- Variaciones — ¿una mejor toma o 2-3 opciones significativamente diferentes (diferente ritmo, energía o estructura, no solo cambios de color)?
Para solicitudes específicas ("añade una tarjeta de título", "arregla el tiempo de la escena 3"), omite el descubrimiento.
Paso 1 — Sistema de diseño → hyperframes-creative
Establece primero la identidad visual. Si el proyecto tiene una especificación de diseño, léela (precedencia frame.md → design.md → DESIGN.md; considérala como la verdad de la marca: colores exactos, fuentes, restricciones).
Si no existe una especificación, DEBES leer AMBOS hyperframes-creative/references/house-style.md Y hyperframes-creative/references/video-composition.md antes de elegir cualquier color o fuente. house-style.md proporciona el "interpretar el prompt / generar contenido real", la lista perezosa predeterminada y la receta de capas; video-composition.md proporciona las reglas de densidad / escala / detalle de primer plano del medio de video (barras de datos, marcas de registro, metadatos monoespaciados, "8-10 elementos, dos que el usuario no pidió") que separan lo "producido" de lo "generado". Leer solo uno es el error más común: video-composition.md es el que los agentes saltan, y es precisamente el que evita resultados planos, centrados y con aspecto de página web. No te inventes una paleta y te saltes estos; cruzar a hyperframes-creative es obligatorio aquí, no una rama opcional. A partir de ahí, también toma un estilo/estado de ánimo con nombre → references/visual-styles.md, o el selector interactivo → references/design-picker.md, según sea necesario. La especificación/estilo define la marca, no las reglas de composición.
Encuentra el ángulo (brief vago, sin especificación): antes de elegir colores, escribe UNA oración: ¿qué evoca este nombre/palabra/tema, y qué mundo visual (metáfora, escenario, instrumento, motivo) lo expresa? Por ejemplo, una herramienta de ciberseguridad → puertas de bóveda / líneas de escaneo perimetral / pestillos de cerradura; una app de meditación → marea, respiración, lento destello de luz. Lee el significado del tema, no solo sus letras; elige un ángulo concreto sobre un rediseño literal. Este es el sustituto económico para la expansión del prompt (Paso 2) en piezas de una sola escena, donde la expansión se omite correctamente — y es la diferencia entre un concepto diseñado y un logotipo genérico sobre un degradado.
Paso 2 — Expansión del prompt → hyperframes-creative
Ejecuta para cada composición de múltiples escenas (omite para piezas de una sola escena y ediciones triviales). Fundamenta la solicitud contra la especificación de diseño + el estilo de la casa en un intermedio consistente que el trabajo posterior lea de la misma manera. Consulta hyperframes-creative/references/prompt-expansion.md.
Paso 3 — Planificación
Antes de escribir HTML, piensa a alto nivel:
- Qué — la experiencia del espectador: arco narrativo, momentos clave, latidos emocionales.
- Estructura — cuántas composiciones, sub-composición vs en línea, qué pistas llevan video / audio / superposiciones / subtítulos. Para la decisión de archivo único monolítico vs modular con sub-composiciones, consulta
hyperframes-core/references/composition-patterns.md§ Dos arquitecturas (regla general: ≥3 cortes de escena duros, o cualquier escena reutilizada → modulariza; una pieza corta de una sola escena permanece en un archivo). - Ritmo — nombra el patrón antes de implementar (por ejemplo,
rápido-rápido-LENTO-SHADER-sostén); consultahyperframes-creative/references/beat-direction.md. - Tiempo — qué clips determinan la duración, dónde caen las transiciones, el ritmo.
- Diseño — construye el estado final primero (ver más abajo).
- Animar — luego añade movimiento a través de
hyperframes-animation.
Diseño antes que animación
Posiciona cada elemento donde se encuentra en su momento más visible — completamente entrado, colocado correctamente, sin salir aún. Escribe eso como HTML + CSS estático primero. Sin GSAP todavía.
Por qué: si posicionas elementos en su estado inicial animado (fuera de pantalla, escalados a 0, opacidad 0) y animas hasta donde crees que aterrizan, estás adivinando el diseño final: las superposiciones permanecen invisibles hasta el renderizado. Construye el estado final primero, ves y corriges problemas de diseño antes de añadir movimiento.
- Identifica el fotograma héroe para cada escena — el momento en que la mayoría de los elementos son visibles simultáneamente. Ese es el diseño que construyes.
- Escribe CSS estático para ese fotograma. El contenedor de contenido debe llenar la escena con relleno (padding), no con desplazamientos absolutos:
.scene-content {
display: flex;
flex-direction: column;
justify-content: center;
width: 100%;
height: 100%;
padding: 120px 160px; /* el padding posiciona el contenido; llena cualquier tamaño de escena */
gap: 24px;
box-sizing: border-box;
}
Nunca uses position: absolute; top: Npx en un contenedor de contenido — se desborda cuando el contenido es más alto que el espacio. Reserva el posicionamiento absoluto para elementos decorativos.
⚠ El
width/height: 100%de arriba solo funciona si cada ancestro tiene una altura definida. La raíz<div data-composition-id>y cualquier envoltorio entre ella y.scene-contentdeben tener tamaño (position: relative; width: 1920px; height: 1080pxen la raíz — consultahyperframes-core→ "La raíz debe tener tamaño"). Si omites esto, el contenedor flex se colapsa a ~0, el contenido se apila en la esquina superior izquierda, y el primer glifo se recorta en x=0 — mientras quelint/inspectaún reportan 0 problemas. Y mantén siempre elpadding(≥80px) en.scene-content: es el margen de seguridad para títulos. Nunca lo reemplaces congapsimple.
- Añade entradas — anima DESDE fuera de pantalla/invisible HASTA la posición CSS con
gsap.from()(en sub-composiciones prefieregsap.fromTo()para que el estado inicial sea explícito; consultahyperframes-core/references/sub-compositions.md). La posición CSS es la verdad fundamental; el tween es el viaje hacia ella. - Las salidas son manejadas por transiciones — según las reglas de transición de escena en
hyperframes-animation/transitions/, solo la escena final anima los elementos hacia fuera; entre escenas, la transición ES la salida.
Espacio compartido a través del tiempo: si el elemento A sale antes de que el elemento B entre en la misma área, ambos aún necesitan posiciones CSS correctas para sus respectivos fotogramas héroe — el orden en la línea de tiempo evita que coexistan, y el paso de diseño detecta superposiciones accidentales. Los brillos/sombras superpuestos y la profundidad de pila z son superposiciones intencionales; el paso consiste en detectar colisiones no intencionales (dos titulares uno encima del otro, contenido saliéndose del fotograma).
Construcción — delega en las habilidades de dominio
Esto mapea la superficie completa de la habilidad (ver la description) a sus referencias — no exhaustiva; cuando una intención no esté listada, enruta a través de hyperframes-creative (apariencia/concepto), hyperframes-animation (movimiento), hyperframes-core (contrato), hyperframes-media (audio/subtítulos). La primera fila es ADITIVA — léela Y tu fila de intención, no una u otra.
| Construyendo… | Lee primero (en orden) |
|---|---|
| SIEMPRE — cada pieza no trivial, además de tu fila de intención | hyperframes-creative/references/house-style.md + references/video-composition.md (también validado en el Paso 1 / HARD-GATE; el detalle de primer plano "producido, no generado") |
| Tipografía cinética / centrada en texto | hyperframes-animation/techniques.md (tipo cinético) + adapters/gsap-easing-and-stagger.md + rules/kinetic-beat-slam.md |
| Tarjeta de título / tercio inferior / superposición / PiP / texto detrás del sujeto | hyperframes-creative/references/composition-patterns.md + (para el fotograma centrado/redimensionado) hyperframes-core → "La raíz debe tener tamaño" |
| Revelación de logotipo / marca | hyperframes-animation/rules/svg-path-draw.md (dibujado) + rules/3d-text-depth-layers.md + rules/scale-swap-transition.md |
| Datos / estadísticas / números | hyperframes-animation/rules/counting-dynamic-scale.md + rules/stat-bars-and-fills.md + hyperframes-creative/references/data-in-motion.md |
| Producto / aplicación / demo de UI | hyperframes-animation/rules/3d-page-scroll.md + rules/cursor-click-ripple.md + rules/press-release-spring.md |
| Audio-reactivo / impulsado por música | hyperframes-creative/references/audio-reactive.md (pre-extraer bandas; mapear al movimiento) |
| Narrado / voz en off / subtítulos / leyendas | hyperframes-media (tts, transcribe, creación de subtítulos) → colocar assets a través de hyperframes-core |
| Múltiples escenas / transiciones | hyperframes-animation/transitions/overview.md luego transitions/catalog.md (no terminas con la visión general — la receta GSAP está en el catálogo) |
| Modular / sub-composiciones | hyperframes-core/references/composition-patterns.md + references/sub-compositions.md |
Lista de verificación de salida → hyperframes-cli
-
npx hyperframes lintynpx hyperframes validatepasan (bloquear en resultados) - adherencia al diseño verificada si existe una especificación (
frame.md/design.md) — lista de verificación enhyperframes-creative/references/design-adherence.md -
npx hyperframes inspectpasa, o cada desbordamiento está marcado intencionalmente - advertencias de contraste abordadas; para trabajo de múltiples escenas, revisa el mapa de animación (
hyperframes-animation/scripts/animation-map.mjs) - entrega la vista previa; renderiza a MP4 solo bajo solicitud explícita
- muestra la vista previa solo en la entrega (es la vista previa estable y final); no la muestres a mitad de la construcción — las instantáneas de la fase de construcción son sin cabeza
No es este flujo de trabajo
- Un producto / empresa / SaaS / sitio web específico que se comercializa, lanza o promociona →
/product-launch-video - Un concepto / tema / artículo / cómo-funciona-X que se explica, sin producto →
/faceless-explainer - Un PR de GitHub / cambio de código →
/pr-to-video - Un video existente de una persona hablando al que añadir subtítulos →
/embedded-captions - Portar una composición Remotion existente →
/remotion-to-hyperframes - Cortar / editar un archivo de video terminado como un NLE → fuera del alcance (HyperFrames compone HTML y medios en una línea de tiempo determinista; no edita material)