Anatomía del proyecto

Cómo está estructurada una carpeta de proyecto del Video Toolkit, cómo se invoca con /video, cómo se retoma un proyecto existente y qué plantillas trae.

IA Audiovisual

Cada video que produces con el toolkit vive en su propia carpeta. Esa carpeta tiene una estructura predecible: el guion dividido por escena, la configuración de la marca, los archivos visuales que vas sumando, el audio narrado y el corte final cuando exportas. Entender la anatomía no es obligatorio para producir, pero te ayuda cuando quieres versionar el proyecto en git, compartirlo con tu equipo o retomarlo después de meses.

Esta página cubre solo la parte toolkit-específica: estructura de archivos, comandos y plantillas. La parte editorial (cómo definir el guion, ajustar escenas, describir el contenido) está en Pre-producción.

Crear un proyecto nuevo

Dentro de Claude Code, en la carpeta del toolkit, escribe /video en la conversación. Claude abre el flujo de creación. Si ya tienes proyectos existentes, te muestra una lista para retomar o crear uno nuevo.

También puedes pedirlo en lenguaje natural:

Quiero crear un proyecto nuevo de video para un sprint review

Claude entiende el contexto y te guía. La parte editorial de qué pones dentro (el desglose de escenas, la narración, las duraciones) se trabaja en pre-producción.

Plantillas que trae el toolkit

El toolkit incluye dos plantillas listas para usar. Cada una define un tipo de video con escenas predefinidas que tú llenas con tu contenido.

Plantilla	Cuándo usarla	Escenas típicas
Sprint Review	Videos internos: demos para el equipo, resumen de release, presentación de funciones nuevas	Título, agenda, demos, resumen, créditos
Product Demo	Videos de marketing: lanzamiento de producto, demo pública, video de ventas	Título, problema, solución, demo, datos, llamada a la acción

Si no estás seguro, elige Sprint Review. Es más sencilla y cubre la mayoría de los casos. También puedes crear tus propias plantillas; el flujo está en Crear plantillas.

Estructura de la carpeta de proyecto

Cuando Claude crea un proyecto, genera una carpeta con esta forma general:

mi-proyecto/
  config.json          ← configuración: plantilla, marca asociada, duración total
  scenes/              ← una carpeta por escena
    01-titulo/
      scene.json       ← tipo, duración, datos de la escena
      narracion.txt    ← guion de la voz en off para esta escena
      narracion.wav    ← audio narrado (cuando lo generas)
      assets/          ← imágenes, video propio, capturas
    02-demo/
      ...
  brand/               ← copia local de la marca usada en este video
  output/              ← MP4 final cuando exportas

Cada escena vive en su propia subcarpeta numerada. El guion es texto plano. Los assets visuales son archivos comunes (PNG, MP4, JPG). Esto vuelve al proyecto fácil de versionar en git: los cambios se ven línea por línea en el guion y archivo por archivo en los assets.

El nombre del proyecto importa

Elige un nombre descriptivo. Claude usa el nombre para crear la carpeta y lo muestra cuando listas tus proyectos. "q2-release-busqueda" es mejor que "video-1".

Retomar un proyecto existente

Los proyectos se guardan automáticamente. Si cierras Claude Code y vuelves mañana, tu proyecto está exactamente donde lo dejaste: el guion, las escenas, los assets, el audio que generaste. No hay un "guardar" manual.

Para retomar:

Lista mis proyectos de video y abre el que se llama q2-release-busqueda

Claude lee el config.json del proyecto, te muestra el estado de cada escena (qué tiene material, qué tiene narración, qué falta) y a partir de ahí continúas donde quedaste.

También puedes simplemente escribir /video y elegir el proyecto en la lista que Claude muestra.

Resultado del setup

Con el toolkit instalado y entendiendo cómo se estructura un proyecto, ya puedes pasar al workflow editorial. La pre-producción describe qué poner dentro de cada escena; la producción cubre cómo generar el material visual y de audio; la post-producción cierra con el ensamble y la exportación.

Siguiente paso: Pre-producción.