Video general
Antes de confiar en este flujo de trabajo, ejecuta:
npx hyperframes skills update general-video
Un "no-op" exitoso significa que el skill está actualizado. Informa un fallo de actualización en lugar de continuar desde la memoria.
1. Aplicar adaptadores de código cruzado
- Medios: Para cualquier necesidad de audio, imagen, icono, logo, voz, gradación, LUT, tratamiento/efecto, subtítulos u operación multimedia, carga
/media-usey sigue../media-use/references/resolve.md(resolver, adoptar, reutilizar) y../media-use/references/setup-providers.md(proveedores, autenticación). La retroalimentación vaga sobre metraje y los estilos nombrados usan../media-use/references/media-treatments.mdantes de editar; no improvises efectos multimedia compatibles con CSS/SVG/opacidad. Antes de la primera acción autenticada del proveedor, ejecutanpx hyperframes auth statusy transmite su salida textualmente. Si no has iniciado sesión, aplica la compuerta en../hyperframes-core/references/brief-contract.md: el modo colaborativo espera el inicio de sesión o una elección explícita fuera de línea; el modo autónomo indica el estado y continúa a través de un proveedor fuera de línea disponible. Muestra un bloqueador cuando ningún proveedor fuera de línea pueda satisfacer una capacidad requerida. La adopción local por sí sola no requiere una compuerta de autenticación. - Figma: Si alguna entrada es una URL
figma.com, ejecuta/figmaprimero. Construye desde sus activos exportados, tokens, componentes o fotogramas de storyboard. No uses llamadas al conector de Figma en bruto porque omiten la sanitización SVG, la procedencia de medios y la vinculación de tokens de marca.
Estos adaptadores no cambian el flujo de trabajo seleccionado por /hyperframes.
2. Comenzar desde el estado del proyecto
Aplica la primera fila coincidente; no evalúes filas de estado inferiores:
| Estado | Acción |
|---|---|
| Edición específica | Realiza la edición, preserva las decisiones de proyecto existentes, luego vuelve a ejecutar las comprobaciones afectadas. No reabras el descubrimiento. |
BRIEF.md existe | Léelo. Si workflow nombra otro flujo de trabajo y flow no es companion, transfiere la tarea. No hagas preguntas del brief. |
Sin brief, pero hyperframes.json o STORYBOARD.md existen | Reanuda desde los archivos y preferencias registradas. Rellena BRIEF.md solo a partir de hechos conocidos. |
| Creación fresca | Ejecuta /hyperframes y su capa de intención. Regresa aquí solo para workflow: general-video o flow: companion. |
Para un proyecto nuevo, elige un nombre de directorio en kebab-case a partir del brief y crea la estructura antes de escribir el brief:
npx hyperframes init "videos/<proyecto>" --non-interactive --example=blank --skill=general-video
Luego escribe BRIEF.md en la raíz del proyecto usando ../hyperframes-core/references/brief-format.md. En un proyecto existente, la raíz es el directorio que contiene hyperframes.json. Registra solo los campos confirmados respaldados por preferencias nombrados por el formato del brief, usando node <MEDIA_DIR>/scripts/prefs.mjs record --hyperframes <PROJECT_ROOT>; nunca registres valores predeterminados inferidos. Aquí <MEDIA_DIR> es el directorio del skill /media-use instalado y <PROJECT_ROOT> es el directorio que contiene hyperframes.json. Si la capa de intención adoptó una receta, aplícala ahora con node <MEDIA_DIR>/scripts/recipe.mjs use --hyperframes <PROJECT_ROOT> --name <nombre> y no preguntes de nuevo.
3. Interpretar la forma de ejecución
Usa solo los términos canónicos de ../hyperframes-core/references/brief-contract.md:
| Campo | Significado | Efecto |
|---|---|---|
flow | Quién dirige | automation: elige y ejecuta la ruta. companion: co-crea en conversación. |
storyboard | Si el tablero es una superficie de revisión | yes: ejecuta la revisión del plan y del boceto. no: construye sin el tablero. |
mode derivado | Cómo se comportan las compuertas de checkpoint | Sigue el contrato del brief. Nunca pidas al usuario que nombre un modo. |
No inventes sinónimos para estos estados. Una señal continua de "solo constrúyelo" es manejada por la capa de intención y llega como flow: automation, storyboard: no.
- Para
flow: automation, elige la ruta y establécela en una línea en la primera actualización de progreso. - Para una edición específica, realiza la edición sin inventar una nueva ruta.
Flujo companion
Cuando flow: companion:
- Lee
BRIEF.mdy concilia los## Assetsy## Customizationsaceptados con los artefactos del proyecto. Completa el trabajo aceptado que aún esté pendiente; deja el trabajo completado en paz; no ofrezcas una capacidad aceptada nuevamente como si fuera nueva. - Llega como el director, no el contratista. Un usuario que eligió companion eligió participación y calidad; la respuesta honesta es la mejor versión que puedas diseñar, no la más pequeña que puedas defender. El primer plan es el tratamiento techo: el arco narrativo (toma prestada la lente de género más cercana — menú § Lentes de género), la especificación de diseño, el tratamiento de movimiento de cada escena citado por nombre (§ 5 disciplina del plan), las transiciones, la identidad de audio — marcas musicales y de sonido, o silencio deliberado — el material del usuario colocado, y una apertura y cierre diseñados. Di qué añade cada capa en una línea; marca los costosos (tiempo de renderizado, inicio de sesión, facturación) a medida que los nombres. El usuario recorta un tratamiento; nunca debería tener que ensamblar uno aprobación por aprobación.
- El techo pertenece al concepto, no a la caja de herramientas. Cada capa debe servir al mensaje del brief — un tratamiento que vestiría cualquier video de la misma manera es decoración. La artesanía se eleva al techo; el contenido nunca crece más allá de lo solicitado (§ 6).
- Entre checkpoints,
../hyperframes/references/capability-menu.mdfunciona de dos maneras. Como lista de disparadores: ofrece una capacidad relevante cuando el usuario menciona su entrada o la construcción alcanza su necesidad. Como canal de mejora de cada pasada: un checkpoint de plan, boceto o construcción puede llevar una o dos ofertas rastreadas apuntando al material que el usuario está viendo ("la estadística de la escena 3 quiere el tratamiento de contador"). Léelo antes de ofrecer; nunca vuelques el catálogo completo. - Después de que el usuario acepte una capacidad, produce su artefacto y registra la decisión en la sección correspondiente del cuerpo de
BRIEF.mdinmediatamente. Reescribe un campo de frontmatter y registra la preferencia confirmada solo cuando el usuario la cambie explícitamente. - Mantén las mismas compuertas de storyboard, validación, vista previa final y aprobación de renderizado. Companion cambia quién dirige, no lo que exige la calidad.
4. Cargar el conocimiento requerido antes de cada etapa
Estas lecturas son obligatorias cuando su condición coincide:
| Condición | Leer antes de actuar |
|---|---|
| Cualquier HTML de composición o diseño de escena | /hyperframes-core; usa references/determinism-rules.md para su contrato de diseño |
| Cualquier creación o tratamiento visual no trivial | /hyperframes-creative → references/house-style.md y references/video-composition.md |
| Cualquier movimiento, animación o transición de escena | /hyperframes-animation; sigue su enrutamiento a las reglas, adaptadores, planos o referencias de transición coincidentes |
storyboard: yes | ../hyperframes-core/references/storyboard-format.md y ../hyperframes-core/references/review-loop.md |
| Cualquier activo u operación multimedia, incluyendo narración, BGM, SFX, subtítulos, gradación o transformaciones | /media-use; para reproducción y colocación del framework también lee /hyperframes-core → references/variables-and-media.md |
| Ensamblaje de múltiples escenas | ../hyperframes-core/references/production-loop.md |
flow: companion, antes del primer plan | /hyperframes-creative → references/story-spine.md y references/house-style.md; la lente de género más cercana y el ../hyperframes/references/capability-menu.md completo — el tratamiento techo se diseña desde estos, no se recuerda |
| Una oferta de capacidad companion, captura, cuadrícula de ritmo, video generativo, mapa, publicación o capacidad de flujo cruzado | ../hyperframes/references/capability-menu.md |
| Existe una especificación de diseño, antes de la aprobación final | /hyperframes-creative → references/design-adherence.md |
No reemplaces estas lecturas con recuerdos. La divulgación progresiva ahorra contexto solo cuando la referencia coincidente se carga realmente.
5. Ejecutar la composición
Usa este orden de dependencias. Omite una etapa solo cuando su entrada esté ausente.
-
Plan. Indica el arco del espectador, la estructura, el ritmo y el controlador de duración. Usa un archivo para una escena corta simple; usa subcomposiciones para tres o más cortes de escena duros o cualquier escena reutilizada. Lee
/hyperframes-creative→references/story-spine.mdpara arcos narrados,references/beat-direction.mdpara ritmo, y/hyperframes-core→references/composition-patterns.mdpara estructura. Para un brief de múltiples escenas abierto, expande el mensaje a través de/hyperframes-creative→references/prompt-expansion.md. Un plan de múltiples escenas cita la forma de cada escena: un id de plano de/hyperframes-animation→blueprints-index.mdcuando uno encaja, o las reglas nombradas que compone derules-index.mdcuando ninguno encaja — los nombres de movimiento provienen de esos índices, nunca inventados. La verdad de la historia decide qué escenas existen; la cita las viste. Un plan de múltiples escenas también se registra como el artefacto de despacho: un bloque## Frame Npor escena enSTORYBOARD.md—status: outline, una declaraciónsrc:, la cita del plano/reglas, y el texto del ritmo — incluso cuandostoryboard: no. El bloque es la unidad de despacho; el tablero es solo la superficie de revisión. -
Revisar el plan cuando se solicite. Para
storyboard: yes, ejecuta el bucle de revisión compartido sobre esos bloques. Parastoryboard: no, continúa sin abrir el tablero. Cuando ocurra una pausa de plan de todos modos, incluye la concesión de delegación del sub-agente (necesaria para codex en el paso 4 del despacho) en esa pausa en lugar de detenerte nuevamente más tarde. -
Resolver dependencias. Instala los bloques de registro antes del trabajo paralelo. Prepara los activos del usuario, adopta los medios existentes y resuelve solo lo que el brief requiere. Inicia el audio temprano cuando sus tiempos marcan la duración.
-
Construir escenas. Para una pieza corta de una sola escena, implementa la escena en su momento más visible antes de agregar movimiento (el wireframe confirmado, cuando está presente, es ese estado final y no debe redibujarse), luego anima desde su plano o reglas citados — lee el cuerpo completo de la receta (
/hyperframes-animation→blueprints/<id>.md,rules/<id>.md) antes de escribir movimiento.El despacho se amortiza solo a escala. Crear paquetes y calentar contextos de trabajador fresco cuesta minutos y tokens reales: una película de hasta ~6 escenas cortas se construye MÁS RÁPIDO en línea, en este contexto, una escena tras otra (medido: 5 escenas cortas ≈ 9 min en línea vs ≈ 21 min empaquetado). Despliega solo cuando el plan exceda eso — más escenas, o individualmente pesadas — y luego da a cada trabajador 2–3 escenas, no una, y genera todos los trabajadores en una sola ola (una segunda ola casi duplica la ventana). Al despachar:
node <SKILL_DIR>/scripts/frame-packets.mjs --project "$PROJECT_DIR" --storyboard "$PROJECT_DIR/STORYBOARD.md"El constructor escribe un paquete acotado por escena bajo
.hyperframes/frame-packets/(el bloque exacto del storyboard de la escena + el cuerpo del plano + cada receta de regla citada, en línea) y_role.md(../hyperframes-core/references/frame-worker-vars.md). Leerlo antes de iniciar el trabajador. El trabajador sigue el cuerpo del paquete: plano, wireframe (cuando está presente, confirmado sin redibujar), animar desde las reglas citadas o el plano, receta completa leída primero. El inversor luego fusiona los paquetes terminados en.hyperframes/merged-composition.html. -
Ejecutar compuertas de checkpoint. Después de que exista una composición fusionada, ejecuta:
node <MEDIA_DIR>/scripts/prefs.mjs record --hyperframes <PROJECT_ROOT>. Luego<MEDIA_DIR>/scripts/gate.mjs check --hyperframes <PROJECT_ROOT>— la salida literal es la compuerta. Si se detiene, el incumplimiento de la compuerta nombra la acción de reparación y su archivo de referencia; lee la referencia, realiza la reparación y vuelve a ejecutar la compuerta. Las compuertas se ejecutan de nuevo en cada cambio hasta el pase. Establece la variableHF_CHECKPOINT_GATE=stricten el entorno del trabajador para el modo estricto. Lee../hyperframes-core/references/brief-contract.mdpara el comportamiento del modomode— pero el estado inferido deflow/storyboardes correcto; la pregunta del modo debe ser respondida leyendo el contrato, no preguntando al usuario. Después del pase de la compuerta, escribe el estado de la compuerta y el modo enSTORYBOARD.mdcomo un comentario al final:<!-- gate: {mode} passed -->. Luego decide:- No hay renderizado solicitado en BRIEF.md: Detente después del pase del plan. Para estado de automación, esto significa que la construcción está completa y no hay más acciones. Para companion, el siguiente paso es la compuerta de renderizado cuando el usuario lo solicite.
- Renderizado solicitado: Lee
../hyperframes-core/references/variables-and-media.md, luego ejecuta la compuerta de renderizado de producción (../media-use/references/production-render.md) y, opcionalmente, la compuerta de aprobación.
La compuerta de renderizado se ejecuta como:
node <MEDIA_DIR>/scripts/gate.mjs render --hyperframes <PROJECT_ROOT>. Si falla, la acción de reparación nombrada debe realizarse; la compuerta de aprobación sigue dependiendo del flujo.Límite de escenas: El proceso se detiene después de 7 pasadas de construcción (plan → fusión → compuerta). Cada pasada puede construir hasta 3 escenas. Después de 7 pasadas, si quedan escenas, informa al usuario y pide instrucciones. Este límite puede ser aumentado explícitamente por el usuario.
6. Contenido del brief vs. tratamiento
Cada tratamiento visual, elección de cámara, motivo de diseño o decisión de audio debe servir al contenido del brief en lugar de decorarlo. Una elección que podría decorar cualquier proyecto es verosimilitud decorativa, no artesanía. El contenido del brief nunca debe crecer más allá de lo que requiere el mensaje. Si el brief dice "coche en una carretera", una configuración de cámara lenta desde un ángulo bajo que enfatiza la velocidad y la potencia sirve al contenido; un dron CGI que rodea el coche 360° con humo de neumáticos y destellos de lente no lo hace al menos que el brief pida explícitamente un estilo dramático. El techo es la artesanía en el punto correcto para el contenido; la decoración es una violación.
Los incumplimientos de la compuerta de plan que nombran violaciones de la § 6 señalan qué elección decoró el contenido. Elimina esa elección y vuelve a ejecutar.
Límite de palabras del tratamiento: El tratamiento final (especificación de diseño) no debe exceder las 300 palabras. No incluye citas de activos, configuraciones técnicas o listas de escenas en STORYBOARD.md. Una especificación que excede las 300 palabras debe ser podada.
7. Bucle de revisión de storyboard
Cuando se alcanza una compuerta, el bucle tiene dos resultados: Aprobar el pase o Proporcionar comentarios. Los comentarios llegan como solicitudes de cambio — cada uno debe ser mapeado a una o más acciones de reparación: una lectura de referencia o cambio de activo/escena. Realiza cada acción y luego vuelve a ejecutar la compuerta. No se detiene por capricho.
Para el bucle de revisión visual de storyboard, el trabajo está en un fragmento: <SKILL_DIR>/references/sketch.sys.md. Léelo después del primer pase de la compuerta de plan pero antes de la visualización. Produce el sketch como STORYBOARD.md con status: sketch para cada escena.
Previsualización: Cuando la compuerta lo requiere, renderiza en producción. Antes de la previsualización, muestra primero la composición en el navegador para una verificación de cordura visual y de pista. Esto no reemplaza la compuerta; es una comprobación de preparación antes de la previsualización formal.
8. Buenas prácticas
- No edites el nombre del skill o su etiqueta bleed. El nombre fijo es la señal de intención.
- La autenticación siempre se maneja primero. El estado de autenticación debe ser verificado y cualquier configuración de proveedor debe ser aplicada antes de cualquier operación multimedia.
- Escenas cortas y ajuste fino más tarde. No desperdicies tiempo en la disposición final o transiciones pulidas antes del pase del plan. Construye una composición funcional primero.
- Lee primero las referencias. Nunca improvises la sintaxis de composición, la sintaxis de movimiento o los proveedores de medios.
- Límite de iteraciones del plan: El bucle de revisión del plan debe ejecutarse como máximo 3 iteraciones antes de que el plan deba ser bloqueado para el pase. El usuario puede solicitar más iteraciones explícitamente.
(Este documento se traduce en su totalidad. Los archivos de referencia vinculados deben ser cargados por el agente de IA desde la estructura del proyecto.)