movistar-visual-production

Stack de produccion visual del Art Director (D) para piezas Movistar presentables a cliente. Assets de marca como archivos (fuentes, logos, tokens), fotografia real via OpenAI (gpt-image-2), ensamblad

SKILL.md

GitHub

Movistar Visual Production

Esta skill convierte la Estrategia Creativa en piezas finales presentables a cliente. Regla central: el modelo nunca genera base64 ni copia assets a mano. Escribe HTML con slots, y los scripts ensamblan, generan fotografia y renderizan.

El campo version del frontmatter no lleva tilde. Es una clave YAML, no prosa: Paperclip busca version y con versión no detecta el update. No pases correctores ortograficos sobre el frontmatter ni sobre bloques de codigo de este archivo.

Estructura del bundle

brand/
├── fonts/            Movistar Sans woff2 (10 variantes)
├── logos/            mark, mark-inverse, mark-dark, lockups, wordmarks (SVG)
├── tokens/           colors.css, spacing.css, typography.css, tokens.json
└── audit-report.md   Composición por formato destilada de 41 piezas reales. LEER SIEMPRE.
references/
├── INDEX.md          Catalogo de las 41 piezas reales por formato. Para MIRAR con Read
├── pieces/           Las 41 creatividades reales
└── gold-standards/   Las curadas y normalizadas. Para PASAR al generador con --ref
    ├── INDEX.md      Que referencia usar segun canal, modo y track. Rutas listas para copiar
    ├── <canal>/      email, digital, exterior, tienda, movistarplus, marca, meta (TRACK B)
    └── fotografia/   Crops de fotografia pura organizados por escena (TRACK A)
        ├── INDEX.md        Taxonomia de escenas, familia de ancla, origen
        ├── _anclas/        4 anclas de estilo (interior, exterior, producto, retail)
        └── <familia>/      interior-domestico, interior-personal, interior-retail,
                            exterior-urbano, exterior-ocio, producto
guidelines/
├── app-email.md      Plantilla email observada en piezas reales (9 bloques)
├── app-ads.md        Geometrias OOH y display con layouts ASCII
├── app-web.md        Landing de campaña vs web genérica
├── app-meta.md       Formatos Meta/Social: feed, story, landscape. 8 familias
├── app-movistarplus.md  Formatos Movistar+: WOW, videocartela, banner web
├── magic-prompt.md   Como escribir prompts de fotografía de marca
├── mockup-workflow.md  Cuando y como componer mockups contextuales
└── prototypers/      Prompts calibrados por canal (de los GPT validados por el equipo)
    ├── email.md          Familias visuales, paleta extendida y jerarquia del email
    ├── movistarplus.md   WOW vs videocartela, CTA link con >, modos de fondo
    ├── tienda-plv.md     Cartel A3 / etiqueta / stopper, beneficio antes que precio
    ├── meta.md           Formatos por ratio, sin boton CTA, paleta propia del canal
    ├── exterior.md       MUPI, lona, valla, monoposte, metro, wild-posting. Sin CTA, M a 6X
    └── display.md        Banners IAB (300x250, 300x600, 728x90, 980x250). CTA pill, precio
templates/
├── html/             Plantillas slot-based por formato
└── mockups/          Entornos + corners.json para el composer
scripts/
├── assemble.py       Rellena slots (fuentes, logos, tokens, imagenes)
├── generate_image.py Fotografia via OpenAI (OPENAI_API_KEY, gpt-image-2). Soporta --ref y --dry-run
├── render.py         HTML a PNG para verificación visual
└── mockup_composer.py  Incrusta la pieza en un entorno real

Verificacion de arranque (30 segundos, obligatoria)

Antes de producir nada, en cada ticket:

head -6 movistar-visual-production/SKILL.md               # confirma la version del bundle
ls movistar-visual-production/references/gold-standards/  # debe listar los canales + fotografia

Si la version no es la esperada o falta una carpeta, pide un git pull origin main del workspace antes de producir. Un upload manual al repo puede haber revertido el stack: tras cualquier pull, verifica con --dry-run antes de generar. Motivo: una tanda entera de 17 piezas se produjo sin referencias porque el workspace estaba clavado en un commit anterior, y esta misma skill ha sido revertida por un upload manual mas de una vez.

