Agent de Conception Statique pour Publicités & Graphismes (static-ad-design-agent)
Entrée : Kit de marque (MASTER_CONTEXT.md, URL du site web, palette, polices, logo ou captures d'écran du produit) + offre/angle
Sortie : Carrousels Instagram, Images Publicitaires Statiques (Feed, Portrait, Story, Paysage), Bannières, Vignettes, Contrôle Qualité Déterministe du Visuel et du Texte (_qa/qa-report.json) et un Tableau de Bord de Révision Visuelle Interactif (review/index.html).
Cette compétence est l'extension « création statique » de mrpaidsocial-video-editor-agent. Elle suit la même philosophie : vérifier les pixels, les zones de sécurité et la conformité des affirmations — pas les intentions.
Aperçu du Pipeline
(0) Réception et Jetons de Marque (MASTER_CONTEXT.md + offre/angle)
│
▼
(1) Plan de l'Angle et de l'Archétype ──→ ads-manifest.json (variantes, carrousels, textes, UTM)
│
▼
(2) Construction de la Composition ────→ Plans de travail HTML/CSS ou Pillow/SVG à partir de ad-canvas-starter.html
│
▼
(3) Rastérisation en PNG ───────────────→ 1080x1350 (4:5), 1080x1080 (1:1), 1080x1920 (9:16), 1200x628, 1920x1080
│
▼
(4) Boucle de QA Déterministe ─────────→ python3 scripts/qa_static_ads.py (pixels, zones de sécurité, affirmations interdites)
│
▼
(5) Tableau de Bord de Révision Interactif → python3 scripts/build_ad_review_board.py → review/index.html
Étape 0 — Réception et Jetons de Marque
- Vérifier la présence de
MASTER_CONTEXT.mddans la racine de l'espace de travail (ou le copier à partir deMASTER_CONTEXT.template.md). - Extraire :
- Jetons de marque :
--bg-ink,--bg-paper,--accent-primary,--accent-secondary,--accent-alert, polices de titre/corps, logo et captures d'écran réelles du produit. - Garde-fous :
banned_phraseset règles de vocabulaire canonique.
- Jetons de marque :
- Confirmer ou définir par défaut le pack livrable :
- Pack Carrousel : 5 à 7 diapositives en
1080×1350(4:5, espace maximal du feed vertical). - Trio d'Annonces Statiques :
1080×1350(4:5Feed),1080×1080(1:1Carré),1080×1920(9:16Story/Reel). - Bannière / Vignette :
1200×628(Annonce Lien/Affichage) ou1920×1080(Vignette Vidéo).
- Pack Carrousel : 5 à 7 diapositives en
- Créer le dossier de travail de la campagne :
outputs/<slug-campagne>/ ├── ads-manifest.json ├── artboards/ ├── renders/ ├── _qa/ └── review/
Étape 1 — Plan de l'Angle et de l'Archétype (ads-manifest.json)
Lire references/archetypes-and-safe-zones.md avant de disposer les cartes. Choisir parmi les 10 archétypes éprouvés pour les statiques et carrousels :
- Myth Buster au Tampon Erroné (Capture d'écran/affirmation avec un tampon
FAUXouMYTHE→ carte vérité) - Comparaison Scindée Nous vs. Eux (Tableau contrasté à 2 colonnes : Ancienne Méthode vs. Méthode de la Marque)
- Preuve UI Annotée du Produit (Capture d'écran réelle du produit ou carte avec 3 pastilles d'annotation zoomées)
- Pile de Coût / Temps Cumulé (Reçu empilé des coûts/heures cachés vs. 1 solution propre)
- Diagramme de Mécanisme en 3 Étapes (Entrée → Moteur → Résultat avec badges numérotés)
- Statistique Héroïque + Source Citée (Appel à une métrique massive + bande de citation textuelle en bas)
- Carte de Vérification Préalable ("N'envoyez pas/lancez pas avant d'avoir coché ces 4 cases")
- Carte d'État Avant / Après (État submergé/dispersé → état de feuille de route structurée)
- Carrousel Narratif de 5 à 7 Diapositives (Diapo 1 Accroche → Diapo 2 Agitation/Données → Diapos 3-5 Valeur Actionnable + Preuve Produit → Diapo 6 Liste de Vérification Résumé → Diapo 7 CTA)
- Bannière / Vignette à Fort Contraste (Phrase percutante de 3 à 5 mots + sujet focal/UI + badge de contraste)
Écrire outputs/<slug-campagne>/ads-manifest.json en respectant le schéma vérifié par scripts/qa_static_ads.py :
{
"campaign_slug": "sa-bursary-deadlines-q4",
"brand_name": "Gradwyn",
"offer_angle": "Ne manquez pas les échéances des bourses d'ingénierie et d'informatique en Afrique du Sud parce que les conditions sont enterrées dans 40 PDF.",
"cta_url": "https://gradwyn.com/?utm_source=meta&utm_medium=paid_social&utm_campaign=sa_bursaries",
"banned_phrases": [
"admission garantie",
"bourse garantie",
"chance d'être admis",
"probabilité d'admission"
],
"brand_palette": ["#0c1a17", "#f6f1e8", "#1a6b5c", "#c4892a", "#c45c4a"],
"creatives": [
{
"id": "carousel-01",
"type": "carousel",
"archetype": "carrousel-narratif-5-diapositives",
"format": "4:5",
"width": 1080,
"height": 1350,
"primary_text": "La plupart des étudiants manquent des bourses non pas à cause de leurs notes, mais parce qu'ils les découvrent 2 semaines après la date limite.",
"headline": "Voir les bourses correspondant à votre Profil Étudiant",
"cta_label": "En savoir plus",
"slides": [
{
"slide_index": 1,
"file": "renders/carousel-01-slide-01.png",
"eyebrow": "PROMOTION 2027 · AFRIQUE DU SUD & MONDIAL",
"headline": "3 Raisons pour lesquelles les Étudiants Ambitieux Manquent de Financement Chaque Année",
"subhead": "Et comment construire une feuille de route avec suivi des échéances en 4 minutes →",
"footer_note": "Balayez pour la liste de vérification (1/5)"
}
]
},
{
"id": "static-feed-01",
"type": "static_ad",
"archetype": "comparaison-nous-vs-eux",
"format": "4:5",
"width": 1080,
"height": 1350,
"file": "renders/static-feed-01.png",
"eyebrow": "ORIENTATION UNIVERSITAIRE & BOURSIER",
"headline": "Arrêtez de deviner avec 40 onglets de navigateur ouverts.",
"subhead": "Obtenez 3 correspondances universitaires avec un Score de Compatibilité transparent et une feuille de route étape par étape.",
"primary_text": "Gradwyn met en relation les étudiants avec des universités et des bourses en utilisant l'IA, avec des raisons claires et des sources officielles.",
"cta_label": "Obtenez vos 3 Correspondances"
}
]
}
Étapes 2 et 3 — Construction des Plans de Travail et Rastérisation en PNG
- Partir de resources/ad-canvas-starter.html ou utiliser le moteur de rendu intégré dans scripts/qa_static_ads.py (
--render-from-manifest) qui peut générer des plans de travail PNG nets, de qualité publication, en1080×1350,1080×1080,1080×1920,1200×628et1920×1080directement à partir deads-manifest.jsonen utilisant Pillow et les polices TrueType (NotoSerif/NotoSans), si le rendu via un navigateur sans tête est indisponible. - Respecter les zones de sécurité de la plateforme définies dans references/archetypes-and-safe-zones.md :
- Annonce Story/Reel
9:16(1080×1920) : Conserver tout le texte et les logos à l'intérieur dey: 250px .. 1520pxetx: 72px .. 1008px. - Feed / Carrousel
4:5(1080×1350) : Conserver tout le texte à l'intérieur d'un padding extérieur de72px(zone de sécurité936×1206) et garder les badges d'indicateur de diapositive hors du coin supérieur droit140×100pxoù Instagram superpose le compteur1/5. - Carré
1:1(1080×1080) : Padding extérieur de64px.
- Annonce Story/Reel
Étape 4 — Contrôle Qualité Déterministe du Visuel et du Texte
Exécuter le moteur de QA sur le dossier de la campagne :
python3 scripts/qa_static_ads.py --manifest outputs/<slug-campagne>/ads-manifest.json --render-missing
Ce que qa_static_ads.py vérifie sur chaque asset :
- Intégrité du Fichier et des Pixels : Chaque PNG référencé existe, n'est pas corrompu et correspond exactement à sa largeur et hauteur de pixels déclarées (
1080×1350,1080×1080,1080×1920,1200×628,1920×1080). - Variation Visuelle et Vérification des Marges de Bord : Confirme que l'image n'est pas vide/plate et vérifie les bords des zones de sécurité pour détecter un écrêtage accidentel du texte.
- Densité et Hiérarchie du Texte : Applique des limites de mots/caractères pour le titre (
<= 12 motssur le titre du visuel pour une lecture mobile instantanée), une complétude du texte principal et la présence du CTA. - Porte de Garde et Vérification des Affirmations Interdites : Scanne chaque titre, sous-titre, corps de diapositive et légende principale par rapport à
banned_phrasesprovenant deMASTER_CONTEXT.md. Toute violation fait échouer la QA avec un rapport de ligne exact. - Inspection Visuelle : Après la réussite de
qa_static_ads.py, inspecter visuellement les PNG rendus pour confirmer la hiérarchie, le contraste et l'alignement.
Étape 5 — Tableau de Bord de Révision Visuelle Interactif
Générer le canevas de révision humaine :
python3 scripts/build_ad_review_board.py --manifest outputs/<slug-campagne>/ads-manifest.json
Cette commande écrit outputs/<slug-campagne>/review/index.html contenant :
- Un aperçu par balayage/défilement horizontal de chaque bande de diapositives de Carrousel Instagram dans l'ordre.
- Une grille complète des Images Publicitaires Statiques, Annonces Story, Bannières et Vignettes.
- Bascule Interactif de Superposition des Zones de Sécurité (affiche les zones mortes de l'interface Meta/IG/TikTok directement sur les graphiques).
- Badge QA par Asset (Réussite / Avertissement / Échec provenant de
_qa/qa-report.json). - Copie en Un Clic pour le Texte Principal, le Titre et les URL de CTA avec balises UTM.
- Boutons Approuver / Marquer pour Révision avec export JSON des notes de révision.