HyperFrames — lee esto primero
Comienza aquí para cualquier tarea de HyperFrames — especialmente cuando no haya configuración de agente de proyecto (CLAUDE.md / AGENTS.md / .cursorrules) presente. Mapa de capacidades + enrutador de video a continuación.
Mapa de capacidades — qué habilidad para qué intención
| Quieres… | Ve a |
|---|---|
| Hacer un video (desde una URL, un brief, un tema, un PR de GitHub, metraje existente o un solo elemento para animar) | el enrutador de video abajo (§ Enrutamiento de video) |
| Crear una presentación de diapositivas / presentación / pitch deck — diapositivas discretas, fragmentos, ramificación, puntos interactivos | /slideshow |
Crear/editar una composición HTML — el contrato data-*, clips, pistas, subcomposiciones, variables | /hyperframes-core |
| Animar — reglas de movimiento atómico, planos de escena, transiciones, adaptadores de tiempo de ejecución (GSAP / Lottie / Three.js / Anime.js / CSS / WAAPI / TypeGPU) | /hyperframes-animation |
Dirección creativa — design.md, paletas, tipografía, narración, planificación de ritmos, reacción a audio | /hyperframes-creative |
| Preprocesamiento multimedia — locución TTS, música de fondo, transcripción, eliminación de fondo, subtítulos | /hyperframes-media |
| Bucle de desarrollo CLI — init, lint, validar, inspeccionar, vista previa, renderizar, publicar, diagnosticar | /hyperframes-cli |
Instalar bloques/componentes del registro (hyperframes add) | /hyperframes-registry |
El contrato de creación de composición (cada elemento temporizado necesita
data-start/data-duration/data-track-index; los elementos temporizados necesitanclass="clip"; las líneas de tiempo de GSAP están pausadas y registradas enwindow.__timelines; solo lógica determinista — sinDate.now()/Math.random()/ red) no se duplica aquí — se encuentra en/hyperframes-core. Léelo antes de escribir HTML de composición.
Lo que HyperFrames NO puede hacer — verifica esto primero
HyperFrames crea una composición HTML y la renderiza a MP4 desde código. Ese modelo tiene límites rígidos. Una solicitud que esté más allá de uno de ellos no es una elección de enrutamiento — está fuera del alcance, así que recházala (o apunta a la herramienta correcta) en lugar de intentar un flujo de trabajo. Estos se derivan de la arquitectura, no de una solicitud individual:
- El renderizado es determinista y autocontenido. Cada valor, recurso y texto se incluye al momento de la creación; el renderizado no realiza llamadas de red ni obtención de datos en vivo / en tiempo de renderizado (regla central: sin
Date.now()/Math.random()/ red). "Actualizar los números en vivo al renderizar" está fuera del alcance — obtén los datos una vez al crear e inclúyelos, o recházalo. - El video existente se superpone, nunca se edita. HyperFrames compone fotogramas encima de un clip fuente —
/embedded-captionsañade una capa de subtítulos,/graphic-overlaysañade tarjetas gráficas diseñadas (tercios inferiores, llamadas de datos, títulos) — y el clip se reproduce sin cambios debajo, pero ninguno procesa posteriormente el flujo de video codificado. Cambiar la grabación en sí misma (su temporización, color, encuadre, orden o audio) es edición estilo NLE y está fuera del alcance. - La importación de Remotion es unidireccional.
/remotion-to-hyperframestraduce el código fuente del framework Remotion a HyperFrames. No hay reversa (HyperFrames → Remotion, o → cualquier otro framework — fuera del alcance), y una fuente de React/animación web que no sea Remotion no tiene fuente de Remotion para traducir — recréala a través de/general-video. - No puede producir entradas que no tiene. Sin grabación de pantalla/sesión, sin captura de cámara, sin generación de avatar con IA de cabeza parlante / sincronización de labios. Si la grabación o el recurso aún no existen, HyperFrames no puede crearlo mágicamente — pide al usuario que lo proporcione (o que use la herramienta de captura adecuada) primero.
Todo lo demás — un video desde una URL, un brief, un tema, un PR, metraje para anotar, o un solo elemento para animar — está dentro del alcance; enrutarlo abajo.
Enrutamiento de video
Esta sección SOLO conoce flujos de trabajo de nivel superior. No carga fases internas de flujos de trabajo, habilidades de dominio (hyperframes-* — ver el mapa de capacidades arriba) o referencias técnicas.
Tabla de decisión
El tipo de ENTRADA (intención) es el eje principal; la longitud de SALIDA es solo un techo, no una puerta. Para una entrada coincidente, los flujos de trabajo especializados manejan cualquier cosa hasta ~3 min — qué flujo de trabajo se elige se decide por la intención (el tipo de entrada, y para texto el tema), no por la longitud. La longitud solo importa en el extremo superior: una pieza genuinamente más larga (un tutorial de 3-5 min, una inmersión profunda de 5 min+) es un registro diferente y se enruta a /general-video. Dentro de la banda de ≤~3 min, un tercer eje divide los dos flujos de trabajo alimentados por texto — el tema: un producto que se está comercializando vs un tema que se está explicando (ver la regla de desambiguación en el paso 3 a continuación).
| Longitud / Entrada | Lanzamiento de producto (URL / brief / guión) | Sitio web general / URL | PR de GitHub / cambio de código | Tema / artículo / notas (sin producto, sin URL) | Video existente (cabeza parlante) † |
|---|---|---|---|---|---|
| ≤ ~3 min | /product-launch-video | /website-to-video | /pr-to-video | /faceless-explainer | /embedded-captions · /graphic-overlays † |
| Tutorial 3-5 min | /general-video | /general-video | /general-video | /general-video | /embedded-captions · /graphic-overlays † |
| Inmersión 5 min+ | /general-video | /general-video | /general-video | /general-video | /embedded-captions · /graphic-overlays † |
| Estático / bucle | /general-video | /general-video | /general-video | /general-video | /general-video |
Cobertura actual: la banda ≤ ~3 min tiene flujos de trabajo dedicados para entradas de lanzamiento de producto / sitio web general / PR de GitHub / tema (una URL se divide por tipo luego por intención — ver paso 3), y la columna de video existente está cubierta en cualquier longitud — por /embedded-captions (subtítulos/leyendas) o /graphic-overlays (superposiciones gráficas diseñadas), divididas por intención (ver paso 2). Cada otra celda es /general-video — el flujo general de creación de composición HTML (agnóstico a entrada y longitud): todo más largo que ~3 min (filas de 3-5 min / 5 min+) y cada formato estático / bucle. El enrutador nunca termina en un callejón sin salida para un video creable; la única respuesta real de "general / ninguno" es una solicitud fuera del propio HyperFrames (por ejemplo, edición estilo NLE de un archivo de video terminado — re-temporización, recoloración, reencuadre, reordenación, audio).
† El metraje existente se divide por intención, no por longitud. Subtítulos/leyendas → /embedded-captions; superposiciones gráficas diseñadas / empaquetado — tercios inferiores, llamadas de datos, tarjetas con título, citas destacadas — → /graphic-overlays. Ambos superponen el clip, que se reproduce sin cambios debajo; ninguno edita la grabación en sí misma.
Cortocircuito de género (precede a la tabla). Un gráfico en movimiento corto (~menos de 10s), sin narración, liderado por diseño — texto cinético, un impacto de estadística/gráfico, un sting de logotipo, un tercio inferior/superposición, o un tuit/titular/destacado de página animado — se enruta a /motion-graphics independientemente de la entrada. Es un género de SALIDA, no un tipo de entrada, por lo que tiene prioridad sobre la tabla de tipos de entrada anterior cuando la solicitud es claramente de movimiento primero sin narración (ver paso 2). Un tratamiento más largo o narrado se enruta por tipo de entrada, o a /general-video.
Migración de una composición existente (caso especial)
La tabla anterior es para crear un video a partir de una entrada. Un flujo de trabajo está fuera de ella: si el usuario solicita explícitamente portar / convertir / migrar una composición existente de Remotion (React) a HyperFrames → /remotion-to-hyperframes. Esto es traducción de código fuente, no creación a partir de entrada, por lo que no tiene celda de ENTRADA × LONGITUD. Enruta aquí SOLO con lenguaje explícito de migración ("porta mi proyecto de Remotion", "convierte esta composición de Remotion", "reescribe esto como HyperFrames") — una mención pasajera de Remotion no es un disparador; por defecto usa la tabla de creación o /hyperframes-core.
Procedimiento de enrutamiento
- Determinar el tipo de ENTRADA + longitud objetivo. El enrutamiento necesita saber de qué trata el video — su tema y entrada. Si el tema en sí mismo no está especificado (por ejemplo, "haz un video sobre nuestra cosa" sin URL, producto nombrado, tema o recurso con el que trabajar), o el tipo de entrada es desconocido, pregunta antes de entrar en cualquier flujo de trabajo — aclara primero; no invoques una habilidad de flujo de trabajo y luego preguntes, ya que comprometerse con un flujo de trabajo es en sí mismo la decisión de enrutamiento. Haz como máximo 2 preguntas aclaratorias:
- "¿Cuál es tu entrada — un producto (URL o brief), un sitio web general / URL, un PR de GitHub / cambio de código, un tema o artículo para explicar, o un video existente de cabeza parlante para subtitular?"
- "¿Longitud objetivo — aproximadamente 3 minutos o menos, o más larga (un tutorial de 3-5 min / inmersión profunda de 5 min+)?"
- Valores por defecto de especificación — indícalos, no preguntes (estos NO afectan la ruta, así que nunca bloquees el enrutamiento por ellos): relación de aspecto 16:9 (el motor también soporta 9:16 vertical — cambia solo si el usuario nombra un destino vertical como TikTok / Reels / Shorts); idioma de narración / subtítulos = el del usuario. Confirma solo si el usuario objeta; el flujo de trabajo elegido reconfirma sus propias especificaciones en su Paso 0.
- Elegir primero por tipo de ENTRADA (intención); la longitud es solo un techo, no una puerta.
- Gráfico en movimiento corto liderado por diseño (cortocircuito de género, precede a la tabla de entrada) — el movimiento en sí mismo es el mensaje: texto cinético, un conteo de estadística/número, un impacto de gráfico, un sting de logotipo, un tercio inferior/superposición, o un tuit/titular/destacado de página animado; típicamente menos de ~10s, sin narración / voz en off →
/motion-graphics. Esto es un género de SALIDA, no un tipo de entrada — cuando la solicitud es claramente una pieza de movimiento rápida, sin narración y liderada por diseño, enruta aquí independientemente de la entrada. Un tratamiento más largo o narrado del mismo material NO es esto (enruta por tipo de entrada, o a/general-video). - Video existente de cabeza parlante (el usuario tiene un clip y quiere añadir algo encima) → divide por intención, en cualquier longitud (el tipo de entrada prevalece sobre la longitud): subtítulos / leyendas (las palabras habladas como texto legible) →
/embedded-captions; superposiciones gráficas diseñadas — tercios inferiores, llamadas de datos, tarjetas de información con título, citas destacadas, una edición empaquetada con gráficos →/graphic-overlays. (Editar la grabación en sí misma — re-temporización, recolorar, reencuadrar, reordenar, audio — es estilo NLE y está fuera del alcance; ver § Lo que HyperFrames NO puede hacer.) - PR de GitHub / cambio de código (un enlace
github.com/<propietario>/<repo>/pull/<N>, una referenciapropietario/repo#N, o "este PR") →/pr-to-video(hasta ~3 min). - De lo contrario (URL de producto / brief / texto de tema): la intención elige el flujo de trabajo a través del paso 3, y maneja cualquier cosa hasta ~3 min — un promocional corto de 15-30 s y un explicador de ~100 s ambos se enrutan por intención, no por longitud. Enruta a
/general-video(la alternativa agnóstica a longitud — ver paso 4) solo cuando el objetivo es claramente más largo que ~3 min (un tutorial de 3-5 min, una inmersión profunda de 5 min+). Nunca fuerces una pieza genuinamente larga en un flujo de trabajo de ≤~3 min — la intención decide dentro de la banda,/general-videocubre el resto.
- Gráfico en movimiento corto liderado por diseño (cortocircuito de género, precede a la tabla de entrada) — el movimiento en sí mismo es el mensaje: texto cinético, un conteo de estadística/número, un impacto de gráfico, un sting de logotipo, un tercio inferior/superposición, o un tuit/titular/destacado de página animado; típicamente menos de ~10s, sin narración / voz en off →
- Desambiguar las entradas de URL / texto de ≤~3 min (la división de intención). Dos divisiones:
- Tipo de URL + intención — una URL ya no gana automáticamente para PLV; su tipo luego intención decide: un enlace de PR de GitHub (
.../pull/<N>,propietario/repo#N, "este PR") →/pr-to-video; de lo contrario, una URL de sitio web se divide por intención — comercialización / lanzamiento / promoción de un producto específico o SaaS →/product-launch-video; un sitio general → video (recorrido del sitio, portafolio / blog / exhibición de página de aterrizaje, un clip social de los propios visuales del sitio, o simplemente "convierte este sitio en un video") →/website-to-video. Ambos hacen crawling con Chrome sin cabeza; las URLs de PR se leen a través degh. Cuando no esté claro si una URL de sitio es un lanzamiento de producto o un video de sitio general, haz una pregunta. - Producto vs tema (texto, sin URL) — la pregunta decisiva es de qué trata el video, no el formato de entrada:
- Un producto / empresa / SaaS / app / sitio web específico que se está comercializando, lanzando o promocionando →
/product-launch-video. - Un concepto / tema / artículo / cómo funciona algo que se está explicando, con ningún producto y ninguna URL →
/faceless-explainer. - Desempates: redacción de "Promocionar / lanzar / vender / nuestro producto" → PLV. "Explicar / enseñar / cómo funciona X / qué es X" sin producto → faceless. El estilo enviado para faceless es siempre
pin-and-paper. - Un sitio nombrado sin una URL pegada sigue siendo PLV. Un guión que menciona un producto o su sitio web ("nuestro sitio es acme.io", "promociona ") se enruta a PLV incluso sin un enlace en el que se pueda hacer clic — PLV puede buscar el sitio en la web y hacer crawling para obtener activos de la marca (a menos que el usuario opte por no hacerlo, → modo de preset sin captura). No pegar la URL no lo convierte en un trabajo faceless / sin captura. La elección de verbatim-vs-reestructuración para un guión proporcionado es interna a PLV y nunca cambia la ruta.
- Señales conflictivas → pregunta, no adivines. Si la fuente proporcionada es el material de marketing del propio producto (su página de aterrizaje, un promocional...)
- Un producto / empresa / SaaS / app / sitio web específico que se está comercializando, lanzando o promocionando →
- Tipo de URL + intención — una URL ya no gana automáticamente para PLV; su tipo luego intención decide: un enlace de PR de GitHub (