Agente de Diseño de Anuncios Estáticos y Gráficos (static-ad-design-agent)
Entrada: Kit de marca (MASTER_CONTEXT.md, URL del sitio web, paleta, fuentes, logotipo o capturas de pantalla del producto) + oferta/ángulo
Salida: Carruseles de Instagram, Anuncios de Imagen Estáticos (Feed, Retrato, Historia, Horizontal), Banners, Miniaturas, Control de Calidad Visual y de Copia Determinista (_qa/qa-report.json) y un Panel de Revisión Visual Interactivo (review/index.html).
Esta habilidad es el paquete complementario estático de mrpaidsocial-video-editor-agent. Sigue la misma cultura: verificar píxeles, zonas seguras y cumplimiento de afirmaciones—no intenciones.
El Pipeline de un Vistazo
(0) Ingesta y Tokens de Marca (MASTER_CONTEXT.md + oferta/ángulo)
│
▼
(1) Plan de Ángulo y Arquetipo ──→ ads-manifest.json (variantes, carruseles, copia, UTMs)
│
▼
(2) Construcción de Mesas de Trabajo ───────→ Mesas de trabajo HTML/CSS o Pillow/SVG a partir de ad-canvas-starter.html
│
▼
(3) Rasterizar a PNG ────────→ 1080x1350 (4:5), 1080x1080 (1:1), 1080x1920 (9:16), 1200x628, 1920x1080
│
▼
(4) Bucle de QA Determinista ───→ python3 scripts/qa_static_ads.py (píxeles, zonas seguras, afirmaciones prohibidas)
│
▼
(5) Panel de Revisión Interactivo → python3 scripts/build_ad_review_board.py → review/index.html
Etapa 0 — Ingesta y Tokens de Marca
- Verifica si existe
MASTER_CONTEXT.mden la raíz del espacio de trabajo actual (o cópialo desdeMASTER_CONTEXT.template.md). - Extrae:
- Tokens de marca:
--bg-ink,--bg-paper,--accent-primary,--accent-secondary,--accent-alert, fuentes de título/cuerpo, logotipo y capturas de pantalla reales del producto. - Guardarraíles:
banned_phrasesy reglas de vocabulario canónico.
- Tokens de marca:
- Confirma o establece por defecto el paquete de entregables:
- Paquete de Carrusel: 5–7 diapositivas a
1080×1350(4:5, máximo espacio vertical del feed). - Trío de Anuncios Estáticos:
1080×1350(4:5Feed),1080×1080(1:1Cuadrado),1080×1920(9:16Historia/Reel). - Banner / Miniatura:
1200×628(Anuncio de Enlace/Display) o1920×1080(Miniatura de Video).
- Paquete de Carrusel: 5–7 diapositivas a
- Crea la carpeta de trabajo de la campaña:
outputs/<slug-de-campaña>/ ├── ads-manifest.json ├── artboards/ ├── renders/ ├── _qa/ └── review/
Etapa 1 — Plan de Ángulo y Arquetipo (ads-manifest.json)
Lee references/archetypes-and-safe-zones.md antes de diseñar las tarjetas. Elige entre los 10 arquetipos probados de estáticos y carruseles:
- Cazador de Mitos con Sello de Falso (Captura de pantalla/afirmación con sello claro de
FALSOoMITO→ tarjeta de verdad) - Comparación Dividida Nosotros vs. Ellos (Tabla de contraste de 2 columnas: Forma Antigua vs. Forma de la Marca)
- Prueba de UI de Producto Anotada (Captura de pantalla real del producto o tarjeta con 3 píldoras ampliadas)
- Acumulación de Costo/Tiempo (Recibo apilado de costos/horas ocultos vs. 1 solución limpia)
- Diagrama de Mecanismo de 3 Pasos (Entrada → Motor → Resultado con insignias numeradas)
- Héroe de Estadística + Fuente Citada (Llamada masiva de métrica + tira de citas textuales en la parte inferior)
- Tarjeta de Lista de Verificación ("No postules/lances hasta que marques estas 4 casillas")
- Tarjeta de Estado Antes/Después (Estado abrumado/disperso → estado de hoja de ruta estructurada)
- Carrusel Narrativo de 5–7 Diapositivas (Diapositiva 1 Gancho → Diapositiva 2 Agitación/Datos → Diapositivas 3–5 Valor Accionable + Prueba de Producto → Diapositiva 6 Lista de Verificación Resumen → Diapositiva 7 CTA)
- Miniatura/Banner de Alto Contraste (Frase contundente de 3–5 palabras + sujeto focal/UI + insignia de contraste)
Escribe outputs/<slug-de-campaña>/ads-manifest.json cumpliendo con el esquema verificado por scripts/qa_static_ads.py:
{
"campaign_slug": "sa-bursary-deadlines-q4",
"brand_name": "Gradwyn",
"offer_angle": "No te pierdas las fechas límite de becas de ingeniería y CS en Sudáfrica porque los requisitos están enterrados en 40 PDFs.",
"cta_url": "https://gradwyn.com/?utm_source=meta&utm_medium=paid_social&utm_campaign=sa_bursaries",
"banned_phrases": [
"admisión garantizada",
"beca garantizada",
"probabilidad de ingresar",
"probabilidad de admisión"
],
"brand_palette": ["#0c1a17", "#f6f1e8", "#1a6b5c", "#c4892a", "#c45c4a"],
"creatives": [
{
"id": "carousel-01",
"type": "carousel",
"archetype": "carrusel-narrativo-5-diapositivas",
"format": "4:5",
"width": 1080,
"height": 1350,
"primary_text": "La mayoría de los estudiantes pierden becas no por sus calificaciones, sino porque las descubren 2 semanas después de que cerró la fecha límite.",
"headline": "Descubre becas emparejadas con tu Perfil de Estudiante",
"cta_label": "Más Información",
"slides": [
{
"slide_index": 1,
"file": "renders/carousel-01-slide-01.png",
"eyebrow": "INTAKE 2027 · SUDÁFRICA Y GLOBAL",
"headline": "3 Razones por las que Estudiantes Ambiciosos Pierden Financiamiento Cada Año",
"subhead": "Y cómo construir una Hoja de Ruta con seguimiento de plazos en 4 minutos →",
"footer_note": "Desliza para la lista de verificación (1/5)"
}
]
},
{
"id": "static-feed-01",
"type": "static_ad",
"archetype": "comparación-nosotros-vs-ellos",
"format": "4:5",
"width": 1080,
"height": 1350,
"file": "renders/static-feed-01.png",
"eyebrow": "ORIENTACIÓN UNIVERSITARIA Y DE BECAS",
"headline": "Deja de Adivinar con 40 Pestañas del Navegador Abiertas.",
"subhead": "Obtén 3 Coincidencias Universitarias con un Puntaje de Ajuste Transparente y una Hoja de Ruta Paso a Paso.",
"primary_text": "Gradwyn empareja estudiantes con universidades y becas usando IA—con razones claras y fuentes oficiales.",
"cta_label": "Obtén tus 3 Coincidencias"
}
]
}
Etapas 2 y 3 — Construir Mesas de Trabajo y Rasterizar a PNG
- Comienza desde resources/ad-canvas-starter.html o usa el renderizador integrado dentro de scripts/qa_static_ads.py (
--render-from-manifest) que puede renderizar mesas de trabajo PNG nítidas de calidad de publicación en1080×1350,1080×1080,1080×1920,1200×628y1920×1080directamente desdeads-manifest.jsonusando Pillow + fuentes TrueType (NotoSerif/NotoSans) cuando la renderización del navegador sin cabeza no está disponible. - Respeta las zonas seguras de la plataforma definidas en references/archetypes-and-safe-zones.md:
9:16(1080×1920) Anuncio de Historia/Reel: Mantén todo el texto y logotipos dentro dey: 250px .. 1520pxyx: 72px .. 1008px.4:5(1080×1350) Feed / Carrusel: Mantén todo el texto dentro del relleno exterior de72px(caja segura de 936×1206) y mantén las insignias indicadoras de diapositiva fuera de la esquina superior derecha de140×100pxdonde Instagram superpone el contador1/5.1:1(1080×1080) Cuadrado: Relleno exterior de64px.
Etapa 4 — Control de Calidad Visual y de Copia Determinista
Ejecuta el motor de QA en la carpeta de la campaña:
python3 scripts/qa_static_ads.py --manifest outputs/<slug-de-campaña>/ads-manifest.json --render-missing
Lo que qa_static_ads.py verifica en cada activo:
- Integridad de Archivo y Píxeles: Cada PNG referenciado existe, no está corrupto y coincide con su ancho y alto de píxeles declarados exactos (
1080×1350,1080×1080,1080×1920,1200×628,1920×1080). - Verificación de Variación Visual y Margen de Borde: Confirma que la imagen no está en blanco/plana y verifica los bordes de las zonas seguras para evitar recortes accidentales de texto.
- Densidad y Jerarquía de Copia: Aplica límites de palabras/caracteres en titulares (
<= 12 palabrasen el titular en pantalla para escaneo móvil instantáneo), integridad del texto principal y presencia de CTA. - Guardarraíl y Verificación de Afirmaciones Prohibidas: Escanea cada titular, subtítulo, cuerpo de diapositiva y caption principal contra
banned_phrasesdeMASTER_CONTEXT.md. Cualquier infracción falla la QA con un informe de línea exacta. - Inspección Visual: Después de que
qa_static_ads.pypase, inspecciona visualmente los PNG renderizados para confirmar jerarquía, contraste y alineación.
Etapa 5 — Panel de Revisión Visual Interactivo
Genera el lienzo de revisión humana:
python3 scripts/build_ad_review_board.py --manifest outputs/<slug-de-campaña>/ads-manifest.json
Esto escribe outputs/<slug-de-campaña>/review/index.html con:
- Vista previa de deslizamiento/desplazamiento horizontal de cada tira de diapositivas de Carrusel de Instagram en orden.
- Cuadrícula completa de Anuncios de Imagen Estáticos, Anuncios de Historia, Banners y Miniaturas.
- Interruptor de Superposición de Zona Segura Interactiva (muestra las zonas muertas de la UI de Meta/IG/TikTok directamente sobre los gráficos).
- Insignia de QA por Activo (Aprobado / Advertencia / Fallo de
_qa/qa-report.json). - Copia con un Solo Clic para Texto Principal, Titular y URLs de CTA con etiquetas UTM.
- Interruptores de Aprobar / Marcar para Revisión con exportación JSON de notas de revisión.