Brief del director (paso 10 del curso)
Las películas largas son producciones. Los briefs detrás de las películas nocturnas del curso no describen un video; contratan un
equipo: una logline contra la que verificar cada decisión, referencias, herramientas y presupuesto, una biblia de personajes,
una hoja de ritmo, reglas de texto en pantalla, compuertas, un bucle de crítica y los entregables. Este skill convierte la idea
del usuario en ese brief y ejecuta la producción a través de sus compuertas. Para clips de hasta unos 45 segundos sin capítulos,
usa /motion-studio:motion-reel (el mismo umbral que ese skill usa para pasar una película más larga a este).
Argumentos, mostrados una vez:
Los archivos de este skill residen en ${CLAUDE_SKILL_DIR} (la plantilla del brief es
${CLAUDE_SKILL_DIR}/assets/brief-template.md, assets/brief-template.md).
Costo de este skill
Se ejecuta con esfuerzo max: el razonamiento más profundo y el mayor uso de tokens de cualquier skill de motion-studio. Los errores
de planificación se acumulan durante horas de trabajo autónomo, por lo que el plan es donde ese gasto vale la pena. Establece
expectativas con el usuario antes de comenzar. Puntos de datos reportados del curso: un videoclip nocturno duró unas 12 horas y
usó alrededor del 80% del uso de un plan Max más $75 de crédito de API de imagen/video; un corto pintado a mano de 45 segundos
usó 163 llamadas de modelo, 62.7M de tokens (96% de lecturas de caché), alrededor de $34 a precios de lista de API y unas 6.75
horas. Mantén el resto más barato: los animadores de capítulo se ejecutan con su propio esfuerzo (alto), y las correcciones y
re-renderizados son trabajo de esfuerzo medio. Dile al usuario que baje el esfuerzo de la sesión con /model una vez que el plan
esté aprobado si el presupuesto importa.
1. Recopilar las entradas
Solo la sesión principal puede hacer preguntas al usuario (los subagentes no). Si el usuario dictó un brief largo, analízalo en lugar de volver a preguntar. De lo contrario, pregunta una vez, en un solo mensaje, por lo que falta:
| Entrada | Por qué |
|---|---|
| logline, y lo que el espectador debería sentir al final | cada decisión se verifica contra ella |
| duración, formatos, dónde se publicará | número de capítulos, tiempo de renderizado, áreas seguras |
| referencias (video, fotogramas, biblioteca de imágenes, repositorio previo) | gramática a adoptar, contenido a evitar |
| música: una pista (y su licencia) o "sintetizar" | la cuadrícula de ritmo a la que todo se sincroniza |
| ruta (A por defecto; B solo si mencionan Remotion/HyperFrames; C generar-trazar) y claves de API por nombre de variable | herramientas y gasto |
| presupuesto: uso de modelo, APIs de pago, tiempo real | cuándo dejar de generar |
| modo: PLAN FIRST o GO | si detenerse después del plan |
2. Escribir docs/brief.md
- Si no hay
studio.json, ejecuta/motion-studio:studio-initprimero (establece--duration,--bpm,--formats). - Copia
${CLAUDE_SKILL_DIR}/assets/brief-template.mdadocs/brief.md. Llena la parte A con las respuestas del usuario; mantén la parte B como está. - Actualiza
studio.jsonpara que coincida (título, duración, fps, bpm, formatos, marca,loop). - PLAN FIRST: muestra el brief completo y detente hasta que el usuario lo apruebe. GO: registra cada decisión que tomaste para el
usuario en
docs/decisions.mdy continúa.
3. Compuerta 1: documentos del plan
| Archivo | Contenido | Quién lo escribe |
|---|---|---|
docs/style_guide.md | paleta, tipografía, ritmo, transiciones, textura, looks prohibidos | subagente style-analyst desde referencias (/motion-studio:reference-style), o tú |
docs/STORYBOARD.md | la idea, el reparto, qué lo une, capítulos con tomas y transiciones temporizadas | subagente motion-director, o tú |
docs/shotlist.md | cada toma en la cuadrícula de ritmo (compases), cámara, texto, SFX | motion-director |
| plan de capítulos (en STORYBOARD) | límites de capítulos en tiempos fuertes, propietario por capítulo | tú |
Mide o sintetiza la música antes de temporizar cualquier cosa (/motion-studio:sound-design): los tiempos de capítulo y toma son
valores de grid.bar(n), no suposiciones. Mantén los capítulos de 8 a 30 segundos para que un subagente pueda terminar y revisar
uno en una sesión. El motion-director escribe solo docs/** (el hook de guardia de rol lo impone).
4. Compuerta 2: rig y guía
- Escribe
docs/ANIMATION_GUIDE.mddesde la plantilla endocs/del proyecto antes de que cualquier animador de capítulo comience, para que todos los capítulos codifiquen con el mismo estilo: cómo funciona un capítulo, propiedad, diseño y bandas reservadas, la API compartida, elementos compartidos, reglas de estilo con un presupuesto de tiempo de pintura, y los comandos de verificación exactos. - Construye los elementos compartidos (personaje principal, kit de interfaz de usuario, ayudantes de paleta) tú mismo en
film/scenes/shared_<nombre>.js. Los animadores de capítulo los importan y nunca los editan. Renderiza fotogramas de cada elemento en todos los estados. - Crea un stub para cada capítulo para que la película se renderice de principio a fin mientras los capítulos están en progreso:
// film/scenes/ch03_build.js (stub escrito por la sesión principal; el animador del capítulo reemplaza las tomas)
import { chapter } from '../../lib/timeline.js';
export const BARS = [12, 20]; // rango en compases de docs/STORYBOARD.md (null = hasta el final)
export default function ch03(ctx) {
const FROM = BARS[0] === 0 ? 0 : ctx.grid.bar(BARS[0]);
const TO = BARS[1] == null ? ctx.dur : ctx.grid.bar(BARS[1]);
return chapter({ name: 'ch03_build', from: FROM, to: TO, shots: [], cues: [] }); // sin tomas = tarjeta de marcador
}
- Conecta
film/film.jsuna vez.buildFilmacepta resultados dechapter()dentro descenes, aplana sus escenas y fusiona sus cues. Las capas de toda la película (subtítulos, transiciones de unión) van enoverlays: Scene[]de la fábrica: se pintan después de cada escena, en orden de array, con la misma reglafrom <= t < to(inclusivo al final en el último fotograma de la película), y nunca cuentan como tomas, por lo que las etiquetas de fotogramas, los límites de tomas de crítica y la lista de avance de la vista previa solo muestran tomas de capítulo. El código del capítulo permanece intacto; no envuelvas ni parchees funcionesdrawde capítulos. Arrays anidados,nully resultados dechapter()también se aceptan enoverlays, por lo que un capítulo puede enviar sus propias escenas de superposición. Para apilar escenas ordinarias, asigna a una escena un número delayer(por defecto 0): las escenas se pintan por(layer, from).
import { defineFilm, scene } from '../lib/timeline.js';
import ch01 from './scenes/ch01_hook.js';
import ch02 from './scenes/ch02_problem.js';
import ch03 from './scenes/ch03_build.js';
const CHAPTERS = [ch01, ch02, ch03];
export default defineFilm((ctx) => ({
scenes: CHAPTERS.map((make) => make(ctx)),
overlays: [
scene(0, ctx.dur, 'captions', (g, lt, c) => { /* subtítulos de toda la película: dibujar desde el tiempo de película c.t */ }),
// una escena corta por unión de capítulo que necesita una transición, temporizada desde la cuadrícula
scene(ctx.grid.bar(12) - 0.2, ctx.grid.bar(12) + 0.2, 'seam-ch02-ch03', (g, lt, c) => { /* barrido o destello */ }),
],
cues: (grid) => [{ t: grid.bar(0), type: 'hit' }], // cues a nivel de película; los cues de capítulo se fusionan automáticamente
}));
5. Desplegar los capítulos
Despliega un subagente chapter-animator (motion-studio:chapter-animator) por capítulo, varios en paralelo. Dale a cada uno
un brief con: su archivo (film/scenes/chNN_<nombre>.js), su rango (la exportación BARS en su stub, más el mismo rango en
segundos para los comandos de verificación), su sección de STORYBOARD, y "sigue
docs/ANIMATION_GUIDE.md". El hook de guardia de rol permite que un animador de capítulo escriba solo film/scenes/** (excepto
film/scenes/shared_*, que permanecen de solo lectura para los animadores de capítulo, quienes reportan errores de archivos
compartidos) y out/check/**. Cada uno devuelve un informe: qué construyó, verificar fotogramas, problemas conocidos y errores
que encontró en los archivos compartidos. Tú arreglas los archivos compartidos, vuelves a ejecutar las comprobaciones de toda la
película, y re-briefas a un capítulo cuando su informe muestra un problema.
Los rangos de capítulo son compases, calculados con ctx.grid dentro de la fábrica del capítulo, por lo que los capítulos
consecutivos siempre se encuentran y siguen una pista medida. Los tiempos de toma son segundos absolutos de película tomados de
la cuadrícula (shots: [{ at: grid.bar(13), name: 'assemble', draw }, ...]); cada toma se ejecuta hasta el siguiente at, y
su draw(g, lt, c) recibe lt desde el inicio de la toma. Una toma fuera de su rango de capítulo hace que chapter() lance un
error y la película deje de cargar (por ejemplo, un TO = 4 literal rechaza una toma en grid.bar(1) = 4.003 s una vez que
una pista medida coloca el primer tiempo fuerte en 2.0 s).
6. Compuertas 3 a 8
| Compuerta | Haz | Verifica |
|---|---|---|
| 3 fotogramas | node tools/stills.mjs --shots (un fotograma por toma) | ronda de crítica (/motion-studio:critique-loop) |
| 4 animática | npm run animatic (media escala, 30 fps, sin desenfoque) con la pista real o de marcador | ritmo: cada lectura cae antes del siguiente tiempo fuerte |
| 5 muestra más difícil | node tools/render.mjs --from A --to B --out out/check en los 2 a 4 s más difíciles | node tools/critique.mjs --strip-at <t>; determinismo; sincronía |
| 6 pase completo | sin marcadores restantes (ninguna etiqueta de toma en node tools/stills.mjs --shots termina en /placeholder) | ronda de crítica sobre toda la película |
| 7 pulido y sonido | /motion-studio:sound-design: partitura o ritmos, cues, SFX, voz | métrica de sincronía, eje de sonido |
| 8 final | npm run build | la definición de terminado en brief B6 |
Las películas largas se renderizan en segmentos reanudables: node tools/render.mjs --format all --final --chunk 10 escribe
out/<fmt>/.parts/seg_<a>_<b>.mp4 y salta los segmentos terminados cuando se vuelve a ejecutar tras una interrupción. Ejecuta
los renderizados largos en segundo plano (la herramienta Bash run_in_background, o un archivo de log que sondees) en lugar de
bloquear la sesión, y nunca esperes en primer plano más de unos 2 minutos. Presupuesta unos 20 s de tiempo real por segundo de
película para tres formatos a 60 fps y 4 sub-fotogramas (una película de 2 minutos son unos 40 minutos de renderizado); el
manual de ejecución de /motion-studio:motion-reel tiene el patrón y el tiempo esperado de todos los demás comandos. Un
chapter-animator o cualquier otro subagente no debe regresar mientras un comando que inició todavía se esté ejecutando.
7. Ruta C: generar-trazar (opcional)
Solo cuando el brief selecciona la ruta C y lista las claves (por nombre de variable: FAL_KEY, ELEVENLABS_API_KEY en .env)
y un presupuesto. Los modelos de video dan física, temporización y rostros que son difíciles de codificar a mano; la capa de
código da un aspecto consistente que el usuario posee. Los espectadores ven la capa de código.
- Genera hojas de personajes y tomas base con el servicio elegido por el usuario, siguiendo sus propios docs. Guarda cada
resultado bajo
refs/base/con una fila de manifiesto (servicio, modelo, prompt, semilla, costo, licencia). Detente en el presupuesto. - Extrae fotogramas para estudiar:
node tools/refs.mjs extract refs/base/shot01.mp4 --every 0.1 --out refs/base/shot01. - Redibuja cada toma en código sobre esa temporización (mira los fotogramas, reconstruye el movimiento con resortes y pistas).
El metraje base nunca se carga en tiempo de renderizado desde la red; si una toma compone un fotograma base, cárgalo desde un
archivo local en
setup(). - Verifica la sincronía: fotogramas de la capa de código junto a los fotogramas base en los mismos tiempos, y los cues de audio en la cuadrícula. Vuelve a ejecutar el paso para cualquier toma que se desvíe.
Claves: nunca imprimas, hagas eco, registres o pegues. Las herramientas leen .env por sí mismas; nombra la variable en las
indicaciones y documentos.
8. Definición de terminado e informe
El B6 del brief es el contrato: sonoridad -14 LUFS +-0.5 y <= -1 dBTP en el MP4 entregado, al menos 3 rondas de crítica con
cada eje >= 8 y sin P0 (npm run gate), un re-renderizado da fotogramas idénticos (verificación de determinismo de crítica más
valores iguales de framesDigest de dos renderizados --hash), duración exacta y fotogramas en cada formato, y todos los
entregables presentes (npm run deliver verifica la mayor parte de esto y escribe docs/production.json). Termina con el
informe B7: entregables, puntuaciones por ronda, gasto real, defectos conocidos, qué mejorarías a continuación.
Créditos: el esqueleto del brief sigue el paso 10 del curso; la división rellenar/mantener, PLAN FIRST vs GO y una definición
de terminado siguen un patrón de plantilla pública de @pradeepXkapoor (reformulado); las compuertas de aceptación están
adaptadas de athemeroy/awesome-opus-5-5-videos docs/production-brief.md (CC BY 4.0); el patrón de subagente guía-más-storyboard
fue estudiado en JohnHeibel/PDoomVideo (solo ideas, sin texto reutilizado).
Siguiente: /motion-studio:critique-loop después de cada compuerta desde la 3 en adelante, luego /motion-studio:ship-formats para entregar.