Que fait open-design-landing ?
Construisez un site d'atterrissage éditorial d'une seule page (ou un diaporama — voir la compétence sœur open-design-landing-deck) dans le système de design Atelier Zero : fond papier chaud, Inter Tight + Playfair Display, empans d'emphase en italique serif, règles en pointillés corail, points de terminaison corail, animation au défilement et 16 planches de collage surréalistes.
Il s'agit de la recette canonique de la page marketing OpenDesign — l'exemple de sortie est exactement la page que vous voyez sur open-design.
La compétence est entièrement paramétrée. L'agent remplit un inputs.json typé à partir du brief utilisateur ; le compositeur transforme ce JSON + la feuille de style canonique styles.css en un artefact déployable.
inputs.json + styles.css 16 emplacements d'images
│ │
└──────────► scripts/compose.ts ◄────────────┘
│
▼
<out>/index.html (autonome)
<out>/assets/ (PNG ou SVG)
Ce que vous obtenez
Un seul fichier HTML avec tous les éléments suivants :
- Barre supérieure éditoriale (volume / numéro / bandeau de langue), navigation sticky Headroom avec compteur d'étoiles GitHub en direct.
- 8 sections numérotées en chiffres romains avec arrière-plan texturé papier : héros (avec 3 anneaux de stats + index en 4 étapes), à propos, capacités (4 cartes), labs (5 cartes + filtres à pilules + barre de progression), méthode (4 étapes avec vignettes), travaux sélectionnés (dalle sombre + 2 cartes inclinées), témoignage (citation en attrait + 5 glyphes partenaires), CTA (ruban + pilule e-mail).
- Pied de page avec 4 colonnes de liens + grand mot-clé italique serif.
- Animation au défilement sur chaque section (IntersectionObserver, respecte
prefers-reduced-motion). - Entièrement responsive aux points de rupture 1280 / 1080 / 880 / 560.
Contrat de workflow
Exécutez ces quatre étapes dans l'ordre. L'agent doit terminer chaque étape avant de passer à la suivante, et préférer poser une question ciblée à l'utilisateur plutôt que d'inventer du contenu.
1. Recueillir les entrées de marque
Utilisez AskQuestion (ou l'équivalent dans votre interface) pour collecter le brief de marque par morceaux ; ne déversez pas l'intégralité du schema.ts sur l'utilisateur. Mappez leurs réponses dans inputs.json selon la forme typée.
Les huit groupes de questions, dans l'ordre :
| Groupe | Champs du schéma | Réponses min | Notes |
|---|---|---|---|
| 1 | brand.{name,mark,tagline,description,location} | 5 | Mark = glyphe unique (Ø, ▲, ★…) |
| 2 | brand.{license,version,year,primary_url,contact_email} | 4 | URL obligatoire ; licence par défaut Apache-2.0 |
| 3 | nav[] (jusqu'à 5) | 3 | Badges de comptage optionnels |
| 4 | hero.{label,headline,lead,primary,secondary,stats} | Tous | Headline en MixedText (sans+em+dot) |
| 5 | about + capabilities.cards[4] | Tous | 4 cartes × {num,tag,title,body} |
| 6 | labs.cards[5] + method.steps[4] | Tous | Les deux grilles à arité fixe |
| 7 | work.cards[2] + testimonial | Tous | 5 glyphes partenaires en tant que données de chemin SVG en ligne |
| 8 | cta + footer.{columns[4],mega} | Tous | Le mot-clé mega est un MixedText comme les titres |
Ouvrez inputs.example.json pour un exemple complet (OpenDesign lui-même).
2. Décider de la stratégie d'images
| Stratégie | Quand choisir | Coût / latence |
|---|---|---|
placeholder | Premier passage. Démo. Interne. Pas encore de budget image. | 0 €, <1s |
generate | Livraison finale. La marque veut des collages originaux. | ~0,40 €, ~6 min |
bring-your-own | L'utilisateur a des PNG de direction artistique. Déposez-les à assets_path. | 0 €, 0s |
Réglez inputs.imagery.strategy en conséquence.
placeholder — mode cadre
npx tsx scripts/placeholder.ts <out>/assets/
Écrit 16 fichiers .svg (avec des alias .png pour compatibilité) dans <out>/assets/. Chaque placeholder montre l'identifiant de l'emplacement, le ratio, les dimensions en pixels et l'indice de prompt du image-manifest.json. Les <img src='./assets/hero.png'> etc. du compositeur fonctionnent directement.
generate — mode gpt-image-2
FAL_KEY=... npx tsx scripts/imagegen.ts <inputs.json> --out=<out>/assets/
Appelle le point de terminaison synchrone openai/gpt-image-2 de fal.ai par emplacement. Compose les prompts comme suit : ancre de style (système éditorial collage papier) + variables de marque (nom / nav / titre / emphase italique extraite de inputs.json) + composition par emplacement (par exemple, tête en plâtre recadrée + arbre traversant une arche). Ignore les emplacements dont le fichier cible existe déjà ; passez --force pour régénérer.
Sans FAL_KEY, le script affiche les prompts afin que l'opérateur puisse les acheminer manuellement via la compétence slash-command /gpt-image-fal.
bring-your-own
Déposez 16 PNG correspondant aux noms de fichiers de assets/image-manifest.json dans inputs.imagery.assets_path. Terminé.
3. Composer l'artefact
npx tsx scripts/compose.ts <inputs.json> <out>/index.html
Le compositeur lit inputs.json et ../styles.css, puis écrit un fichier HTML autonome. La page inclut :
- La feuille de style complète Atelier Zero, intégrée.
- Tout le balisage des sections avec des attributs
data-revealpour un mouvement de défilement échelonné. - Script IntersectionObserver en ligne (miroir de
apps/landing-page/app/_components/reveal-root.tsx). - Script de navigation Headroom en ligne (miroir de
header.tsx). - Récupérateur de comptage d'étoiles GitHub en ligne (auto-détection à partir de
brand.primary_url).
4. (Optionnel) Refléter le site Astro déployable
Pour une sortie de production déployable, forkez le package apps/landing-page/ : copiez-le dans votre espace de travail, alignez app/page.tsx avec le contenu de votre inputs.json, et copiez vos <out>/assets/*.png dans les chemins attendus par app/image-assets.ts / les URLs R2. Compilez avec pnpm --filter @open-design/landing-page build pour un export statique out/ prêt pour n'importe quel CDN.
Une itération future pourrait fournir un compositeur qui génère l'arborescence complète
apps/landing-page/à partir deinputs.jsonen une seule commande. En attendant, la méthode fork-and-edit est la voie prise en charge.
Auto-vérification avant livraison
Avant de marquer comme terminé, l'agent doit vérifier :
-
<out>/index.htmls'ouvre dans un navigateur sans erreur console. - Les 16 emplacements d'images se chargent (pas de 404 dans l'onglet réseau DevTools).
- Les empan d'emphase en italique des titres s'affichent en Playfair (pas en sans).
- Les points de terminaison corail apparaissent à chaque fin de h1/h2 d'affichage.
- Défilez du haut en bas ; chaque section s'anime une fois.
- Redimensionnez à 880px et 560px ; pas de défilement horizontal, pas de chevauchement.
-
prefers-reduced-motion: reduce(DevTools → Rendu) désactive les transitions proprement. - Lighthouse : contraste AA,
font-display: swap, aucun décalage de mise en page sur le héros (CLS < 0,05).
Fichiers dans cette compétence
design-templates/open-design-landing/
├── SKILL.md # ce contrat
├── README.md # démarrage rapide
├── schema.ts # entrées typées (source de vérité unique)
├── styles.css # feuille de style Atelier Zero (source de vérité unique)
├── inputs.example.json # OpenDesign comme exemple concret
├── example.html # rendu canonique (régénéré à partir de inputs.example.json)
├── scripts/
│ ├── compose.ts # inputs.json + styles.css → index.html
│ ├── imagegen.ts # wrapper gpt-image-2 (fal.ai)
│ └── placeholder.ts # cadres texturés papier SVG
└── assets/
├── *.png # 16 planches de collage (instance OpenDesign)
├── image-manifest.json # emplacement → mapping fichier/dimensions/prompt
└── imagegen-prompts.md # pack de prompts lisible par l'humain
Limites
- N'inventez pas de nouvelles couleurs ou polices. Les jetons vivent dans
design-systems/atelier-zero/DESIGN.md; étendez le système de design avant d'ajouter une nouvelle rampe ici. - N'omettez pas les attributs
data-revealdu balisage généré. Sans eux, la page devient statique et semble sans vie. - N'enveloppez pas le HTML composé dans un framework qui injecte son propre ordre de feuille de style — Atelier Zero dépend de la cascade d'ordre des feuilles de style pour la texture papier et le z-index des rails latéraux.
- N'ajoutez pas de fichier de feuille de style séparé pour le fork de la page d'atterrissage Astro ; copiez
styles.csstextuellement dansapp/globals.csspour que la parité visuelle reste un pour un.
Voir aussi
design-systems/atelier-zero/DESIGN.md— spécification des jetons.apps/landing-page/— contrepartie statique Astro déployable.design-templates/open-design-landing-deck/— compétence sœur de diapositives qui réutilise ce système de design.