Workflow por pieza (obligatorio, en este orden)

1. Referencias antes de disenar

Lee 2-3 piezas reales del formato en references/pieces/ (usa references/INDEX.md para elegirlas) y el bloque del formato en brand/audit-report.md. Son ground truth: más fiables que cualquier regla escrita.

Dos carpetas, dos usos, no las confundas:

  • references/pieces/: las 41 piezas reales. Se miran con Read. No se pasan al generador de imagen: muchas son capturas de navegador, mockups con perspectiva o llevan logos de terceros que el modelo reproduciria.
  • references/gold-standards/: las curadas y normalizadas a JPEG q90, lado largo max 1536 px. Son las que se pasan con --ref en el paso 3.

2. Construir el HTML con slots

Parte de la plantilla del formato en templates/html/ si existe; si no, construye HTML de dimensiones fijas siguiendo el patron del audit-report. Reglas duras:

  • Tipografia: escribe {{FONT_FACE_MIN}} (o {{FONT_FACE}} si necesitas italicas o pesos 300/500). NUNCA escribas un @font-face con base64.
  • Tokens: escribe {{TOKENS_CSS}} y usa las variables. Paleta cerrada: cualquier HEX fuera de tokens es error.
  • Logos: usa los slots {{LOGO_MARK}}, {{LOGO_MARK_INVERSE}}, {{LOGO_LOCKUP}}, etc. NUNCA dibujes la M ni copies un SVG a mano. Variante inverse sobre fondo oscuro o azul.
  • Fotografía: escribe {{IMG:outputs/<slug>-<zona>.png}} con un atributo data-prompt describiendo la foto.
  • Emails: sin slots de fuente (ensambla con --no-font); HEX directos de la paleta; tablas.
  • Formatos ex-SVG (social, tienda, exterior, M+): produce HTML de dimensiones fijas y entrega el PNG renderizado. Solo produce SVG si piden vector editable.

3. Generar la fotografía

Por cada {{IMG:...}}: escribe el prompt siguiendo guidelines/magic-prompt.md (4-5 frases cinematograficas en ingles, realismo editorial, universo Movistar) y pasa 2-3 Gold Standards con --ref.

Generar sin referencia visual esta prohibido. refs: 0 es un fallo, no una opcion. El prompt describe la escena; la referencia transmite lo que el prompt no puede describir: composicion, luz, jerarquia y codigo de marca. Sin referencia el modelo produce stock generico.

Dos tracks de referencia, dos carpetas:

  • Track A (solo fotografia): cuando el prompt pide una foto pura sin texto ni logos ni marcos. Usa references/gold-standards/fotografia/ con el sistema escena + ancla de estilo. Para piezas slot-based donde la foto va en {{IMG:...}} y los elementos graficos los pone el HTML.
  • Track B (pieza completa): cuando generas la pieza entera con texto, precio, logo y composicion. Usa references/gold-standards/<canal>/ como hasta ahora. Dos niveles de referencia:
    • precedente_directo: mismo canal, mismo formato y mismo modo visual.
    • precedente_analogo: mismo canal y modo visual, pero formato o ratio hermano. Aplica flag referencia_aproximada.

Track A validado (2026-08-21): un test comparativo con/sin referencias fotograficas confirmo que Track A mejora la coherencia de luz (~3000K consistente), el casting espanol y la textura/grano respecto a generacion solo con texto. Track A es la opcion por defecto para toda fotografia de escena; solo omitirlo si hay una razon documentada.

Nunca mezcles tracks: no pases una referencia de pieza completa (Track B) cuando el prompt dice "pure photograph, no text" (Track A). La referencia y el prompt deben empujar en la misma direccion.

A0. Si el canal tiene prototyper, leelo primero. guidelines/prototypers/ tiene el prompt calibrado de los 6 canales: email, movistarplus, tienda-plv, meta, exterior y display. Cada uno define familias visuales, composicion por formato, paleta del canal, reglas criticas (CTA link en M+, sin boton en Meta ni en exterior, beneficio antes que precio en tienda, CTA pill en display excepto mobile) y alertas de validacion. Cada archivo empieza con un bloque de adaptacion que mapea dimensiones a los flags del script. El prototyper manda sobre la doctrina generica de magic-prompt.md en su canal.

