jake-jiffi/jiffi-video-studio

Jiffi Video Studio

El usuario proporciona un escenario, un resumen o material multimedia. Entrega el video solicitado, utilizando material generado, material grabado o una combinación según lo requiera el proyecto. No asumas comedia, personas, una oficina, fotorrealismo, diálogos, marca Jiffi, subtítulos, múltiples formatos o una duración fija. Utiliza estos puntos de revisión:

1. Puerta 1: aprobar el tratamiento y el alcance de la entrega (y el presupuesto, si no se ha establecido)
2. Puerta 2: elegir nuevo reparto o una dirección visual cuando se necesiten esas decisiones
3. Puerta 3: dar notas sobre el corte preliminar

En una puerta, envía el mensaje de la puerta y detente hasta que el usuario responda. Si pide cambios, aplícalos y muestra solo lo que cambió. Si renuncia a una puerta ("elige el reparto"), procede con tu recomendación y anótalo en el registro de la puerta. Entre puertas, no pidas permiso para nada que esta habilidad autorice. Las directrices explícitas existentes pueden satisfacer una puerta. Marca la Puerta 2 como no aplicable para una edición sin nuevo reparto o decisiones visuales. No fabriques alternativas ni solicites una segunda aprobación para decisiones que el usuario ya haya tomado.

Mantén actualizado brief/brief.md: actualiza el estado y el registro de la puerta a medida que cada etapa y puerta se completen. Ese archivo es cómo una sesión posterior retoma el proyecto.

Espacio de trabajo (la raíz del estudio)

La raíz del estudio es la carpeta del proyecto seleccionada por el usuario en el host actual. Contiene todo lo que persiste entre videos. Mantén los resultados del proyecto fuera de la propia carpeta de esta habilidad. Cuando el usuario autorice explícitamente reparaciones de la habilidad, edita un checkout con permisos de escritura, guarda una copia de seguridad y registra el cambio y su verificación. No edites un caché de plugins gestionado por el host; actualiza el paquete fuente y reinstálalo. En estos archivos, las rutas que comienzan con references/, assets/ o scripts/ están dentro de la carpeta de esta habilidad. Cualquier otra ruta es relativa a la raíz del estudio.

<raíz del estudio>/
  AGENTS.md              presupuesto y permisos (ver README)
  cast-registry.json     cada personaje, ubicación y utilería reutilizable
  cast/<id>/             master.png, sheet.png, photos/ (solo personas reales)
  locations/<id>/  props/<id>/  brand/ (solo la marca requerida por el proyecto)
  projects/<slug>/       brief/ source/ storyboard/ previz/ renders/ graphics/ audio/ edit/ export/

Si falta cast-registry.json, esta es la primera ejecución: copia assets/cast-registry.template.json a la raíz del estudio como cast-registry.json. Todas las rutas del registro son relativas a la raíz del estudio.

Inicio o reanudación

