DIRECTOR DE STORYBOARD
Obligatorio
Un storyboard no es solo una lista de imágenes. Cada escena y tiempo debe declarar: texto/narración, imágenes, posición/diseño, movimiento, sonido y tiempo. Usa la plantilla docs/templates/STORYBOARD_TEMPLATE.md.
Flujo de trabajo
- Fija el brief, el formato vertical 1080×1920, 60 FPS, duración, audiencia, guía de estilo y mensaje principal.
- Divide el guion en frases/tiempos atómicos; asígnales IDs estables (
S01-B01, etc.). No combines frases distintas sin una razón. - Por cada tiempo, escribe el texto exacto de VO, el texto exacto en pantalla, lo que es visible, el sujeto/activo y la acción.
- Define posiciones con coordenadas normalizadas 0..1 (x, y, w, h), ancla, alineación, capa/z-order, área segura y dirección de lectura. Incluye tamaños/posiciones en píxeles cuando sea necesario.
- Define encuadre, cámara, transiciones, movimiento de entrada/salida, duración, fotograma de inicio/fin y solapamiento.
- Graba el audio: clip de VO, música, ambiente, SFX, fotograma de inicio, duración, ganancia relativa, fundido y pausas/silencio.
- Empareja cada frase de VO con una o más imágenes/tomas que aclaren su significado. Evita imágenes literales repetitivas; usa metáfora cuando funcione mejor.
- Valida continuidad, legibilidad en móvil, área segura, sincronización y que la duración total coincida.
Salida obligatoria por tiempo
- ID, escena, fotograma inicio/fin, duración en fotogramas y segundos.
- ID de frase de VO + texto.
- Texto en pantalla + posición.
- Visual/activo + composición y posición.
- Movimiento/cámara + easing.
- Indicación de audio: tipo, archivo/placeholder, inicio/fin, nivel relativo, fundido.
- Transición de entrada/salida y notas de continuidad.
Reglas
- Todo el texto visible debe escribirse textualmente, no "agregar un título".
- Todas las posiciones deben ser explícitas, no "aproximadamente en el medio".
- Todo el sonido debe registrarse, incluyendo la decisión de no tener sonido/silencio.
- No inventes activos que aún no existan; márcalos como
PLACEHOLDERy enumera los requisitos del activo. - Duración del tiempo a 60 FPS:
durationInFrames = endFrame - startFramecon límite final exclusivo. - Un logotipo de cierre + CTA es obligatorio y debe ser específico del video, no genérico.
Convenciones de ID y tiempo
- ID del tiempo:
S<escena>-B<tiempo>con dos dígitos (S01-B01). Los IDs no cambian cuando un tiempo se mueve; un tiempo insertado obtiene un nuevo ID (S02-B03) en lugar de renumerar todo. - Intervalo semiabierto
[startFrame, endFrame): el fotogramaendFrameya pertenece al siguiente tiempo. - Convierte de segundos solo una vez, en un solo lugar:
frame = round(seconds × fps). Después, cada número en el storyboard es un fotograma entero. - Los tiempos consecutivos deben ser contiguos: el
endFramedel tiempo N = elstartFramedel tiempo N+1. El solapamiento solo está permitido para ventanas de transición registradas en la columna Transición. - Total: el
endFramedel último tiempo =durationInFramesde la composición.
Formato de salida
- Encabezado: ID del proyecto, lienzo, FPS, duración (segundos + fotogramas), rutas a la guía de estilo y al plan de audio.
- Tabla de tiempos siguiendo
docs/templates/STORYBOARD_TEMPLATE.md. - Notas por tiempo para tiempos complejos (movimiento multi-etapa, personajes, 3D).
- Mapa frase-a-toma cuando hay VO, o una sola línea "no aplica — sin VO".
- Hoja de indicaciones de audio, incluyendo silencio intencional.
- Especificación de la tarjeta de cierre personalizada.
- Lista de activos
PLACEHOLDERcon requisitos y estado de licencia.
Lista de verificación QA
- Cada tiempo tiene un ID, fotograma inicio/fin, texto textual (o "—"), visual, posición normalizada, movimiento, sonido y transición.
- Los tiempos son contiguos desde el fotograma 0; la suma de duraciones =
durationInFrames. - El texto importante está dentro del área segura y se lee en una pantalla de teléfono (tamaño, contraste, tiempo en pantalla).
- El texto permanece en pantalla el tiempo suficiente para ser leído; las frases largas se dividen o se les da más tiempo.
- Cada frase de VO tiene una toma emparejada; cada toma tiene un propósito editorial.
- El silencio se escribe explícitamente, no se deja en blanco.
- El movimiento se describe en función del fotograma (desde/hasta, rango de fotogramas, easing), listo para ser traducido por
frame-time-engineering. - La tarjeta de cierre continúa el motivo del video y su CTA es textual.
- Cada activo que aún no existe está marcado como
PLACEHOLDER.
Mini ejemplo
Un tiempo de gancho de texto de 2 segundos:
| ID de tiempo | Fotogramas | VO | Texto en pantalla | Visual | Posición | Movimiento | Sonido | Transición |
|---|---|---|---|---|---|---|---|---|
| S01-B01 | 0–120 | — | ¿Por qué tu video se siente genérico? | Fondo oscuro liso | x .08, y .40, w .84; alineado a la izquierda; z 2 | Cada palabra entra cada 10 fotogramas, deslizamiento hacia arriba 24 px, duración 14 fotogramas, ease-out | Silencio 0–30, SFX-001 whoosh en 30 | corte |
Movimiento listo para codificar: la palabra i comienza en el fotograma i × 10; opacity 0→1 y translateY 24→0 durante [i×10, i×10+14].
Modos de fallo
- "El texto aparece en el medio" → no se puede codificar; escribe x/y/w/h, ancla y alineación.
- Tiempos fuera por un fotograma (
0–119luego120–240) → no se usó la convención exclusiva; cambia todo a semiabierto. - El texto cambió en el código pero no en el storyboard → el storyboard es la fuente de verdad para el texto; actualiza el storyboard primero.
- La duración total no coincide con la composición → recalcula desde la tabla; no lo parchees en el código.
- Imágenes demasiado literales por frase → usa una demostración, diagrama o metáfora; registra el motivo.
- La tarjeta de cierre es un logotipo + "Síguenos" → no es personalizada; construye un puente visual desde el motivo del video.