A. Elegir. references/gold-standards/INDEX.md tiene la tabla "Que referencias pasar según lo que estes generando" con la combinación resuelta por canal y por modo. Reglas:

  • Siempre 2 referencias. refs: 0 es un fallo, no una opcion. Cada track tiene su logica de seleccion:

    Track A (fotografia pura): seleccion en cascada:

    1. Escena exacta en fotografia/<familia>/. Ancla siempre como ref 1, escena como ref 2. El modelo da mas peso a ref 1; si la escena va primero, su casting y composicion contaminan el resultado aunque el prompt pida otra cosa (validado en test A/B 2026-08-21).
    2. Sin escena exacta: coge la escena adyacente (misma familia, o misma condicion de luz interior/exterior) como ref 2; ancla sigue como ref 1. Describe en el prompt las diferencias entre la escena adyacente y la que necesitas, para que el modelo no arrastre lo que no toca.
    3. Sin familia aplicable (caso raro): las dos anclas mas cercanas. Nunca cero.
    • Registra reference_level: escena_exacta, escena_adyacente o solo_anclas. Aplica flag referencia_aproximada en los dos ultimos.

    Track B (pieza completa): seleccion por precedente:

    1. precedente_directo: ref 1 y ref 2 del mismo canal, formato y modo visual.
    2. precedente_analogo: al menos una referencia es de un ratio hermano del mismo canal y modo. Aplica flag referencia_aproximada.
    • Nunca uses anclas fotograficas en Track B. Registra reference_level: precedente_directo o precedente_analogo.
  • Advertencia de composicion (Track A): la escena de referencia puede dominar el encuadre incluso yendo como ref 2. Cuando el encuadre del prompt difiera del de la escena (ej. plano abierto vs POV por encima del hombro), refuerzalo con indicaciones explicitas de angulo de camara en el prompt. El orden de refs no basta para contrarrestarlo.

  • Combina por modo, no solo por canal: foto de escena con referencias FOTO, fondo grafico con referencias GRAFICO.

  • Movistar+ solo con Movistar+: sus referencias se combinan entre si, nunca con otros canales. Su codigo real es azul con pastilla blanca y keyword azul; el modo oscuro lo pone el key art, no un fondo negro.

  • El co-branding de las referencias es oficial (partners de Movistar): usalas sin miedo. Regla de contenido: si la pieza nueva promociona otros titulos u otros dispositivos, describe el contenido nuevo en el prompt para no arrastrar el de la referencia. Pieza 100% Movistar sin partner: anade exclusion de logos ajenos (referencias sin partner: tienda-plv-etiqueta-sin-ip.jpg y exterior-cartel-tipografico-paleta.jpg).

  • Si la fila del INDEX tiene la columna Ojo rellena, ese defecto va al prompt como exclusion explicita. El modelo copia los defectos igual que las virtudes.

B. Comprobar antes de gastar credito. Una vez por sesión:

python3 scripts/generate_image.py -p "test" -o /tmp/t.png --aspect <ratio> \
  --ref references/gold-standards/<canal>/<archivo>.jpg \
  --ref references/gold-standards/<canal>/<archivo>.jpg \
  --dry-run

Debe decir endpoint: .../v1/images/edits, encoding: multipart/form-data y refs: 2. Si dice generations y refs: 0, las referencias no se estan pasando: para y arreglalo antes de generar la tanda.

C. Generar.

Reglas del prompt (validadas en producción 18-08-2026, son la diferencia medida entre pieza buena y pieza mediocre):

  • El prompt describe la pieza, no la referencia. PROHIBIDO escribir "following the reference", "the template", "the gold standard" o equivalentes dentro del prompt. Escribe el prompt como si la referencia no existiera: que se ve, donde, con que luz, con que jerarquia y con que textos EXACTOS. La referencia entra solo por --ref.
  • Si usas escena adyacente (nivel 2 de la cascada), el prompt debe declarar las diferencias. Ejemplo: si la referencia es una terraza exterior y necesitas un salon interior, el prompt dice explicitamente "indoor living room at night, artificial lamp light" para que el modelo no importe la luz de exterior de la referencia. Lo que no corrijas explicitamente, lo heredas.
  • Parte del prompt calibrado del canal si existe en guidelines/magic-prompt.md sección "Entradas" (M+, tienda y email hero ya tienen). Sustituye las variables por el copy real y no toques la parte fija.
  • Toda cifra del prompt debe existir literal en el copy_prototype. El modelo inventa precios plausibles: una cifra no aprobada llega a cliente. Si no esta, no la pongas.
  • --quality high para entregables. medium solo para pruebas y dry-runs de calibración.