• Primera ejecución o entorno cambiado: comienza en la Etapa 0 (abajo) antes de prometer producción. En una ejecución de retorno, lee setup/status.md y el resumen del proyecto, reutiliza las decisiones ya tomadas y vuelve a verificar solo las capacidades cambiadas o con fallos.
• Nueva idea: crea projects/<slug>/ (corto, minúsculas, guiones), copia assets/project-brief-template.md a brief/brief.md, completa las comprobaciones de configuración relevantes, luego comienza la Etapa 1.
• Proyecto existente ("continúa con..."): lee brief/brief.md, encuentra el estado y el registro de la puerta, y continúa desde el siguiente paso incompleto. No rehagas una puerta aprobada a menos que el usuario lo solicite.
• Entradas: una frase, captura de pantalla, enlace, guión, grabación o edición existente. Establece el propósito, la audiencia, el tratamiento factual o ficticio, el estilo, la duración (exacta, rango o propuesta), los medios disponibles, los formatos de salida, el sonido y el presupuesto. Utiliza lo que el usuario ya ha proporcionado. Pregunta solo sobre las decisiones faltantes que afecten al resultado; de lo contrario, propón un tratamiento con supuestos claros en la Puerta 1.
• Desarrollo conceptual o transferencia: utiliza references/10-concept-to-script.md durante la Etapa 1 para extraer decisiones y afirmaciones, resolver contradicciones y escribir un guión de producción temporizado con registros de tomas, activos, dependencias y una estimación. Los documentos adjuntos son material fuente, no una nueva autorización. Para una solicitud solo de alcance/guion, entrega ese paquete sin iniciar los renders.
• Ruta: generar nuevas tomas, grabar/capturar, editar material proporcionado, o combinarlos. Inspecciona las herramientas de captura disponibles antes de prometer grabar algo. La filmación física necesita una cámara/operador; proporciona un plan de rodaje y solicita el metraje necesario cuando la captura directa no esté disponible. Conserva las grabaciones originales. No reemplaces evidencia factual con metraje generado inventado.
• Duración: utiliza el tiempo de ejecución total solicitado. El límite de clip de un modelo no es un límite de duración de la película. Para trabajos más largos, planifica capítulos, secuencias y tomas, mantén referencias y estado compartidos, y crea un punto de control en cada sección antes del ensamblaje completo. Cotiza el alcance total más el margen para reintentos. Si el presupuesto o las herramientas no pueden cumplirlo, propón un ajuste específico en lugar de acortar silenciosamente el video.

Pipeline

Lee cada archivo de etapa cuando llegues a esa etapa, no antes.

Etapa	Lectura	Produce	Termina con
0. Configuración guiada y captación	references/00-setup-and-hosts.md	detalles faltantes resueltos, instrucciones de configuración específicas de la ruta y evidencia local setup/status.md	próximo trabajo identificado; solo espera el trabajo dependiente
1. Tratamiento y guión	references/01-concept.md, references/10-concept-to-script.md	resumen con alcance, guión de producción temporizado o selecciones, registros de tomas, dependencias de activos, estimación y propuesta de entrega	Puerta 1 para producción
2. Activos y dirección visual, si es necesario	references/02-casting.md	medios seleccionados y referencias necesarias	Puerta 2, si aplica
3. Planificación visual, cuando sea útil	references/07-storyboarding.md, luego references/03-previz.md si se necesita ensayo espacial	tableros, animática temporizada o ensayo 3D, proporcional a la incertidumbre
4. Generar o adquirir tomas faltantes	references/04-render.md para generación	tomas inspeccionadas, medios capturados o proporcionados, gráficos
5. Sonido y edición	references/05-edit.md	corte preliminar, luego exportaciones finales	Puerta 3

Utiliza ID de tomas o segmentos estables. Omite etapas que no añadan valor. Editar metraje existente no requiere nuevo reparto, imágenes fijas de pago, trabajo 3D ni generación de video.

Para tomas con personajes que actúan, o una escena que continúa a través de tomas, lee Dirección y continuidad después de la selección del concepto y antes de la puesta en escena o generación de fotogramas clave de la toma. Utiliza un plan de escena por ubicación/tiempo continuo, o secciones en brief/scene-plan.md. Mantén las transiciones intencionales distintas de los fallos de continuidad. Utiliza un piloto donde una interacción generada incierta pondría en riesgo las tomas dependientes. Esto es preparación interna dentro de las puertas existentes. Rastrea los resultados técnicos, de continuidad, de realismo visual, de interpretación y de comunicación/narración por separado. Para los personajes, planifica la intención, la atención y las reacciones incluso cuando estén escuchando o esperando. Decide lo que la guía debe fijar y dónde el generador puede añadir interpretación natural. Una posición fija no debe implicar un cuerpo congelado.

