Video general
Antes de confiar en este flujo de trabajo, ejecuta:
npx hyperframes skills update general-video
Un no-op exitoso significa que la skill está actualizada. Informa de un fallo de actualización en lugar de continuar desde la memoria.
1. Aplicar adaptadores de fuentes transversales
- Medios: Para cualquier necesidad de audio, imagen, icono, logo, voz, gradación, LUT, tratamiento/efecto, subtítulo 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 material y los estilos nombrados utilizan../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: colaborativo espera el inicio de sesión o una elección explícita de modo offline; autónomo informa del estado y continúa a través de un proveedor offline disponible. Informa de un bloqueo cuando ningún proveedor offline 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 de
figma.com, ejecuta/figmaprimero. Construye a partir de sus activos exportados, tokens, componentes o fotogramas de guion gráfico. No uses llamadas directas al conector de Figma porque omiten la sanitización de SVG, la procedencia de los 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 existentes del proyecto y 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. No hagas preguntas sobre el brief. |
Sin brief, pero hyperframes.json o STORYBOARD.md existen | Reanuda desde los archivos y las preferencias registradas. Rellena BRIEF.md solo a partir de hechos conocidos. |
| Creación nueva | 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/<project>" --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 que nombra 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 de la skill /media-use instalada 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 <name> y no vuelvas a preguntar.
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: elegir y ejecutar la ruta. companion: co-crear en conversación. |
storyboard | Si el tablero es una superficie de revisión | yes: ejecutar plan y revisión de bocetos. no: construir sin el tablero. |
mode derivado | Cómo se comportan las compuertas de control | Sigue el contrato del brief. Nunca le 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 exponla 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 las secciones aceptadas## Assetsy## Customizationscon 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 de 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 de la disciplina del plan), las transiciones, la identidad de audio — música y marcas de sonido, o silencio deliberado — el material del usuario colocado, y una apertura y cierre diseñados. Di lo que añade cada capa en una línea; marca las caras (tiempo de renderizado, inicio de sesión, facturación) a medida que las nombres. El usuario reduce un tratamiento; nunca debería tener que montar 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 asciende al techo; el contenido nunca crece más allá de lo solicitado (§ 6).
- Entre puntos de control,
../hyperframes/references/capability-menu.mdfunciona de dos maneras. Como la lista de activación: ofrece una capacidad relevante cuando el usuario menciona su entrada o la construcción alcanza su necesidad. Como el canal de actualización de cada pasada: un punto de control 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 del cuerpo de
BRIEF.mdcorrespondiente inmediatamente. Reescribe un campo de frontmatter y registra la preferencia confirmada solo cuando el usuario la cambie explícitamente. - Mantén las mismas compuertas de guion gráfico, validación, vista previa final y aprobación de renderizado. Companion cambia quién dirige, no lo que la calidad requiere.
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 composición HTML o diseño de escena | /hyperframes-core; usa references/determinism-rules.md para su contrato de diseño |
| Cualquier creación no trivial o tratamiento visual | /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 correspondientes |
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 de techo se diseña a partir de estos, no se recuerda |
| Una oferta de capacidad companion, captura, cuadrícula de ritmo, video generativo, mapa, publicación o capacidad entre flujos de trabajo | ../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. Expón el arco del espectador, la estructura, el ritmo y el controlador de duración. Usa un archivo para una escena corta única; usa subcomposiciones para tres o más cortes duros de escena o cualquier escena reutilizada. Lee
/hyperframes-creative→references/story-spine.mdpara arcos narrados,references/beat-direction.mdpara el ritmo, y/hyperframes-core→references/composition-patterns.mdpara la estructura. Para un brief abierto de múltiples escenas, 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 lo hace — 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, unsrc:declarado, 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 del plan de todos modos, pliega la concesión de delegación del subagente (necesaria para que codex ejecute el paso 4) en esa pausa en lugar de detenerse nuevamente más tarde. -
Resolver dependencias. Instala bloques de registro antes del trabajo en paralelo. Prepara los activos del usuario, adopta medios existentes y resuelve solo lo que requiere el brief. Inicia el audio temprano cuando sus tiempos marquen la duración.
-
Construir escenas. Para una pieza corta de una sola escena, implementa la escena en su momento más visible antes de añadir movimiento (el wireframe confirmado, cuando esté presente, es ese estado final y no debe redibujarse), luego anima desde su plano o reglas citadas — lee el cuerpo completo de la receta (
/hyperframes-animation→blueprints/<id>.md,rules/<id>.md) antes de escribir el movimiento.El despacho solo vale la pena a escala. La creación de paquetes y el calentamiento de contextos de trabajador frescos cuesta minutos y tokens reales: un film 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). Distribuye solo cuando el plan supere 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 oleada (una segunda oleada casi duplica la ventana). Al distribuir:
node <SKILL_DIR>/scripts/frame-packets.mjs --project "$PROJECT_DIR" --storyboard "$PROJECT_DIR/STORYBOARD.md"El constructor escribe un paquete acotado por escena en
.hyperframes/frame-packets/(el bloque exacto del guion gráfico de la escena + el cuerpo del plano + cada receta de regla citada, en línea) y_role.md(../hyperframes-core/references/frame-worker-instructions.md– leído en el paquete). Luego el planificador lanza una oleada única:node <SKILL_DIR>/scripts/dispatcher.mjs --project "$PROJECT_DIR" --packets .hyperframes/frame-packets. -
Validar la composición. Después de la composición, lee
/hyperframes-core→references/composition-validation.mdy ejecuta todas las comprobaciones. Vuelve al paso 1 o 4 para escenas fallidas; no hagas correcciones improvisadas. -
Renderizar. Para renderizar, el flujo de trabajo sigue su contrato de renderizado estándar y las solicitudes del usuario.
6. Contrato de contenido
El contenido de la composición nunca supera lo solicitado en el brief. Las mejoras de tratamiento y producción son elecciones de artesanía dentro de ese alcance, no hinchazón.
7. Contrato de compuerta
flow: companion mantiene las mismas compuertas de revisión: aprobación de guion gráfico, validación, vista previa final y aprobación de renderizado. No se salta ninguna compuerta. No se degradan contratos de calidad.