motionable: make
Llegas aquí con hechos sobre un producto (cada uno con una fuente), las respuestas del usuario, rutas de imágenes, colores y notas sobre su personalidad. Tu trabajo es una película terminada que se sienta como este producto, y como ninguna otra película en el estudio.
ROOT es la raíz de motionable: ${CLAUDE_PLUGIN_ROOT}. Si eso no se expande, usa la carpeta dos niveles arriba de la ruta real de este archivo (realpath), que contiene engine/ y scripts/.
Lee ROOT/PLAN.md (modo plan), ROOT/ENGINE.md (los ingredientes), ROOT/rules.md (reglas estrictas) y ROOT/checklist.md (crítica) antes de planificar. ROOT/examples/owly/ muestra cómo se ve el trabajo terminado. Nunca copies su apariencia, sonido o estructura: es una dirección entre infinitas.
1. Crear la película
- Dónde: las películas viven en la carpeta actual (normalmente el estudio del usuario para videos promocionales), como
<slug>/.- Si la carpeta actual es el repositorio del producto, usa
motionable/<slug>/en su lugar. - Nunca escribas dentro de una carpeta de producto proporcionada a
/motionable:project. - Si
<slug>/existe, pregunta: ¿hacer una nueva versión (<slug>-2/) o continuar esa película?
- Si la carpeta actual es el repositorio del producto, usa
- Crearla: ejecuta
bash ROOT/scripts/new.sh <film> "<Nombre del producto>". Copia el motor en la película y escribe las plantillas. - Activos: copia las imágenes en
<film>/assets/con nombres claros (logo.png,screen-home.png…). Un archivo de fuente de marca, si el usuario lo tiene, va enassets/fonts/.
2. Modo plan (interno: sin comando, sin menú de estilo)
Sigue PLAN.md de principio a fin:
- Tablero de evidencia y personalidad.
- Historia: promesa, momento emblemático, 3 ganchos → 1.
- Cada dial ajustado, cada uno con su razón.
- Singularidad frente al estudio: lee el
DIRECTION.mdde las otras películas › Huella digital. Las películas hechas antes de v0.2 no tienen ninguna; trátalas como house de 120 BPM en La menor con titulares alineados a la izquierda sobre una tarjeta. - Escribe DIRECTION.md y SCRIPT.md al tempo elegido.
No le pidas al usuario que elija un estilo. La dirección viene de la evidencia.
3. Una aprobación
Muestra el tratamiento de 4 líneas (Sensación · Sonido · Apariencia · Momento emblemático) y una cuadrícula de tiempos compacta (tiempo · imagen · palabras · unión). Luego pregunta, con AskUserQuestion si está disponible (si no, en el chat):
- El plan: aprobar, o cambiar algo.
- Ilustraciones: "¿Debería dibujar ilustraciones para esta película?" Sí, ilustrarla / Unos pocos acentos / No, solo capturas de pantalla y tipografía. Recomienda una con una razón (PLAN.md §5).
- Dibujarlas es gratis: Claude escribe SVGs.
- Solo si la sesión tiene una herramienta de generación de imágenes conectada, añádelo como opción, y di que puede costar dinero.
No escribas código de escena antes de la aprobación. Un cambio aquí es barato.
4. Construir
- Ilustraciones (si sí): escribe los SVGs en
assets/drawn/en los colores de la marca y un grosor de línea (ENGINE.md › Ilustraciones dibujadas). Mira cada una renderizada en una hoja, y redibuja cualquier cosa torpe. scenes/Film.swift: reemplaza el esqueleto por completo. Cada valor proviene de DIRECTION.md y SCRIPT.md:- los tiempos van en
enum T; - clips y uniones van en un
Reel; - las pantallas pasan por las llamadas de encuadre (nunca recortadas en un cuadro fijo);
- el momento emblemático se redibuja para animarse exactamente como la interfaz de usuario real. Mide primero dónde se encuentra:
bash ROOT/scripts/inspect.sh <captura de pantalla> find <su color>(orow,column,pixel) da anillos, barras y bordes de texto exactos. - Elementos personalizados que la dirección necesita van en sus propios archivos
scenes/*.swift.
- los tiempos van en
- Sonido: la
Recipe(Receta) de la dirección +Sections (Secciones) mediantes.compose, más uns.cuepara cada evento de imagen, usando los sonidos emblemáticos. - Verifica que compile:
bash ROOT/scripts/run.sh <film> sheet(sin tiempos: la película completa más cada unión). Corrige errores de compilación (ENGINE.md › Problemas comunes).
5. Borrador, corregir, luego mostrar al usuario
Trabaja en borradores, y nunca hagas bucles infinitos:
- Borrador 1 es la primera compilación completa: escenas, música y cada cue. Revísalo desde la propia película (los pasos a continuación); no necesitas un archivo de video para eso. (
run.sh <film> draftrenderiza un MP4 pequeño y rápido si el usuario quiere un adelanto temprano.) - Autorevisión: una pasada, y cada verificación.
run.sh <film> check: cada ✗ es una corrección obligatoria. Mantén la línea más tiempo, comiénzala antes, recorta palabras, o elimina la línea. Una línea escrita necesita su tiempo de escritura más su tiempo de lectura. Actúa también según su consejo ⚠ (fotograma 1, ritmo) a menos que DIRECTION.md diga por qué no.run.sh <film> sheet: puntúa cada categoría en checklist.md, y corrige cualquier cosa por debajo de 8. Mira a tamaño completo losstillsdel gancho, el momento emblemático y la tarjeta final: ¿la UI es legible?, ¿algo choca?, ¿cada esquina del fotograma está haciendo algo o deliberadamente vacía?- Lo que los espectadores castigan (RESEARCH.md › verificación comunitaria): UI demasiado pequeña para leer, rebote en cosas grandes, tomas de una sola duración, música que suena a stock, un momento de logo lento.
run.sh <film> audio, luegobash ROOT/scripts/compare.sh <film>: si otra película es demasiado similar, cambia la receta por una razón.- Recorre toda la película:
run.sh <film> sheet $(seq 0.5 1 <duración>)(un fotograma por segundo). Busca lo que los stills individuales ocultan: una escena que se vacía, un ritmo sin movimiento, una unión que choca, una línea que aparece justo cuando la escena se va.
- Borrador 2. Corrige todo lo encontrado en un lote, luego ejecuta
checkysheetde nuevo.- Si algo aún falla, permite una pasada de corrección más como máximo.
- Si aún falla después de eso, no continúes: informa al usuario qué queda y por qué.
- Mantén un breve registro de críticas en SCRIPT.md: qué cambió y por qué.
- Renderiza el archivo real:
run.sh <film> video, aproximadamente 45 s por 30 s. - Muéstralo y pregunta (AskUserQuestion si está disponible). Envía el MP4, el tratamiento de 4 líneas y el registro de críticas, luego haz 3–4 preguntas dirigidas sobre este corte. Cada una necesita una opción recomendada, y "Otro" permite al usuario decir cualquier cosa:
- Ritmo: se siente bien / más lento, menos líneas / más rápido, más impacto.
- Sonido: mantenerlo / más energía / más calmado / diferentes instrumentos.
- Gancho: mantenerlo, o el más fuerte de los otros dos candidatos de gancho del modo plan, nombrado.
- Final: mantenerlo / un final seguro para lanzamiento (por ejemplo, sin insignia de Descarga antes de que la app esté en vivo) / añadir el precio.
- Revisa una vez por ronda de respuestas, volviendo a ejecutar
check,audioycompare, luego muestra el nuevo corte. Después de dos rondas del usuario, ofrece detenerte o continuar; el usuario decide.
6. Almacenar insignias (solo si el producto está en vivo)
- App Store en vivo y el usuario quiere una insignia: pide permiso para descargar la insignia oficial de Apple (aproximadamente 11 KB, negra, SVG en inglés; URL en rules.md) en
assets/.- Dibújala con
drawAppStoreBadge, estática y nunca animada; el énfasis viene deglowRing. - Si el usuario insiste en animarla, explica la regla de Apple una vez. Si aún la quieren, haz que sea una variante separada, claramente nombrada.
- Dibújala con
- Google Play: su insignia solo si la app está en vivo allí y el usuario aprueba la descarga. De lo contrario, como máximo una línea de texto plano, y solo si es verdad.
7. Entregar
Con cada corte que muestres, incluye:
- el tratamiento en unas pocas líneas;
- lo que la autorevisión corrigió;
- el resultado de la comparación y el veredicto de
check; - las afirmaciones a verificar antes de publicar;
- cómo cambiarlo: editar SCRIPT.md o DIRECTION.md, o simplemente decirlo.
Después de que el usuario esté satisfecho, ofrece las siguientes cosas útiles:
- un corte de 15 s, u otro formato (1:1, 16:9);
- variantes de gancho para una prueba A/B: la misma película abierta con los otros dos candidatos de gancho del modo plan;
- un final seguro para lanzamiento (sin "Descargar" antes de que la app esté en vivo);
- una versión solo de efectos (
run.sh <film> video effects), para publicar con un sonido de plataforma o una pista con licencia.