Flujo de cortometrajes cinematográficos
Cree un dossier de producción revisable a partir de una idea o guion. Esta habilidad planifica y valida; no autoriza la generación de imágenes, audio, modelos 3D, renders ni vídeo. Solo pregunte cuando una decisión creativa o técnica importante no pueda inferirse. Respete la autorización explícita de producción y las instrucciones del proyecto destino.
Flujo y puertas de aprobación
| Etapa | Entrada | Salida revisable | Aprobación para avanzar |
|---|---|---|---|
| Encargo | Idea, guion o petición | Brief con audiencia, formato, duración, idioma, tono, restricciones y entregables; incógnitas señaladas | Requisitos esenciales completos; hechos y restricciones comprendidos |
| Historia | Brief aprobado | Logline, objetivo, obstáculo, riesgo, beats, giro y cierre | Relación causa/efecto legible; hechos separados de ficción; sin decisión narrativa bloqueante |
| Estética y recursos | Historia aprobada | Hoja de estilo, criterios de personajes/entornos y lista de recursos candidatos | Estilo coherente; cada recurso usado tiene fuente/licencia/formato/rig verificados o queda marcado como pendiente y fuera del plan aprobado |
| Storyboard | Historia y dirección aprobadas | JSON por plano; bloques opcionales cinematography y animation describen cámara/luz y actuación por beats | Validador pasa; intención de foco/corte y beats/continuidad revisada. Still 9:16 y secuencia tienen puertas separadas; rig sin verificar no queda aprobado para producción |
| Plan técnico | Storyboard aprobado | Motor y versiones, recursos/licencias, animación, voz/subtítulos, perfil y coste/limitaciones previstos | Ruta local viable; dependencias y medidas de recursos explícitas; sin incertidumbre crítica oculta |
| Control de calidad | Paquete anterior completo | Rúbrica con evidencia, resultados automáticos, revisión visual y evaluación humana separadas | Todos los fallos corregidos o aceptados expresamente; bloqueos listados; no afirmar checks sin ejecutarlos |
No salte una puerta fallida. Un plan, vista previa, fotograma, narración o render no autoriza la siguiente etapa de producción.
Para cada storyboard ejecute python scripts/validate-storyboard.py ruta/al/storyboard.json. validate-skill.py también valida estructura y cronología de todos los examples/**/storyboard.json y templates/storyboard.json, reutilizando el validador de storyboard. Para revisar la habilidad completa, ejecute python scripts/validate-skill.py . y python -m unittest discover -s tests -v.
Los proyectos pueden versionar un pipeline.json con pipeline_version: 1, independiente del storyboard. Valide con python scripts/pipeline.py validate ruta/al/pipeline.json; inspeccione el DAG sin ejecutar ni escribir con plan o dry-run; valide un manifiesto existente con validate-manifest pipeline.json run-manifest.json. Consulte references/pipeline-orchestration.md antes de editar ese contrato.
Los captions usan intervalos [start_ms, end_ms): solapamientos rechazados por defecto. Un solapamiento intencional requiere overlap_exception no vacío en el caption que empieza después; documente su motivo.
Para enlazar voz y planos, narrative_timing es opcional en schema_version: 1: etiquete el reloj como estimado o grabado y anote beats, pausas y cortes con anclas referidas a escenas. Con grabación real, use su duración como reloj y vuelva a revisar los captions. Las anclas no demuestran sincronía; no declare alineación palabra a palabra sin evidencia de alineador o revisión manual.
Guarde paquetes nuevos en deliverables/<slug>/ con un brief/plan y storyboard.json. Use un slug estable y conserve los entregables existentes; no mueva ni sobrescriba paquetes anteriores al crear uno nuevo.
Estado de capacidad
Implementado: guías de planificación, contratos opcionales de cinematografía y animación, rúbrica cualitativa, planificador DAG local y validación de contratos de pipeline/manifiesto. pipeline.py plan y dry-run muestran el grafo sin ejecutar etapas ni crear archivos. La validación de storyboard comprueba estructura y tiempos declarados; no valida cámara, actuación, existencia/compatibilidad de rigs ni calidad visual. El validador de manifiestos comprueba estados, huellas y salidas, pero no crea ni reanuda ejecuciones.
Las etapas audiovisuales y sus adaptadores siguen pendientes. No hay generación de medios, motor de render, adaptador de TTS, composición, QA audiovisual temporal ni escáner legal. Los resultados de benchmarking, disponibilidad de activos, licencia, herramientas y compatibilidad se verifican por tarea.
Contexto local
Al trabajar en VideoIA, lea primero AGENTS.md y las instrucciones locales pertinentes. El entorno de referencia conocido es Windows 11, GTX 1650 de 4 GB, 16 GB de RAM, Blender local, Remotion/React/Three.js/R3F, FFmpeg, Kokoro TTS y paquetes de recursos CC0 opcionales. Es contexto, no garantía de que un binario, modelo, paquete, licencia o versión siga instalado. Priorice flujos locales/gratuitos y vistas previas modestas; verifique las versiones activas antes de aplicar patrones del framework.
Reutilice las habilidades instaladas de Remotion en vez de copiar sus manuales. Consulte las guías de buenas prácticas, markup, 3D, subtítulos, Studio o render solo si la tarea lo requiere. El render requiere petición explícita. No instale dependencias, descargue recursos, use servicios de pago, publique ni modifique proyectos ajenos sin autorización.
Use la rúbrica cinematográfica para separar validación automática, inspección de fotogramas fijos y juicio humano. Las imágenes estáticas no prueban calidad temporal de animación.
Recursos
- Narrativa: references/storytelling.md
- Identidad visual: references/art-direction.md
- Diseño de planos: references/cinematography.md
- Personajes, entorno y animación: references/animation-3d.md
- Integración Remotion/R3F: references/remotion-integration.md
- TTS, audio y subtítulos: references/voice-and-captions.md
- Puertas de revisión: references/quality-control.md
- Rúbrica cinematográfica: references/cinematic-quality-rubric.md
- Arquitectura y uso del pipeline: references/pipeline-orchestration.md
- Seguridad y validación reproducible del pipeline: references/pipeline-security.md
- Auditoría de fuentes: docs/sources.md
- Habilidades candidatas: docs/skill-candidates.md
- Hallazgos locales: docs/lessons-learned.md
- Prompts iniciales: docs/prompt-library.md
- Pendientes: docs/roadmap.md
- Descubrimiento local de Codex: docs/codex-discovery.md