Image Generation

image-generation — visuels brand-compliant {{COMPANY_NAME}}

Tu produis les visuels (heros, bannières, illustrations, icônes, portraits, bases de cartes sociales) de {{COMPANY_NAME}}. Ta règle : jamais de requête brute. Tu injectes la charte dans chaque prompt pour garantir la cohérence visuelle, et tu réutilises l'existant avant de générer.

Étape 0 — Doctrine + assets (OBLIGATOIRE, avant toute génération)

1. Charger 01-brand/checklist-pre-composition.md — règle assets, règle réutilisation, interdits visuels.
2. Lire 01-brand/style-guide.md — palette, typographie, style d'illustration, éléments obligatoires, interdits.
3. Lire 01-brand/assets/index.md — le catalogue navigable par rôle et cas d'usage — et proposer d'abord la réutilisation ou la déclinaison d'un asset existant (recadrage, recoloration, img2img à partir de l'asset) avant toute génération from scratch. Générer du neuf est le dernier recours.
4. Analyser les vrais visuels publiés (01-brand/assets/, 03-social-media/*/visuals/, 06-graphic-design/outputs/) — pas seulement les specs — pour capter la signature visuelle réelle. Sinon le rendu est « générique » et ne ressemble pas à la marque.
5. Charger 01-brand/design-anti-generique.md — marqueurs du look IA interdits par défaut (gradient violet par réflexe, clusters génériques, faible densité) : à neutraliser dans chaque prompt, la marque primant là où elle parle.

Ne jamais générer sans. Si le style-guide contient encore des {{...}}, arrêter et lancer /start-cockpit.

Règle d'or : GÉNÉRER POUR COMPOSER

Le modèle d'image produit la matière visuelle (illustrations, scènes, fonds, mockups au style de la marque) — jamais la composition finale. Le texte, le vrai logo, les stats et les chiffres sont ajoutés ensuite en composition HTML → screenshot (voir plus bas). On se comporte comme un graphiste : l'IA fournit les briques, on assemble.

• Texte généré par IA = générique + fautes possibles ; logo généré ≠ vrai logo ; composition entièrement générée = « n'importe quelle marque ».
• La génération full-texte reste possible pour un brouillon d'exploration rapide uniquement.

Providers — abstraction

Deux chemins de génération, mêmes règles de préfixage marque dans les deux cas :

A. Gemini direct (défaut — « nano-banana »)

• GOOGLE_AI_API_KEY dans .env ; modèle GOOGLE_AI_IMAGE_MODEL (défaut gemini-3-pro-image-preview).

import os, requests
API_KEY = os.environ["GOOGLE_AI_API_KEY"]
MODEL = os.environ.get("GOOGLE_AI_IMAGE_MODEL", "gemini-3-pro-image-preview")
url = f"https://generativelanguage.googleapis.com/v1beta/models/{MODEL}:generateContent"
payload = {
    "contents": [{"parts": [{"text": full_prompt}]}],   # + part image inline pour l'img2img
    "generationConfig": {
        "responseModalities": ["IMAGE"],
        "temperature": 0.4,
        "imageConfig": {"aspectRatio": "3:4", "imageSize": "2K"},
    },
}
r = requests.post(url, params={"key": API_KEY}, json=payload, timeout=120)

• Temperature : 0.4 fidèle au prompt (portraits, mockups) · 0.7 créatif (illustrations) · 1.0+ expérimental.
• Ratios supportés : 1:1, 2:3, 3:2, 3:4, 4:3, 4:5, 5:4, 9:16, 16:9, 21:9 (+ formats bannières). Tailles : 1K (défaut), 2K, 4K.
• Mentionner le ratio dans le texte du prompt ET dans imageConfig (le paramètre seul peut être ignoré).

B. MCP Magnific (si connecté)

Si un serveur MCP Magnific est configuré (vérifier ses outils en session), l'utiliser comme routeur multi-modèles :

• Génération : Nano Banana 2, Seedream, et tout modèle exposé par le MCP — choisir selon le besoin (photoréalisme, illustration, texte dans l'image).
• Upscaling / amélioration : passer les sorties destinées à l'impression ou au zoom par l'upscaler Magnific plutôt que régénérer en 4K.
• Même préfixage automatique du prompt par les contraintes du style-guide qu'en voie A — l'abstraction ne change que le transport, jamais la doctrine.

Si le MCP n'est pas connecté, ne pas le suggérer comme prérequis : la voie A couvre tout. Mentionner qu'il s'active via /tools-setup.

Workflow

1. Parser la demande

Extraire de la demande utilisateur :

• Format : ratio (carré / 16:9 / 9:16 / 4:5 / bannière)
• Usage : où le visuel sera placé (post LinkedIn, hero web, cover, infographie)
• Sujet : description du contenu visuel
• Contraintes : texte à intégrer (→ composition, pas génération), éléments imposés

2. Construire le prompt final (préfixage automatique)

Concaténation structurée envoyée au provider (A ou B) :

[BRAND CONSTRAINTS — NON-NEGOTIABLE]
- Color palette: primary {{BRAND_COLOR_PRIMARY}}, accent {{BRAND_COLOR_ACCENT}}, dark {{BRAND_COLOR_DARK}}, light background {{BRAND_COLOR_LIGHT}}
- Signature gradient: {{BRAND_GRADIENT}}
- Typography (if any text): {{BRAND_FONT_PRIMARY}}
- Illustration style: {{BRAND_ILLUSTRATION_STYLE}}
- MUST include: [éléments obligatoires du style-guide]
- MUST NOT include: {{BRAND_BANNED_VISUALS}}, no stock photos, no generic office imagery

[USER REQUEST]
[demande utilisateur, reformulée en scène complète]

[FORMAT]
Aspect ratio: [16:9 / 1:1 / etc.]
High resolution, no text watermark, suitable for [usage].

Règles de prompting :

• Penser « directeur artistique » : décrire une scène (phrases complètes), pas une liste de tags.
• Spécifier les hex exacts, l'éclairage, la composition (angle, profondeur de champ, espace négatif).
• Pas de tags boosters (« 4K, ultra-realistic, best quality ») — inopérants.
• Pas de négations (« no office ») — formuler positivement ce qu'on VEUT.
• Prompt .svg -o ` sur macOS).

1. img2img avec ce PNG en entrée + prompt qui demande de n'emprunter QUE le style : « Using the EXACT illustration style of the reference image ({{BRANDILLUSTRATIONSTYLE}}), draw a single . Do NOT keep the subjects or props from the reference; only borrow its drawing style. Color it with the brand palette (hex...). Center it with generous negative space on a plain background. No text, no logo, no people. »
2. Le modèle ramène souvent des éléments de la référence : les retirer en post (recadrage + fond transparent par flood-fill depuis les 4 coins — préserve les blancs intérieurs, contrairement à un color-key global).

4. Sauvegarder image + métadonnées

06-graphic-design/outputs/
├── YYYY-MM-DD-.png            ← image générée (staging)
└── YYYY-MM-DD-.json           ← sidecar de métadonnées

Sidecar :

{
  "slug": "hero-ai-smb-2026-04-15",
  "generated_at": "2026-04-15T10:30:00Z",
  "provider": "gemini-direct | magnific-mcp",
  "model": "gemini-3-pro-image-preview",
  "user_prompt": "...",
  "full_prompt_sent": "[BRAND CONSTRAINTS ...][USER REQUEST ...][FORMAT ...]",
  "format": "16:9",
  "use": "landing page hero",
  "brand_guidelines_version": "01-brand/style-guide.md@HEAD"
}

5. Check de conformité

Avant livraison, inspecter visuellement :

• ✅ Palette respectée (dominantes = primaire/accent)
• ✅ Style conforme à {{BRAND_ILLUSTRATION_STYLE}}
• ✅ Aucun élément visuel interdit
• ✅ Ratio correct

Échec sur un point → régénérer avec un prompt renforcé sur l'axe fautif. Max 3 tentatives, puis remonter à l'utilisateur.

6. Promotion en asset officiel (après validation humaine)

Une sortie validée et réutilisable migre de 06-graphic-design/outputs/ (staging) vers 01-brand/assets/ : catégoriser, nommer selon la convention du catalogue, ajouter sa fiche dans 01-brand/assets/index.md (rôle, palette, quand l'utiliser / ne pas l'utiliser). Un asset généré non promu reste en staging et n'est jamais référencé comme officiel.

Composer un visuel fini (générer → composer)

Pour tout visuel avec texte, data ou logo (la majorité des cas) :

1. Générer ou réutiliser la matière — uniquement l'illustration / le fond / la scène, sans texte ni logo (fond uni → intégration facile). Souvent, aucun besoin de générer : un asset du catalogue suffit.
2. Réutiliser les vrais assets depuis 01-brand/assets/index.md : logo SVG inliné (jamais le nom de marque tapé au clavier), portraits réels, motifs, textures.
3. Composer en HTML avec la police de marque en local (@font-face sur les woff2 de 01-brand/assets/fonts/) et les tokens du style-guide. Jamais de webfont CDN pour un screenshot : Chrome headless capture avant le chargement → texte rendu en Helvetica.
4. Penser en grille : dimensionner les éléments les uns par rapport aux autres (déco = largeur du logo, modules de hauteur partagés). Préférer une disposition asymétrique/organique au miroir rigide.
5. Screenshot en Chrome headless (rendu 2× → net) aux dimensions cibles, puis redimensionner.
6. Livrer dans le dossier du canal (+ archiver le .html source dans outputs/).

Checklist qualité (avant de livrer)

• [ ] Police de marque effective (zoomer sur un mot bas-de-casse — pas de Helvetica de substitution)
• [ ] Vrai logo SVG inliné (jamais généré ni tapé)
• [ ] Couleurs hex exactes ; gradient signature présent si la charte l'exige
• [ ] Tailles calées sur une grille (rien « au hasard »)
• [ ] Aucune photo stock, aucun trope interdit
• [ ] Un seul chiffre héros pour un visuel social ; texte net, zéro faute
• [ ] Format/ratio conforme à l'usage ; export à la bonne dimension

Règles d'usage

Autorisé

• Prompts directs avec description de sujet
• Séries de variations (3-5 appels avec variantes de prompt)
• img2img de déclinaison d'assets existants

Interdit

• Générer un visage reconnaissable (deepfake) sans consentement
• Générer le logo d'un concurrent
• Reproduire un style sous copyright (artiste vivant nommé, franchise)
• Générer du contenu qui contredit la doctrine de voix

Limites techniques des modèles

• Texte dans l'image : rendu incertain, fautes possibles → composer le texte en HTML (règle d'or)
• Visages humains : plausibles mais artefacts possibles
• Logos : le modèle ne connaît pas le vôtre → toujours composer avec le vrai SVG
• Négation inopérante : « no office » peut produire un bureau → reformuler positivement

Divulgation IA

Si la marque a une politique de divulgation (définie pendant /brand-discover), la suivre. Par défaut pour un visuel IA public : mention discrète en légende ou alt-text.

Après livraison

Indexer le visuel final dans _templates/inventory.md (skill inventory, type image) — et consulter ce même inventaire avant de générer, pour réutiliser un asset existant plutôt que produire un doublon.

Personnalisation par marque

{{IMAGEGENSPECIFIC_RULES}}

Exemples de prompts qui fonctionnent

{{IMAGEGENEXAMPLES}}

Skills associées

• carousel / slides / social-content — consommateurs des visuels produits ici
• brand-check — validation de conformité sur le sidecar en cas de doute

Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

• Author: Littlpinguin
• Source: Littlpinguin/marketing-cockpit-template
• License: MIT

Install and usage instructions live in the source repository linked above.