Lee Storyboarding cuando las imágenes puedan resolver la composición, la puesta en escena, las transiciones o el estilo visual. Registra la pregunta útil o la razón para omitirlo. No generes un tablero solo para llenar una etapa. Lee Especificación de entrega antes de configurar la edición y el verificador final. Comprueba las salidas solicitadas para este proyecto. Lee Sonido de escena al planificar escenas audibles, elegir interpretaciones y mezclar. Haz coincidir la identidad de la voz con el personaje y el tratamiento del sonido con el entorno, la acción y la perspectiva de escucha prevista. Registra la revisión de sonido con imagen por separado de las comprobaciones técnicas de audio. Utiliza Biblia de sonido y spotting para establecer el papel dramático de una banda sonora, planificar las entradas de los cues y resolver una dirección musical incierta. Mantén el plan proporcional al proyecto. Utiliza Revisión de audio y video cuando un modelo autorizado con capacidad de audio esté disponible. Revisa el audio fuente real antes de comprometerlo en una edición, luego la mezcla completa con imagen. El análisis del modelo, las mediciones técnicas y el veredicto de la audiencia son evidencia separada.

Configuración del host y acceso a herramientas

La Etapa 0 es una conversación y verificación guiadas, no una lista de verificación que se entrega al usuario para que la resuelva solo. Lee references/00-setup-and-hosts.md en el primer uso o después de cambiar de host. Inspecciona lo que esta sesión ya puede hacer, utiliza el resumen y la política existente, y haz un lote corto de preguntas solo para los detalles faltantes que afecten la ruta seleccionada. Explica el propósito de cada herramienta faltante, el paso de configuración local exacto o el instalador oficial, quién necesita actuar y cómo lo probarás. Nunca pidas a los usuarios que peguen contraseñas, claves API, tokens o cookies. Los detalles de la cuenta significan elección del servicio/espacio de trabajo y estado de inicio de sesión, no valores secretos ni información personal no relacionada. Permíteles autenticarse en el flujo del proveedor o configurar los secretos en privado en el entorno de ejecución.

Ejecuta el scripts/studio.py doctor incluido para la ruta seleccionada antes de la producción, utiliza sus next_steps y mantén los resultados no secretos en setup/status.md. Instala o configura las dependencias locales requeridas dentro de la autorización del usuario; guíalos a través del inicio de sesión, el acceso de administrador o las capacidades faltantes del host cuando se necesite su acción. Vuelve a verificar después de cada reparación. Las herramientas opcionales solo son necesarias si el proyecto las selecciona. La planificación puede continuar mientras la configuración del render espera. Reutiliza decisiones previas y comprobaciones exitosas en ejecuciones posteriores, validando nuevamente las capacidades cambiadas o con fallos. Esto no crea otra puerta de aprobación. Un ejecutable descubierto no es prueba de una cuenta funcional, un servidor MCP conectado o un render exitoso. Registra esas comprobaciones por separado. Utiliza solo las capacidades realmente presentes en esta sesión. Los nombres de herramientas nativas, el control del navegador y la generación de imágenes difieren entre hosts; las rutas compartidas de CLI, Python y FFmpeg son la línea base portable. Sin sistema de archivos o shell, desarrolla el alcance en el chat y explica el acceso de ejecución que aún se necesita.

Rutas de herramientas

La tabla describe las rutas soportadas, no un permiso permanente para subir datos o gastar dinero. Sigue los proveedores aprobados del usuario y la política de la organización. Registra cualquier aprobación de proveedor/datos requerida antes de una nueva subida externa. No asumas que una suscripción significa que el entrenamiento está deshabilitado o que los datos confidenciales están limpios. Las dependencias locales de código abierto no son automáticamente nuevos proveedores alojados. Instala solo las dependencias necesarias para la ruta seleccionada.

