Estilo de referencia (paso 05 del curso)
Sin referencia, el modelo deriva hacia una apariencia predeterminada: texto centrado sobre un degradado con todos los elementos apareciendo gradualmente. Rexan Wong (@rexan_wong) revisó un lote de clips virales y descubrió que nombrar un estilo funciona mejor que describirlo, y que una referencia proporciona al modelo el ritmo, el tipo y las transiciones a copiar. Esta habilidad convierte una referencia en dos documentos aprobados antes de que exista cualquier código de producción.
Argumentos de la solicitud (pueden estar vacíos), mostrados una vez:
La escalera de referencia
| Escalón | Qué da el usuario | Qué extraes | Herramienta |
|---|---|---|---|
| Un fotograma | una imagen fija de un video que le encanta | paleta, tipo, textura, densidad de composición | refs.mjs analyze refs/<carpeta> + examínalo |
| Un video | un archivo local de una película que admira | lo anterior más tiempos de corte, duraciones de toma, energía de movimiento por segundo, transiciones | refs.mjs extract + analyze |
| Una biblioteca | una carpeta con sus propias imágenes o trabajo anterior | un estilo propio que nadie más puede copiar | refs.mjs analyze refs/<carpeta> |
La pieza de código puro de Pleometric para TikTok comenzó a partir de un solo fotograma de otra animación viral; su película al estilo Donald señaló a Opus su propia galería de imágenes PC-98. Dónde encontrar referencias: videos de lanzamiento en whatships.com, animación en Dribbble y películas de lanzamiento de la competencia. Estúdialas; nunca las incrustes ni redistribuyas.
1. Obtén la referencia en disco
- Copia el archivo o carpeta en
refs/dentro del proyecto (inicialízalo con/motion-studio:studio-initprimero si no hay unstudio.json). - Si solo se proporciona un enlace al video de otra persona, pide al usuario una copia local que esté autorizado a estudiar. No descargues contenido de terceros por tu cuenta.
- Un fotograma único: colócalo en su propia carpeta (
refs/frame/) para queanalyzelo trate como un conjunto de imágenes. - Pregunta qué tomar y qué no tomar cuando el usuario tenga una opinión ("el grano y el tipo, no los personajes").
2. Mídelo
Ejecuta desde la raíz del proyecto:
| Referencia | Comandos |
|---|---|
| video | node tools/refs.mjs extract refs/<video> --every 0.5 y luego node tools/refs.mjs analyze refs/<video> |
| fotograma o biblioteca | node tools/refs.mjs analyze refs/<carpeta> |
| cortador rápido (muchos cortes omitidos) | añade --threshold 0.2 a analyze |
Salidas: refs/frames/frame_NNNN.png, refs/frames/frames.json, refs/contact.png (hoja etiquetada de hasta 60 mosaicos; una hoja alargada se pagina como cualquier hoja de contacto: refs/contact.png es la página 1, luego refs/contact-2.png, contact-3.png ...; abre cada página; el resultado --json las lista en contacts), y refs/analysis.json con tiempos de corte, duraciones de toma (media, mediana, rango), una paleta de 6 colores con porcentajes, brillo y contraste, energía de movimiento por segundo con su pico, y una sugerencia de densidad de texto. El resumen impreso es un bloque de inicio para la guía de estilo.
3. Escribe la guía de estilo y la lista de tomas
Indica a motion-studio:style-analyst (puede escribir docs/style_guide.md, docs/shotlist.md y refs/**):
Raíz del proyecto: <ruta absoluta>. Referencia: refs/<archivo o carpeta>. Tema: <tema>. Duración: <S> s.
Abre refs/contact.png (y refs/contact-2.png ... si está paginada) y algunos fotogramas alrededor de los cortes, lee refs/analysis.json.
Escribe docs/style_guide.md siguiendo las notas de la guía de estilo, luego docs/shotlist.md para una película de <S> s
sobre <tema> en ese estilo, sobre la rejilla de ritmo de audio/beats.json (o <BPM> BPM si no existe).
Toma la gramática de la referencia, nunca su contenido, logotipos, personajes o texto.
Devuelve preguntas en lugar de suponer.
Las notas sección por sección están en assets/style-guide-notes.md. Para usuarios que quieran pegar un prompt en una sesión nueva, los mismos pasos están escritos como assets/reference-prompt.md.
4. Toma la gramática, nunca el contenido
| Toma | Nunca tomes |
|---|---|
| relaciones de paleta (fondo oscuro, un acento cálido, proporción del acento) | logotipos, personajes, mascotas |
| familias tipográficas por clase, peso, tracking, saltos de escala | composiciones o fotogramas exactos |
| duraciones de toma y dónde caen los cortes contra el ritmo | el texto, afirmaciones o datos de la referencia |
| tipos de transición (corte duro, barrido con máscara, corte por correspondencia) | su metraje, música o voz |
| lenguaje de cámara (acercamientos, barridos panorámicos, planos fijos) | formas específicas de marca o imagen corporativa |
| textura (cantidad de grano, papel, semitonos) y cómo el texto entra y sale | cualquier cosa que el usuario no haya pedido tomar prestada |
5. La compuerta
Muestra ambos archivos (un resumen compacto de la guía de estilo y la tabla de la lista de tomas es suficiente) y espera la aprobación del usuario antes de cualquier código de producción. Cuando lo rechace, reescribe la lista de tomas (y la guía de estilo si la apariencia es incorrecta), nunca parchees código para "mostrar en su lugar". Registra la decisión en la línea Estado: al inicio de docs/shotlist.md.
6. Deja que el modelo elija la técnica
Especifica la apariencia y las restricciones, no la biblioteca. Pleometric sugirió p5.js y Opus escribió su propio renderizador de papel en su lugar. Dentro de este estudio, esto significa: describe la textura y el movimiento que deseas en la guía de estilo, y deja que la compilación elija cómo dibujarlo en el motor de lienzo (helpers de lib/draw.js o dibujo personalizado). Nombra un framework solo cuando el usuario lo necesite para reutilización (ruta B, /motion-studio:seek-engine).
Siguiente: construye con /motion-studio:motion-reel desde su etapa 5; para un bucle de estado de UI en este estilo, /motion-studio:ui-morph-spec.