python3 scripts/generate_image.py \
  -p "<prompt>" -o outputs/<slug>-<zona>.png --aspect <ratio> --quality high \
  --ref references/gold-standards/<canal>/<archivo-1>.jpg \
  --ref references/gold-standards/<canal>/<archivo-2>.jpg

Las rutas de --ref son relativas a movistar-visual-production/. Ejecuta el script desde ahí. Si dice ERROR: referencia no encontrada, te imprime el cwd actual.

Limite de ratio del modelo: gpt-image-2 acepta un ratio maximo de 3:1 (validado en validate_size() lineas 123-125). Formatos con ratio superior (ej. WOW banner de M+ a 1920x384, ratio 5:1) no se pueden generar de una pasada. Workaround: generar al ratio valido mas cercano (1920x640 para WOW) y recortar en postproduccion si se necesita el ratio exacto.

Tecnicas de produccion validadas (conservalas):

  • Logo M en pieza generada: el modelo no lo reproduce bien. Tapa la M generada con un parche del color exacto del fondo y superpon el SVG real de brand/logos/.
  • WOW y videocartela de la misma campana comparten key art: genera una vez y compon ambas piezas a partir del mismo resultado.
  • La foto se genera al ratio real de su zona, nunca a otro ratio para recortar despues salvo el workaround de ratio maximo descrito arriba.
  • La M en pantallas PLV de tienda no va en la pieza (vive en los frames bumper). En el soporte impreso si va, segun pida el copy.

D. Documentar. En el design rationale, seccion Fotografia: reference_track (photography o full_piece) + reference_level (Track A: escena_exacta, escena_adyacente o solo_anclas; Track B: precedente_directo o precedente_analogo) + prompt literal + Gold Standards usados por nombre de archivo + por que esos + exclusiones metidas por la columna Ojo. Una entrada sin reference_track, reference_level o la linea de Gold Standards esta incompleta.

Si la API no esta disponible, usa como stand-in un crop coherente de references/pieces/ y flaggea imagen_provisional.

4. Ensamblar

python3 scripts/assemble.py -i pieza.slots.html -o outputs/pieza.html          # normal
python3 scripts/assemble.py -i email.slots.html -o outputs/email.html --no-font  # email

Si el script avisa de slots sin resolver, corrige antes de seguir.

5. Verificación visual (el paso que separa mockup de pieza final)

python3 scripts/render.py -i outputs/pieza.html -o outputs/pieza.png --width <W> --height <H>

