¿Qué hace multi-video-variants?
Convierte UN máster aprobado en N salidas sin perder el control de qué archivo proviene de qué estado fuente. Gestiona la matriz de variantes, la congelación del máster, las copias de re-diseño, la mezcla compartida, la nomenclatura, la cola de una renderización a la vez, las reglas de supervisión del agente y la puerta del manifiesto. No diseña el máster (eso lo hace el skill de tipo) y no reemplaza la QA por archivo (render-qa-deliver).
Reglas que prevalecen sobre el resto de este archivo
- Máster primero, luego congelado. Los derivados se crean únicamente a partir de un máster que pasó su propia QA completa y se registró con
manifest_check.py freeze. Una corrección necesaria posterior se realiza en el MÁSTER, se registra conchange, se traslada a cada copia en la misma ronda, y cada derivado se vuelve a renderizar y registrar. Está prohibido corregir solo una copia. - Re-diseño, nunca recorte. Cada aspecto es una copia de la fuente del máster (
hf_9x16/,hf_1x1/…) con su propio canvas, zonas seguras, escala de texto, carril de subtítulos, claves de cámara y centrado de rostro. Un recorte o escala FFmpeg de un máster renderizado no es una variante. - Una mezcla. Los re-diseños y las variantes de hook usan el mismo
cues.jsy los mismos bytes deassets/mix.wavy se multiplexan desde ese único archivo; el audio no se reconstruye por variante. Una variante que realmente necesita su propia mezcla (sin música, locución propia, duración recortada) lo declara en el manifiesto con una razón. - Un trabajo pesado a la vez en toda la máquina (render,
check, matte, ASR, Blender) bajorender_lock. El trabajo en paralelo se limita a tareas no pesadas (layout, especificación, lectura de QA). Máximo 4 agentes en paralelo, cada uno con máximo 2 sub-agentes. - "Listo" se calcula, no se afirma. La palabra solo se permite cuando
manifest_check.py checksale con 0. Un tiempo de espera, carpeta vacía, hash faltante,qa: not_runo evidencia faltante esbloqueado/EVIDENCIA_INSUFICIENTE, nuncaaprobado. - No hay acción paga sin
paid-generation-gate; nunca mensajes a otra sesión de Claude; las restricciones de usuario y proyecto anulan este procedimiento. Las zonas seguras, -14 LUFS y los canvases son preajuste de casa v1 (decisión predeterminada Q5), no ley de plataforma.
Entradas -> salidas
Entrada: máster aprobado (hf/, PROMPT.md, DESIGN.md, cues.js, assets/mix.wav) y la matriz de variantes del intake. Salida: final/<nombre>_<plataforma>_<hook>_<aspecto>.mp4 x N, final/manifest.json (finales + manifiesto únicamente), informes de QA por archivo en _work/qa/<aspecto>/<ronda>/, _work/agents/<agente>.progress.md, _work/STATE.md (cola).
Nomenclatura: <nombre>_<plataforma>_<hook>_<aspecto>.mp4, <nombre> un slug ASCII en minúsculas (se permiten guiones bajos), <plataforma> = meta|tiktok|yt|ig|linkedin|x|all, <hook> = master | hookA | hookA-sinmusica | hookA-sinsubs, <aspecto> = 9x16|4x5|1x1|16x9. También se acepta la forma corta por relación <nombre>_<aspecto>.mp4 (plataforma all, hook master, como en el playbook de entrega). Un nombre que el usuario solicitó en el ledger anula la convención y se registra con su id de ledger (record --name-ledger-id).
Procedimiento
| # | Etapa | Hacer | Artefacto |
|---|---|---|---|
| 0 | Matriz en intake | una fila del ledger por archivo: aspecto, plataforma, ruta (orgánico / anuncio / spark), hook, versión (completa, sin música, sin subtítulos, duración), aspecto del máster. Relaciones "quizás" tardías: escribir notas de layout ahora para que una solicitud tardía sea un agente, no una reconstrucción (references/variant-matrix-and-layout.md) | matriz en PROMPT.md <inputs>; lista matrix en el manifiesto |
| 1 | Puerta del máster | máster aprobado, QA de todos los fotogramas de render-qa-deliver aprobada, manifest_check.py freeze <project> --hf hf --matrix ... | src_hash congelado + mix_sha256 |
| 2 | Copias de re-diseño | un agente por aspecto en una COPIA; mismas cues y mezcla; llenar la tabla de layout (qué cambió por elemento, references/variant-matrix-and-layout.md); preflight 0 errores; instantánea de superposición en hook, oferta, tarjeta final (--describe false, máximo 5 marcas de tiempo por llamada) | hf_<aspecto>/, _work/qa/<aspecto>/layout.md |
| 3 | Variantes de hook / versión | hook = sub-composición vinculada a variables en la copia del aspecto, una fila por variante; probar UNA variación primero (las variables por lote no están probadas en un proyecto); multiplexar la mezcla compartida; sin música / sin subtítulos = variantes de mezcla o capa declaradas | rows.json, archivos de variante |
| 4 | Cola | escribir el orden de renderizado en _work/STATE.md (máster, luego cada aspecto, luego variantes); manifest_check.py stamp ANTES de cada render; renders a través de hf_deliver / render_lock run uno a la vez; un propietario de render nunca inicia un segundo trabajo pesado | registro de bloqueo, sellos |
| 5 | Registro | después de cada render: record (hashes, correcciones del máster aplicadas, variante de mezcla, estado de QA, sonoridad medida en el archivo FINAL) | manifest.json |
| 6 | QA por salida | frame_qa, caption_qa --band <top>:1450 (9:16), motion_qa si el layout cambió el movimiento, face_center audit para metraje del hablante, qa delivery; ejes de revisión visual solo 1 (composición/recorte) y 4 (legibilidad); ejes 2-3 heredados a menos que el movimiento haya cambiado | informes + rutas de evidencia |
| 7 | Puerta de listo | manifest_check.py check <project> --json sale con 0; mostrar al usuario la lista de archivos con hash fuente, estado de QA, LUFS/TP; enumerar las brechas honestamente | Informe LISTO |
| 8 | Aprendizaje | líneas del ledger de tiempos por archivo, lecciones para el Bandeja de entrada | _work/timing_ledger.jsonl |
Puertas
Los estados son aprobado | fallido | bloqueado | n/a con una razón. Un tiempo de espera, muestra vacía o entrada faltante es bloqueado, nunca aprobado. Una llamada a herramienta exitosa es evidencia de ejecución; un render visualizado es evidencia de apariencia.
| Puerta | Predicado | Evidencia | Si es falso | Propietario | Revisar cuando |
|---|---|---|---|---|---|
| G1 matriz | cada salida tiene una fila del ledger (aspecto, plataforma, ruta, hook, versión) antes de cualquier compilación | matrix en PROMPT.md y manifiesto | preguntar el eje faltante ahora; no compilar | este skill + video-intake | cualquier nueva solicitud de relación/variante |
| G2 máster congelado | máster pasó QA completa; freeze registrado; ningún derivado iniciado antes | master.src_hash, frozen_utc más antiguo que cualquier sello | detener derivados; congelar | este skill | cualquier cambio en la fuente del máster |
| G3 re-diseño | cada derivado tiene su propio canvas raíz, fila de layout por elemento, zonas seguras de su aspecto; sin render recortado del máster | filas de layout.md + instantáneas de superposición + preflight 0 E | re-diseñar el elemento fallido; no escalar todo el fotograma | el agente del aspecto | cambio de layout del máster, nueva copia |
| G4 activos compartidos | cues.* y assets/mix.wav idénticos al máster en cada copia de re-diseño/hook; las variantes de hook multiplexan, no remezclan | manifest_check.py check: sin M035/M041 | copiar las cues/mezcla del máster; re-renderizar | este skill | cambio de cues o mezcla del máster |
| G5 QA por salida | cada archivo qa: pass con un archivo de evidencia y LUFS -14 +/- 0.5, TP <= -1 en el archivo final (puerta de casa) | ruta qa_evidence, números lufs, tp en el manifiesto | corregir y re-renderizar SOLO ese archivo | render-qa-deliver | cualquier re-render |
| G6 disciplina de trabajo pesado | exactamente un trabajo pesado a la vez; <= 4 agentes, cada uno <= 2 sub-agentes, cada uno con lista de archivos, archivo de salida, fecha límite, archivo de progreso | registro render_lock; mtimos de _work/agents/*.progress.md | poner en cola, detener el trabajo extra (solo su propio árbol de procesos) | este skill | cada lanzamiento de agente |
| G7 manifiesto listo | obsoletos / huérfanos / faltantes / cambiados-después-del-render todos ausentes | manifest_check.py check sale con 0 | enumerar los archivos fallidos al usuario; re-renderizar los obsoletos | manifest_check.py | antes de decir "listo", después de cualquier cambio |
Números (preajuste de casa v1, con fecha 2026-10-02, detalles en references/house-presets.md)
- Canvases: 9:16 1080x1920, 4:5 1080x1350, 1:1 1080x1080, 16:9 1920x1080; H.264 SDR yuv420p, AAC 48 kHz, 30 fps predeterminado.
- Zonas seguras, texto clave/CTA/logo/precio: 9:16 superior 300 / inferior 672 (y <= 1248) / izquierda 140 / derecha 192, carril de subtítulos inferior <= y 1450; 16:9 x <= 1824, superior 54, inferior 162; 4:5 y 1:1 54 px cada lado. No verificado en dispositivos: ejecutar el ejercicio de superposición.
- Sonoridad: -14 LUFS integrado +/- 0.5, pico verdadero <= -1 dBTP, medido en el archivo final; TP intermedio de mezcla <= -1.5.
- Supervisión: verificación de latido cada 15 min aproximadamente; silencioso o pasado su plazo por 20 min = revisar, reemplazar o detener; línea de estado al usuario cada 10 min de silencio aproximadamente; tiempo de espera de render 3 x el ETA medido. (fuente: flujo de trabajo destilado 02 §13.6, 2026-10-01)
Reglas de decisión
| Si | Entonces |
|---|---|
| se necesita una corrección del máster después de que existan derivados | corregir el MÁSTER, change, llevar el parche a cada copia, re-renderizar y registrar todos |
| una copia necesita sincronización o cues diferentes | eso es un cambio del máster; o una nueva edición (recut) con sus propias líneas de ledger, nunca una bifurcación silenciosa |
| un hook necesita una línea hablada diferente | declarar own-vo con una razón; cada otra variante permanece en la mezcla compartida |
| se solicita una relación tarde | escribir la tabla de layout, lanzar UN agente en una copia del máster congelado; no tocar el máster |
| se solicitan dos renders a la vez | ponerlos en cola; el bloqueo decide; escribir el orden en STATE.md |
| un agente está silencioso pasado su plazo | revisar su archivo de progreso, luego reemplazarlo o detenerlo (solo su propio árbol de procesos), luego render_lock status |
| la carpeta de finales contiene un render antiguo | moverlo a _work/delivered/v<N>/; "listo" está bloqueado hasta que la carpeta coincida con el manifiesto |
| el usuario nombra los archivos | su nombre gana; registrarlo con --name-ledger-id y mantener los campos plataforma/hook/aspecto explícitos |
Estados bloqueados (reportarlos, no sortearlos)
manifest_check.py BLOQUEADO o EVIDENCIA_INSUFICIENTE; un derivado con un from_master obsoleto o una corrección del máster faltante; una fuente cambiada-después-del-render; desviación de cues o mezcla compartida; qa no aprobado; una variante prometida faltante; un archivo no planificado presente. Decir qué archivo, qué código y la corrección.
Errores comunes que cuestan tiempo real
Solicitud tardía de 16:9 en la entrega (un re-diseño completo, descartado); una corrección del máster de 3.7 s no trasladada al 1:1; un render antiguo dejado junto a los nuevos y nadie lo señaló; un agente derivado que encontró un error del máster y corrigió solo su copia; tres agentes renderizando a la vez (un trabajo paralelo de Blender duplicó un render, de 11.5 a 21.5 min, portátil del propietario); colisiones de nomenclatura entre cortes de Meta y TikTok; una variante de hook que llevaba silenciosamente una mezcla diferente. Una hoja de contactos visualizada de cada aspecto sigue siendo necesaria: los hashes no pueden ver un subtítulo sobre un rostro.
Referencias (cargar cuando)
references/variant-matrix-and-layout.md- escribir la matriz, re-diseñar un aspecto, variantes de hook/sin música/sin subtítulos/duración.references/manifest-schema.md- registrar archivos, leer los hallazgos demanifest_check.py, el ciclo de vida de derivados obsoletos.references/parallel-and-agents.md- lanzar agentes, cola, bloqueo, latidos, detención, presupuesto de tokens.references/house-presets.md- antes de citar cualquier canvas, zona segura, sonoridad o número de plataforma (módulo con fecha).agent-content/references/platform-specs.md(hechos canónicos de plataforma, propiedad de otro) yagent-content/playbooks/wf-08-deliver.md(playbook de entrega: nomenclatura, reglas del manifiesto) - preajustes de exportación y el playbook; si un número difiere, el archivo canónico gana yreferences/house-presets.mdse actualiza.- Otros skills:
render-qa-deliver(QA por archivo),hebrew-captions-asr(carril de subtítulos),edit-ad-promo(ranking de hooks),revision-round(notas entre aspectos),paid-generation-gate. - Scripts:
scripts/manifest_check.py(--self-check29 casos, salida 0 LISTO / 1 BLOQUEADO / 2 EVIDENCIA_INSUFICIENTE) yscripts/test_manifest_check.py(prueba unitaria).