HyperFrames — léeme primero
Empieza aquí para cualquier tarea de HyperFrames — especialmente sin configuración de agente de proyecto (CLAUDE.md / AGENTS.md / .cursorrules). Mapa de capacidades + enrutador de video a continuación.
Mapa de capacidades — qué skill para qué intención
| Quieres... | Ve a |
|---|---|
| Hacer un video (desde una URL, resumen, tema, PR de GitHub, metraje existente o un solo elemento para animar) | el enrutador de video más abajo (§ Enrutamiento de video) |
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 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 ritmo, audio-reactivo | /hyperframes-creative |
| Preprocesamiento de medios — 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, previsualizar, renderizar, publicar, doctor | /hyperframes-cli |
Instalar bloques / componentes del registro (hyperframes add) | /hyperframes-registry |
El contrato de autoría de composiciones (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í — vive 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 estrictos. Una solicitud que los sobrepase no es una elección de enrutamiento — está fuera de alcance, así que recházala (o señala la herramienta adecuada) en lugar de buscar un flujo de trabajo. Estos límites se derivan de la arquitectura, no de una sola petición:
- El renderizado es determinista y autónomo. Cada valor, recurso y texto se incorpora en el momento de la autoría; el renderizado no hace llamadas de red ni extrae datos en vivo (regla central: sin
Date.now()/Math.random()/ red). "Actualizar los números en vivo al renderizar" está fuera — obtén los datos una vez en el momento de autoría e introdúcelos, o recházalo. - El video existente se superpone, nunca se edita. HyperFrames compone fotogramas sobre un clip fuente —
/embedded-captionsañade una capa de subtítulos,/graphic-overlaysañade tarjetas gráficas diseñadas (inferiores, llamadas de datos, títulos) — y el clip se reproduce sin cambios debajo, pero ninguno de ellos posprocesa el flujo de video codificado. Cambiar el metraje en sí mismo (su tiempo, color, encuadre, orden o audio) es edición al estilo NLE y está fuera de alcance. - La importación desde Remotion es unidireccional.
/remotion-to-hyperframestraduce el código fuente del framework Remotion a HyperFrames. No existe el proceso inverso (HyperFrames → Remotion, o → cualquier otro framework — fuera de alcance), y una fuente React / animación web que no sea Remotion no tiene una fuente Remotion que traducir — recréala mediante/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 avatares con IA de talking-head / lip-sync. Si el metraje o recurso aún no existe, HyperFrames no puede crearlo de la nada — pide al usuario que lo proporcione (o usa la herramienta de captura adecuada) primero.
Todo lo demás — un video desde una URL, un resumen, un tema, un PR, metraje para anotar, o un solo elemento para animar — está dentro del alcance; enrútalo a continuación.
Enrutamiento de video
Esta sección conoce SOLO flujos de trabajo de alto nivel. No carga fases internas de flujos de trabajo, skills de dominio (hyperframes-* — mira el mapa de capacidades arriba), ni referencias técnicas.
Tabla de decisión
El tipo de ENTRADA (intención) es el eje principal; la duración de SALIDA es solo un límite máximo, no una puerta. Para una entrada coincidente, los flujos de trabajo especializados manejan cualquier cosa hasta ~3 min — qué flujo de trabajo eliges se decide por la intención (el tipo de entrada, y para texto la temática), no por la duración. La duración importa solo en el extremo superior: una pieza genuinamente larga (un tutorial de 3-5 min, un análisis profundo 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 — la temática: un producto que se comercializa vs un tema que se explica (mira la regla de desambiguación en el paso 3 a continuación).
| Duración / Entrada | Lanzamiento de producto (URL / resumen / guión) | Sitio web general / URL | PR de GitHub / cambio de código | Tema / artículo / notas (sin producto, sin URL) | Video existente (talking-head) † |
|---|---|---|---|---|---|
| ≤ ~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 † |
| Análisis profundo 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 de ≤ ~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 — mira el paso 3), y la columna de video existente está cubierta a cualquier duración — por /embedded-captions (subtítulos / closed captions) o /graphic-overlays (superposiciones gráficas diseñadas), divididas por intención (mira el paso 2). Cada otra celda es /general-video — el flujo general de autoría de composiciones HTML (independiente de la entrada y la duración): todo lo más largo que ~3 min (las 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 verdadera de "general / ninguno" es una solicitud fuera del propio HyperFrames (por ejemplo, edición al estilo NLE de un archivo de video terminado — re-temporización, recoloreado, reencuadre, reordenación, audio).
† El metraje existente se divide por intención, no por duración. Subtítulos / closed captions → /embedded-captions; superposiciones gráficas diseñadas / empaquetado — inferiores, llamadas de datos, tarjetas tituladas, citas destacadas — → /graphic-overlays. Ambas superponen el clip, que se reproduce sin cambios debajo; ninguna edita el metraje en sí mismo.
Cortocircuito de género (precede a la tabla). Un gráfico en movimiento corto (~menos de 10 s), sin narración, liderado por diseño — texto cinético, una estadística / gráfico impactante, un sting de logotipo, un inferior / superposición, o un tweet / titular / destaque de página capturada 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 petición es claramente de movimiento primero sin narración (mira el paso 2). Un tratamiento más largo o narrado se enruta por tipo de entrada, o /general-video.
Migrar una composición existente (caso especial)
La tabla anterior es para crear un video a partir de una entrada. Un flujo de trabajo queda fuera de ella: si el usuario pide 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 una celda ENTRADA × DURACIÓN. 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
- Determina el tipo de ENTRADA + duración objetivo. El enrutamiento necesita saber de qué trata el video — su temática y entrada. Si la temática en sí no está especificada (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 Skill de flujo de trabajo y luego preguntes, ya que comprometerse con un flujo de trabajo es en sí la decisión de enrutamiento. Haz como máximo 2 preguntas aclaratorias:
- "¿Cuál es tu entrada — un producto (URL o resumen), 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 talking-head para subtitular?"
- "Duración objetivo — ¿unos 3 minutos o menos, o más larga (un tutorial de 3-5 min / un análisis profundo 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); narración / subtítulos idioma = el del usuario. Confirma solo si el usuario objeta; el flujo de trabajo elegido reconfirma sus propios detalles en su Paso 0.
- Elige por tipo de ENTRADA (intención) primero; la duración es solo un límite máximo, 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í es el mensaje: texto cinético, un contador de estadística / número, un gráfico impactante, un sting de logotipo, un inferior / superposición, o un tweet / titular / destaque de página capturada animado; típicamente menos de ~10 s, sin narración / voz en off →
/motion-graphics. Esto es un género de SALIDA, no un tipo de entrada — cuando la petición es claramente una pieza de movimiento rápida, sin narración, 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/general-video). - Video existente de talking-head (el usuario tiene un clip y quiere algo añadido sobre él) → divide por intención, a cualquier duración (el tipo de entrada gana sobre la duración): subtítulos / closed captions (las palabras habladas como texto legible) →
/embedded-captions; superposiciones gráficas diseñadas — inferiores, llamadas de datos, tarjetas de información tituladas, citas destacadas, una edición empaquetada con gráficos →/graphic-overlays. (Editar el metraje en sí mismo — re-temporizar, recolorizar, reencuadrar, reordenar, audio — es estilo NLE y está fuera de alcance; mira § Lo que HyperFrames no puede hacer.) - PR de GitHub / cambio de código (un enlace
github.com/<owner>/<repo>/pull/<N>, una referenciaowner/repo#N, o "este PR") →/pr-to-video(hasta ~3 min). - De lo contrario (URL de producto / resumen / texto de tema): la intención elige el flujo de trabajo mediante el paso 3, y maneja cualquier cosa hasta ~3 min — un corto promocional de 15-30 s y un explicativo de ~100 s se enrutan por intención, no por duración. Enruta a
/general-video(el fallback independiente de la duración — mira el paso 4) solo cuando el objetivo está claramente más allá de ~3 min (un tutorial de 3-5 min, un análisis profundo 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í es el mensaje: texto cinético, un contador de estadística / número, un gráfico impactante, un sting de logotipo, un inferior / superposición, o un tweet / titular / destaque de página capturada animado; típicamente menos de ~10 s, sin narración / voz en off →
- Desambigua las entradas de URL / texto ≤~3 min (la división por intención). Dos divisiones:
- Tipo de URL + intención — una URL ya no gana automáticamente para PLV; su tipo luego la intención decide: un enlace de PR de GitHub (
.../pull/<N>,owner/repo#N, "este PR") →/pr-to-video; de lo contrario, una URL de sitio web se divide por intención — comercializar / lanzar / promocionar un producto o SaaS específico →/product-launch-video; un sitio general → video (tour del sitio, portafolio / blog / escaparate de página de inicio, un clip social de los propios visuales del sitio, o simplemente "convierte este sitio en un video") →/website-to-video. Ambos rastrean con Chrome sin cabeza; las URL de PR se leen mediantegh. 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, sin producto y sin URL →
/faceless-explainer. - Desempates: Redacción "Promociona / lanza / vende / nuestro producto" → PLV. "Explica / enseña / cómo funciona X / qué es X" sin producto → faceless. El estilo entregado 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 cliqueable — PLV puede buscar el sitio en la web y rastrearlo para obtener activos de 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 suministrado es interna a PLV y nunca cambia la ruta.
- Señales contradictorias → pregunta, no adivines. Si la fuente suministrada es el propio marketing de un producto (su página de destino, un blog promocional sobre su plataforma) pero el usuario pide explícitamente eliminar la promoción — un explicador neutral del concepto subyacente, no un anuncio — trátalo como genuinamente ambiguo (¿el video es…) …
- 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 la intención decide: un enlace de PR de GitHub (
[truncado para traducción]