MIRA el PNG (herramienta Read) y evalua. Los puntos 6 a 13 son checks deterministas: se responden si o no, no se interpretan. Salieron de defectos reales de una tanda de 17 piezas y son los que mas se escapan.

  1. Azul #0066FF presente, maximo un color secundario, solo Movistar Sans, sentence case, CTAs especificos sin exclamacion.

  2. Fondo correcto del canal. #FFFAF5 es la base en piezas offline, pero hay excepciones legitimas: display (fondo segun campana, ver app-ads.md), Meta (fondos variados por familia, incluidos salmon y verde claro, ver app-meta.md), M+ (modo claro/oscuro/foto, ver app-movistarplus.md), landing web (blanco puro + #EFF5FB, ver app-web.md). Consulta el guideline del canal antes de marcar un fondo como error.

  3. El patron del formato en brand/audit-report.md (jerarquia, posicion de la M, estructura).

  4. Nada solapado, cortado ni desbordado. Legibilidad a la distancia del soporte.

  5. La foto integra: luz creible, personas reales, sin look CGI, coherente con el tono.

  6. El titular NO lleva punto final. Los titulares se dejan abiertos. Regla 14 de movistar-brand-guidelines/brand/copywriting.md, que es la guideline oficial del cliente: "Dejamos los titulares abiertos, sin punto final: SOLO en titulares, pero en el resto de textos seguimos siempre las normas de la RAE". Ejemplos correctos de la propia guia: "Solo para ti", "Tenemos todo un mundo de experiencias a solo un clic". Ejemplos incorrectos: "Para ti, cliente.", "Y todavia hay mas.". Aplica a titulares y subtitulares; el body, el legal y el resto de textos siguen la RAE con normalidad.

    Excepcion, y solo esa: el claim de marca "es por todos." lleva punto porque forma parte del claim, no es un titular. No lo tomes como precedente para poner punto en titulares.

    Nota de correccion: hasta la v1.5.1 este check decia lo contrario ("el titular cierra con punto, regla incondicional"), en contradiccion con estilo-terminologia-movistar y con la guideline de marca. Era un error: la observacion de origen fue que en una tanda real 14 de 17 piezas no llevaban punto, y se interpreto como defecto cuando era el comportamiento correcto.

  7. El logo M donde manda el canal. Meta: abajo derecha. Resto: arriba derecha o segun playbook. Pantalla PLV de tienda: sin M en pieza.

  8. El CTA del tipo correcto. M+ (WOW y videocartela): link subrayado con >, nunca boton. Meta: sin boton CTA en la imagen. Resto: pill relleno azul.

  9. Sin jerga interna en copy de cliente. Prohibido en pieza: "BAF", "Stand Alone", "Horecas", "SA", "winback", "churn", codigos internos. Si el copy de C los trae, traduce y flaggea jerga_corregida.

  10. Todo en sentence case. Sin Title Case residual: "Vuelta al cole" no "Vuelta al Cole"; eyebrows sin mayusculas completas.

  11. Si el texto esta DENTRO de la imagen generada, lectura letra a letra con zoom. Tildes, ñ, dieresis, signos de apertura, cifras y simbolo €. Y lectura semantica: ¿la frase tiene sentido? Caso real: "vuelve a sonar" donde el copy decia "sonar". Una errata es bloqueante.

  12. Fisica de escena en la fotografia: sombras de contacto, objetos con apoyo creible, reflejos coherentes, sin duplicados imposibles. Es lo que delata la IA ante cliente.

  13. Producto hero: si la pieza ensena un dispositivo concreto, que sea ese modelo. El modelo falla aqui (caso real: iPhone X donde iba un iPhone 17). Si no puedes garantizarlo, pide dispositivo generico o flaggea producto_no_verificado.

  14. Test de parecido: puesta junto a las referencias reales, encaja como una mas.

Si algo falla, corrige y repite. Maximo 2 iteraciones. Si a la segunda el texto dentro de imagen no sale limpio, produce esa pieza con el HTML editable (texto vivo) y flaggea texto_en_imagen_fallido. Para el resto, entrega con flag qa_visual_fallido y detalle.

6. Mockup contextual (si es para presentar a cliente)

Sigue guidelines/mockup-workflow.md: pieza plana en PNG + template de templates/mockups/ + scripts/mockup_composer.py. Si no hay template del formato, genera el entorno con generate_image.py (prompt de entorno vacio, sin branding), anota las esquinas en .corners.json y guardalo en la subcarpeta para reutilizar.

Entregables por pieza

  • outputs/<pieza>.html ensamblado (autocontenido) o .slots.html + assets si piden editable
  • outputs/<pieza>.png render verificado
  • Mockup contextual si aplica
  • Entrada en el design rationale con el resultado del QA visual

Anti-patrones

  • Escribir base64 a mano (fuentes, logos, imagenes): NUNCA. Es la causa historica de tipografia rota.
  • Mezclar tracks de referencia: pieza completa (Track B) como referencia de una foto pura (Track A), o al reves.
  • Mencionar la referencia dentro del prompt.
  • Poner una cifra que no esta en el copy_prototype.
  • Placeholder dashed en una entrega final: solo se admite con flag imagen_provisional y motivo.
  • SVG a mano alzada con coordenadas para formatos fotograficos: usar HTML fijo + render.
  • Entregar sin haber mirado el render: prohibido.
  • Inventar HEX o tokens: si falta un valor, TODO + flag. Y verifica el nombre del token contra colors.css.
  • Pasar un corrector ortografico sobre el frontmatter o los bloques de codigo de esta skill.