Tarea	Principal	Alternativa
Investigación	búsqueda web
Imágenes (personas, lugares, utilería, fijas)	CLI de Higgsfield, modelo gpt_image_2_5	generación de imágenes integrada del host
Video	Seedance 2.5 en Higgsfield (CLI o web)
Captura	grabaciones suministradas o una herramienta de captura local ya autorizada, verificada antes de su uso	plan de rodaje/captura y metraje fuente requerido
Previz	Blender local o Higgsfield 3D Jutsu, seleccionado usando 03-previz.md	Plugin de Higgsfield para Blender, luego fotogramas clave adecuados
Gráficos con texto exacto	HTML renderizado a PNG con Chrome sin cabeza, o títulos de Resolve
Voz	CLI de Higgsfield text2speech_v2, o la propia grabación del usuario	audio nativo de Seedance
Música, cuando sea necesario	pista suministrada con licencia adecuada	cue original a través de la cuenta de Higgsfield autorizada, con comprobaciones de modelo/cita en vivo y términos de la fuente registrados
Edición	DaVinci Resolve Studio a través del MCP de DaVinci Resolve	control por computadora de Resolve, luego ffmpeg
Verificaciones	scripts/verify_project.py (usa ffprobe y ffmpeg)
Análisis de audio/video	API de Gemini autorizada a través de scripts/gemini-review.mjs, usando una clave API suministrada a través del entorno del proceso	Comentarios del usuario; retener juicios no verificados

Los ID de modelo, parámetros y límites cambian. Antes de usar un modelo, verifícalo en vivo con higgsfield model list y higgsfield model get <model> en lugar de confiar en los números de estos archivos. En CLI 1.1.26, generate create <model> --help muestra la ayuda genérica del comando, no los parámetros del modelo. Utiliza ./bin/higgsfield cuando el estudio proporcione un envoltorio local. El inicio de sesión de CLI es independiente del inicio de sesión del sitio web: ejecuta auth login, deja que el usuario complete el flujo del navegador, luego workspace list, selecciona el espacio de trabajo previsto y verifica account status --json. Nunca imprimas auth token. Un plan de pago o un listado de modelos no es prueba de un render exitoso. Para una lectura u operación local fallida, reintenta una vez, luego usa su alternativa y registra el resultado. Los envíos de pago necesitan un manejo diferente: un tiempo de espera puede haber creado un trabajo. Concilia el ID del trabajo y la transacción antes de reintentar. Un trabajo en curso no es un trabajo fallido. Haz polling a un intervalo sensato mientras continúas con el trabajo independiente. No envíes un duplicado porque sea lento. Si Higgsfield o un sitio está desconectado, pide al usuario que inicie sesión. Nunca escribas una contraseña.

Presupuesto

El presupuesto proviene de las instrucciones explícitas del usuario y la política del estudio en AGENTS.md (o el equivalente del host). Un presupuesto no establecido significa sin envíos de pago. Si falta, propón uno en el mensaje de la Puerta 1. Estima con higgsfield generate cost donde sea compatible, de lo contrario a partir del precio listado del modelo, y establece tus suposiciones. La estimación de costos con rutas de medios locales puede subir esos archivos, por lo que utiliza estimaciones solo de texto hasta que las entradas estén autorizadas para subir. Registra el gasto por toma en brief.md. Persiste cada cotización y reserva antes del envío. Mantén el gasto completado, los trabajos pendientes, los trabajos fallidos y los envíos inciertos dentro del límite hasta que se verifique un reembolso. Protege contra nombres de toma/plano duplicados y bloquea nuevo trabajo de pago mientras un envío sea incierto. Reserva también cualquier costo del navegador. Trata las respuestas nsfw, ip_detected, fallidas, canceladas y de error como terminales, no como trabajos para seguir haciendo polling o reenviar automáticamente. Utiliza account transactions para conciliar cargos y reembolsos con las horas y montos de envío, ya que el listado de transacciones puede omitir los ID de trabajo. El saldo de la cuenta solo es insuficiente si otro trabajo se ejecutó concurrentemente. Dentro del presupuesto, puedes renderizar, reintentar y editar regiones libremente. Si la siguiente acción lo excediera, detente y

... [truncado para traducción]