video-director-previs
Toma decisiones creativas costosas en la etapa más barata. Este skill es dueño de la preproducción: dirección, historia, guion, storyboard, estilogramas, animática, música, SFX, voz, elección del motor, control de calidad, revisión, versiones y aprobación. Los motores (HyperFrames, video-shotcraft, Remotion, motion-reel, bang-motion, Diffusion Studio) solo construyen lo que el propietario aprobó.
Ejemplo práctico: examples/crumb-previs/ (una app ficticia para dividir cuentas). Su paquete de datos es la película demo en Previs Studio (_shared/previs/studio/films/011-crumb/).
La app nunca cambia por película. Previs Studio es una única aplicación React + TypeScript fija (fuente _shared/previs/app/, ver su README). npm run build allí verifica tipos, empaqueta e incrusta todo en _shared/previs/studio/index.html y _shared/previs/page/index.html (plantilla); añade un destino en scripts/inline.mjs para cada página por película. npm run smoke ejecuta la página construida en Chrome real en escritorio, tableta, teléfono y pantalla completa (capturas de pantalla con --out). Nunca edites a mano el index.html generado.
Lo que obtiene el propietario: Reproducir (reproductor estilo vídeo con pantalla completa real, vista previa al pasar el ratón, tarjeta final; modo de comentarios que nombra la parte más pequeña bajo el puntero, desplazamiento para más grande o más pequeño, arrastrar un cuadro alrededor de varias partes, lápiz y flecha, arrastrar a lo largo de la fila de tomas para un rango de tiempo; carriles de sonido con formas de onda, pulsos, la curva de duck, solo/mute/volumen y SFX arrastrables que se ajustan al pulso), opciones que reproducen su momento en su lugar con sonido, comparación lado a lado, mantener para escuchar el original, Storyboard (tarjetas que reproducen su toma en su lugar, Reproducir todo, opciones por toma, una hoja de tomas), Plan (director jefe, historia, equipo de dirección, aspecto, sonido, activos, producción, comprobaciones, versiones con "pedir deshacer", exportación de especificaciones), una revisión guiada, Preguntar al director, búsqueda ⌘K, deshacer/rehacer, temas claro y oscuro, descripciones emergentes en todos los controles. Las películas llegan solo como paquetes de datos.
Dos hogares, misma app
- Previs Studio (todas las películas):
_shared/previs/studio/. Añadir una película = añadirfilms/<id>/previs.json+films/<id>/audio/...y una fila enfilms.json. Localmente:python3 -m http.server --directory _shared/previs/studio(o la entradaprevis-studioen.claude/launch.json). - Página por película:
projects/NNN/previs/page/contiene una copia del mismoindex.html(título<Producto> Previs),films.jsoncon una fila cuyopathes"",previs.jsonyaudio/. - Como un Artifact de claude.ai (solo Claude): publica la página con
capabilities: {"db": {}, "user": {}, "sample": {}, "comments": {}, "downloads": true}.dbalmacena notas y selecciones,samplealimenta Preguntar al director,commentslleva "Enviar a Claude Code",downloadsla exportación de la especificación. Sin ellos la página sigue funcionando y guarda en el navegador. - Rutas de base de datos: comentarios (solicitudes de cambio ancladas a la película; la colección mantiene el nombre antiguo)
films/<id>/notes(kindframe, region, range, sound, shot, revert o request;target,targets,box,strokes, chipsquick,t/t2,picksyversionen ese momento); selecciones y ajustes de sonidofilms/<id>/state/picks(tweaks:<scene>.<sfx>{dt, db},lane.vo|music|sfx{db},mix.duck{on}); opciones añadidasfilms/<id>/state/custom; aprobaciónfilms/<id>/state/approval; estado de Claudefilms/<id>/state/claude; actividadfilms/<id>/activity; notas (pensamientos libres sobre toda la película: léelos como contexto, nunca como tareas)films/<id>/pad.
Bibliotecas: más de tres opciones bajo demanda
Cada decisión incluye tres opciones de director; D['libraries'] añade más que el revisor (o la pestaña Preguntar) puede incorporar: direction (aspectos: conjuntos de tokens + fonts_url), music (pistas CC0 con bpm, phase, tags, level), motion (ease, spring {f,d} o bezier), pacing, camera, transition, sfx (cada sonido en la película) y voice (voces Fish: dir, durs, texts para otros idiomas, intro, sample). La decisión global voice elige al narrador; una voz resuelve cada línea en <dir><scene>-<A|B|C>.mp3, y una voz con needs y sin dir se reproduce como subtítulos hasta que se graba. Las opciones añadidas viven en la base de datos de la página, se pueden deshacer y van a la especificación aprobada. Construye bibliotecas con examples/crumb-previs/libraries.py como modelo:
- Música: busca Freesound CC0 (
freesound.py search ... --min-dur 20),freesound.py get, luegopython3 _shared/previs/music_lib.py <page>/audio/music/lib <oggs>(extractos de 24 s alineados al pulso, BPM medido); escribe etiquetas y un por qué por pista; filas de ledger en_shared/ASSETS.md. - Voces: elige voces Fish públicas con
search_voices(sin clones de personas reales o personajes), enuméralas envoices/voices.tsv, escribevoices/lines-<lang>.txt, ejecutavoices/make_voices.sh(modelo gratuito), luego verifica tomas con whisper-cli y regenera las que falten palabras. - El director de IA (pestaña Preguntar,
lib/director.ts) también puede diseñar aspectos (verificados por contraste, fuentes de Google permitidas), sensaciones de movimiento y nuevas redacciones de líneas (que necesitan una grabación: archiva una nota de solicitud para Claude Code).
El lado de Claude Code de las notas (haz esto cada ronda)
El propietario envía notas desde la página ("Enviar a Claude Code": un comentario en vivo que despierta una sesión de observación, o un mensaje copiado). Luego:
0. Tira antes de cambiar. Claude en claude.ai puede responder un hilo "Enviar a Claude Code" por sí mismo, editar el archivo de datos y publicar una nueva versión. Antes de construir, lee el previs.json publicado, compáralo con tu construcción local y traslada cualquier cambio a build_previs.py para que la próxima construcción lo mantenga.
- Establece
films/<id>/state/claude {state:"reading"|"working"|"publishing"|"idle", at, message, version, open}para que la página muestre lo que estás haciendo. - Para cada nota abierta:
actualízalaconclaude: {state:"seen"}cuando la leas,{state:"working"}mientras cambias, luegostatus:"done",claude:{state:"done", at, msg}y añade{by:"claude", text, at}areplies(pinif_version). Usastate:"question"(con la pregunta enmsg) cuando necesites al propietario,"wontfix"cuando recomiendes mantenerlo. Las notas conkind:"request"son trabajos de la pestaña Preguntar (grabar una nueva línea, encontrar un sonido);preferapunta a la opción que le gusta al propietario;intent:"question"quiere una respuesta, no un cambio. Cadaates la hora real: tómala dedate -u +%Y-%m-%dT%H:%M:%SZ, nunca una suposición. - Añade líneas a
films/<id>/activity({at, by:"claude", kind:"seen"|"applied"|"published"|"question", text, version}): lo que leíste, lo que cambiaste, lo que publicaste. - Responde en el hilo de comentarios de la página si el propietario usó Enviar a Claude Code, luego resuélvelo.
Reglas
- Un director, sin comités. Recorre tú mismo la lista de verificación de especialista a continuación, en orden. Sin flujos de trabajo ni subagentes a menos que el propietario lo pida (regla de costo).
- Infiere agresivamente; pregunta solo por verdaderos bloqueadores (verdad del producto, un activo faltante, una pregunta de licencia). Nunca un cuestionario largo antes de que el propietario vea algo.
- Tres opciones en cada decisión, por defecto. Dirección, música, sensación de movimiento, ritmo, y por escena: transición, cámara, línea de voz, cada evento SFX. Las opciones deben ser genuinamente diferentes. Marca la elección del director y da a cada opción una oración simple del por qué o la compensación. "Nada" es una opción de SFX válida.
- Verdad del producto. Cada escena está etiquetada como
real_ui,conceptual_ui,conceptual_visualoexternal_footage; cualquier cosa que no sea real muestra una etiqueta en el reproductor. - Las reglas de la casa aún aplican (AGENTS.md, OWNER.md): clichés prohibidos, portadas, dos niveles de texto, foley grabado, la voz predeterminada, licencias. La página solo reproduce audio CC0 o auto-creado; Mixkit (solo render) aparece solo por nombre.
- Escalar. Un clip de 6 s puede ser una tarjeta de dirección, 3 opciones de música y una animática de 6 s. Una película de producto de 40 s recibe el conjunto completo.
- Bloqueos. Una vez que el propietario aprueba, la historia, la copia, el orden, la sincronización y las selecciones están bloqueados. Una nota posterior cambia solo su objetivo; enumera lo que preservaste.
Lista de verificación del especialista (el director cubre cada uno, brevemente)
Historia (gancho a los 2 s, un estado por compás) · guion y líneas de voz (palabras por segundo ≤ 3.4) · ritmo editorial (variar duración de tomas, pausas, no cada corte en el pulso) · dirección artística (3 direcciones como conjuntos de tokens: bg, on-bg, card, on-card, muted, line, paper, on-paper, accent, on-accent, frame, display, ui, mono) · tipografía · referencias (tomar prestado / evitar / dónde se usó; gramática, nunca contenido) · cámara (cada movimiento tiene una razón) · movimiento (propósito, easing, overshoot ≤ 4 % en UI, ninguno en texto) · transiciones (un corte simple es válido) · activos (existente / nuevo / generado / marcador de posición, con licencia) · música (BPM y fase medidos, curva de energía, dónde cae el drop) · SFX (activo, tiempo, disparador, ganancia, por qué) · mezcla (voz lidera, duck 8 dB, impacto más fuerte) · motor (elegido, por qué, alternativa, respaldo) · QA.
Archivos (una carpeta por película)
projects/NNN-name/previs/
build_previs.py # escribe page/previs.json; copia examples/crumb-previs/build_previs.py y edita (escenas = estilograma HTML + tweens de animación)
vo-lines.txt # 3 redacciones por línea, para fish_tts.py
page/index.html # construido por _shared/previs/app (npm run build; añade esta página como destino en scripts/inline.mjs)
page/films.json # [{"id": "NNN-name", "name": "Producto", "path": ""}]
page/previs.json # todo el plan
page/audio/{music,vo,sfx}/
changes.jsonl # registro de cambios solo adjuntar, una operación por línea
approved-video-spec.json # escrito por _shared/previs/freeze_spec.py después de la aprobación
Pasos
- Lee el brief o la solicitud de una línea y la fuente del producto (UI real, tokens, copia). Escribe
BRIEF.mdcon las decisiones inferidas. - Audio (barato, local):
- Pistas: mide tempo y fase mediante ajuste de peine sobre 85–150 BPM en un sobre de onset de baja banda (
AGENTS-tooling.md, "Previs"); corta extractos de 24 s comenzando en un pulso, loudnorm a −18 LUFS:ffmpeg -ss <phase> -t 24 -i bed.wav -af "loudnorm=I=-18:TP=-2,afade=t=out:st=22.5:d=1.5" page/audio/music/A.mp3. - Voz:
python3 _shared/tools/fish_tts.py --lines previs/vo-lines.txt --out-dir previs/vo-wav(modelo gratuito), luego recorta silencios enpage/audio/vo/sN-{A,B,C}.mp3. - Foley: copia vistas previas CC0 de
_guide/prompt-studio/media/foley/o descarga confreesound.py.
- Pistas: mide tempo y fase mediante ajuste de peine sobre 85–150 BPM en un sobre de onset de baja banda (
- Planifica en
build_previs.py(ver el ejemplo para cada campo):project,summary,chief,story(compases → escenas),directors,assets,gates,pipeline,changes,directions(3),global.music|motion|pacing|voice(3 cada uno),engine,references,style_rules,audio_notes,qa,versions,film_css(todos los colores mediante tokens, clases con prefijof-),fonts_url, yscenes[]conhtml,anim(tweens{s, t:[a,b], f, to, e}en x, y, s, sx, sy, r, o, clip, w, blur;{s, set, at, until}alternancias de clase;{s, count:[from,to], t, p, d}contadores;e:'m'sigue la elección de Motion),decisions(tipos de transición cut, push, slide, zoom, iris; cámara{s,x,y,origin}; vo{text, src, dur, at, copy}),sfx(atpuede ser una lista para series),key(el momento fijo del storyboard). Dale a cada elemento que el propietario pueda señalar undata-namesimple ("Total del recibo", "Botón de solicitud"). - Verifica localmente: sirve la carpeta de la página, mira un fotograma de cada escena y uno a mitad de transición, cambia las tres direcciones una vez, confirma que no hay errores en consola. Una pasada, sin bucle.
- Comparte la página (localmente, o como un Artifact de claude.ai con las capacidades anteriores) y añade la película a Previs Studio. Dale al propietario el enlace y un resumen de cinco líneas. Detente para revisión.
- Bucle de revisión (cada ronda es una republicación):
- Lee notas, selecciones y aprobación.
- Para cada nota abierta: cambia solo su objetivo, añade una operación a
changes.jsonl({"v","target","t","change","from","to","reason","preserve":[...]}), luego marca la nota como hecha con una respuesta de una línea (protocolo anterior). Una notarevertpide deshacer un cambio listado. - Aumenta
versionsy añade loschangesde la ronda enbuild_previs.py, vuelve a ejecutarlo, copiaprevis.jsonen la copia de Studio, republica. El reproductor muestra un banner "qué cambió" y el Plan lista cada cambio con una solicitud de Deshacer.
- Aprobación: cuando
state/approvaltengaapproved: true(llevapicks,tweaksycustom), guárdalo, ejecutapython3 _shared/previs/freeze_spec.py projects/NNN-name/previs --approval <file>(resuelve opciones añadidas y la voz, y listaneeds_before_buildcomo líneas no grabadas), escribeSHOTLIST.mda partir de la especificación, luego entrega al skill de motor nombrado en la especificación. El motor construye exactamente la especificación (pulido permitido, decisiones no).
Costo
Solo trabajo en solitario. Una previsión de 20 s son unas pocas horas de una sesión (aproximadamente $30–60 equivalente de API), con Fish en el modelo gratuito y sin renders. El render de producción y sus comprobaciones vienen después de la aprobación.