Agente de Design de Anúncios & Gráficos Estáticos (static-ad-design-agent)
Entrada: Kit de marca (MASTER_CONTEXT.md, URL do site, paleta, fontes, logotipo ou capturas de tela do produto) + oferta/ângulo
Saída: Carrosséis do Instagram finalizados, Anúncios de Imagem Estática (Feed, Retrato, História, Paisagem), Banners, Miniaturas, Verificação de Qualidade Visual e de Copy Determinística (_qa/qa-report.json) e um Quadro de Revisão Visual Interativo (review/index.html).
Esta skill é a pacote irmão estático de mrpaidsocial-video-editor-agent. Ela segue a mesma cultura: verificar pixels, zonas seguras e conformidade de claims — não intenções.
O Pipeline em Resumo
(0) Ingestão e Tokens de Marca (MASTER_CONTEXT.md + oferta/ângulo)
│
▼
(1) Plano de Ângulo e Arquétipo ──→ ads-manifest.json (variantes, carrosséis, copy, UTMs)
│
▼
(2) Construção da Composição ───────→ Artboards em HTML/CSS ou Pillow/SVG a partir de ad-canvas-starter.html
│
▼
(3) Rasterizar para PNG ────────→ 1080x1350 (4:5), 1080x1080 (1:1), 1080x1920 (9:16), 1200x628, 1920x1080
│
▼
(4) Loop de QA Determinístico ───→ python3 scripts/qa_static_ads.py (pixels, zonas seguras, claims proibidas)
│
▼
(5) Quadro de Revisão Interativo → python3 scripts/build_ad_review_board.py → review/index.html
Estágio 0 — Ingestão e Tokens de Marca
- Verifique a existência de
MASTER_CONTEXT.mdna raiz do workspace atual (ou copie deMASTER_CONTEXT.template.md). - Extraia:
- Tokens de marca:
--bg-ink,--bg-paper,--accent-primary,--accent-secondary,--accent-alert, fontes de título/corpo, logotipo e capturas de tela reais do produto. - Diretrizes:
banned_phrasese regras de vocabulário canônico.
- Tokens de marca:
- Confirme ou defina como padrão o pacote a ser entregue:
- Pacote de Carrossel: 5–7 slides em
1080×1350(4:5— máximo espaço vertical do feed). - Trio de Anúncio Estático:
1080×1350(4:5Feed),1080×1080(1:1Quadrado),1080×1920(9:16História/Reel). - Banner / Miniatura:
1200×628(Anúncio Link/Display) ou1920×1080(Miniatura de Vídeo).
- Pacote de Carrossel: 5–7 slides em
- Crie a pasta de trabalho da campanha:
outputs/<campaign-slug>/ ├── ads-manifest.json ├── artboards/ ├── renders/ ├── _qa/ └── review/
Estágio 1 — Plano de Ângulo e Arquétipo (ads-manifest.json)
Leia references/archetypes-and-safe-zones.md antes de criar os cards. Escolha entre os 10 arquétipos comprovados de anúncios estáticos e carrosséis:
- Desmentido com Carimbo Errado (Captura de tela/claim com carimbo nítido
ERRADOouMITO→ card de verdade) - Comparação Dividida Nós vs. Eles (Tabela de contraste de 2 colunas: Método Antigo vs. Método da Marca)
- Prova de UI do Produto Anotada (Captura de tela real do produto ou card com 3 pills de destaque ampliadas)
- Pilha de Custo/Tempo Acumulado (Recibo empilhado de custos/horas ocultos vs. 1 solução limpa)
- Diagrama de Mecanismo de 3 Etapas (Entrada → Motor → Resultado com selos numerados)
- Herói de Estatística + Fonte Citada (Chamada de métrica massiva + faixa de citação textual na parte inferior)
- Card de Gate Lista de Verificação ("Não se candidate/não lance até verificar estas 4 caixas")
- Card de Estado Antes / Depois (Estado sobrecarregado/disperso → estado de roteiro estruturado)
- Carrossel Narrativo de 5–7 Slides (Slide 1 Gancho → Slide 2 Agitação/Dados → Slides 3–5 Valor Acionável + Prova do Produto → Slide 6 Lista de Verificação Resumo → Slide 7 CTA)
- Miniatura / Banner de Alto Contraste (Frase de 3–5 palavras + assunto focal/UI + selo de contraste)
Escreva outputs/<campaign-slug>/ads-manifest.json aderindo ao esquema verificado por scripts/qa_static_ads.py:
{
"campaign_slug": "sa-bursary-deadlines-q4",
"brand_name": "Gradwyn",
"offer_angle": "Não perca os prazos de bolsas de engenharia e ciência da computação na África do Sul porque os requisitos estão enterrados em 40 PDFs.",
"cta_url": "https://gradwyn.com/?utm_source=meta&utm_medium=paid_social&utm_campaign=sa_bursaries",
"banned_phrases": [
"admissão garantida",
"bolsa garantida",
"chance de entrar",
"probabilidade de admissão"
],
"brand_palette": ["#0c1a17", "#f6f1e8", "#1a6b5c", "#c4892a", "#c45c4a"],
"creatives": [
{
"id": "carousel-01",
"type": "carousel",
"archetype": "carrossel-narrativo-5-slides",
"format": "4:5",
"width": 1080,
"height": 1350,
"primary_text": "A maioria dos estudantes perde bolsas não por causa das notas—mas porque as descobrem 2 semanas após o prazo ter fechado.",
"headline": "Veja bolsas combinadas com seu Perfil de Estudante",
"cta_label": "Saiba Mais",
"slides": [
{
"slide_index": 1,
"file": "renders/carousel-01-slide-01.png",
"eyebrow": "INÍCIO 2027 · ÁFRICA DO SUL & GLOBAL",
"headline": "3 Razões Pelas Quais Estudantes Ambiciosos Perdem Financiamento Todos os Anos",
"subhead": "E como construir um Roteiro com prazos rastreados em 4 minutos →",
"footer_note": "Deslize para a lista de verificação (1/5)"
}
]
},
{
"id": "static-feed-01",
"type": "static_ad",
"archetype": "comparação-nos-vs-eles",
"format": "4:5",
"width": 1080,
"height": 1350,
"file": "renders/static-feed-01.png",
"eyebrow": "ORIENTAÇÃO UNIVERSITÁRIA & DE BOLSAS",
"headline": "Pare de Adivinhar a Partir de 40 Abas de Navegador Abertas.",
"subhead": "Obtenha 3 Correspondências Universitárias com uma Pontuação de Compatibilidade Transparente e um Roteiro Passo a Passo.",
"primary_text": "A Gradwyn combina estudantes com universidades e bolsas usando IA—com razões claras e fontes oficiais.",
"cta_label": "Obtenha Suas 3 Correspondências"
}
]
}
Estágios 2 e 3 — Construir Artboards e Rasterizar para PNG
- Comece a partir de resources/ad-canvas-starter.html ou use o renderizador embutido dentro de scripts/qa_static_ads.py (
--render-from-manifest) que pode renderizar artboards PNG nítidos e de qualidade de publicação em1080×1350,1080×1080,1080×1920,1200×628e1920×1080diretamente deads-manifest.jsonusando Pillow + fontes TrueType (NotoSerif/NotoSans) quando a renderização headless do navegador não estiver disponível. - Respeite as zonas seguras da plataforma definidas em references/archetypes-and-safe-zones.md:
- Anúncio de História/Reel
9:16(1080×1920): Mantenha todo texto e logotipos dentro dey: 250px .. 1520pxex: 72px .. 1008px. - Feed/Carrossel
4:5(1080×1350): Mantenha todo texto dentro do preenchimento externo de72px(caixa segura936×1206) e mantenha os selos indicadores de slide fora do canto superior direito de140×100pxonde o Instagram sobrepõe o contador1/5. - Quadrado
1:1(1080×1080): Preenchimento externo de64px.
- Anúncio de História/Reel
Estágio 4 — Verificação de Qualidade Visual e de Copy Determinística
Execute o motor de QA na pasta da campanha:
python3 scripts/qa_static_ads.py --manifest outputs/<campaign-slug>/ads-manifest.json --render-missing
O que qa_static_ads.py verifica em cada ativo:
- Integridade de Arquivo e Pixel: Cada PNG referenciado existe, não está corrompido e corresponde exatamente à sua largura e altura de pixel declaradas (
1080×1350,1080×1080,1080×1920,1200×628,1920×1080). - Verificação de Variância Visual e Margem de Borda: Confirma que a imagem não está em branco/plana e verifica as bordas da zona segura para recorte acidental de texto.
- Densidade e Hierarquia de Copy: Aplica limites de palavras/caracteres de título (
<= 12 palavrasno título no canvas para leitura instantânea em mobile), completeza do texto principal e presença de CTA. - Gate de Diretriz e Claim Proibida: Verifica cada título, subtítulo, corpo do slide e legenda principal contra
banned_phrasesdeMASTER_CONTEXT.md. Qualquer violação reprova o QA com um relatório de linha exata. - Inspeção Visual: Após
qa_static_ads.pypassar, inspecione visualmente os PNGs renderizados para confirmar hierarquia, contraste e alinhamento.
Estágio 5 — Quadro de Revisão Visual Interativo
Gere o canvas de revisão humana:
python3 scripts/build_ad_review_board.py --manifest outputs/<campaign-slug>/ads-manifest.json
Isso escreve outputs/<campaign-slug>/review/index.html com:
- Pré-visualização horizontal com deslize/rolagem de cada Carrossel do Instagram em ordem de slides.
- Grade completa de Anúncios de Imagem Estática, Anúncios de História, Banners e Miniaturas.
- Alternância de Sobreposição de Zona Segura Interativa (mostra zonas mortas da UI do Meta/IG/TikTok diretamente sobre os gráficos).
- Selos de QA por Ativo (Aprovado / Aviso / Reprovado de
_qa/qa-report.json). - Cópia com Um Clique para Texto Principal, Título e URLs de CTA com UTMs.
- Alternâncias de Aprovar / Sinalizar para Revisão com exportação de notas de revisão em JSON.