Que fait open-design-landing ?
Construisez un site éditorial sur une seule page (ou un deck de diapositives — 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, emphases en italique serif, filets en pointillés, points terminaux corail, animations au défilement et 16 planches de collage surréalistes.
Il s'agit de la recette canonique de la page marketing d'Open Design — l'exemple de sortie est la page que vous voyez sur open-design.
La compétence est entièrement paramétrée. L'agent remplit un fichier inputs.json typé à partir du brief utilisateur ; le compositeur transforme ce JSON et 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 tout ceci :
- Barre éditoriale supérieure (volume / numéro / langue), navigation sticky de type Headroom avec compteur d'étoiles GitHub en direct.
- 8 sections numérotées en chiffres romains avec fond texturé papier : hero (3 anneaux de statistiques + index 4 étapes), à propos, capacités (4 cartes), labs (5 cartes + filtres + barre de progression), méthode (4 étapes avec miniatures), travaux sélectionnés (dalle sombre + 2 cartes inclinées), témoignage (citation en exergue + 5 glyphes partenaires), CTA (ruban + pilule email).
- Pied de page avec 4 colonnes de liens + un grand mot-clé en 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 déroulement
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 la marque
Utilisez AskQuestion (ou l'équivalent dans votre UI) pour collecter le brief de la marque par morceaux ; ne déversez pas l'intégralité de schema.ts sur l'utilisateur. Mappez leurs réponses dans inputs.json en respectant la structure typée.
Les huit groupes de questions, dans l'ordre :
| Groupe | Champs du schéma | Réponses min | Remarques |
|---|---|---|---|
| 1 | brand.{name,mark,tagline,description,location} | 5 | Mark = un seul glyphe (Ø, ▲, ★…) |
| 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 données de chemin SVG inline |
| 8 | cta + footer.{columns[4],mega} | Tous | Mega kicker est un MixedText comme les headlines |
Ouvrez inputs.example.json pour un exemple complet (Open Design lui-même).
2. Décider de la stratégie d'images
| Stratégie | Quand choisir | Coût / latence |
|---|---|---|
placeholder | Premier passage. Démo. Diapo interne. Pas de budget image encore. | 0 €, <1 s |
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 dans assets_path. | 0 €, 0 s |
Définissez inputs.imagery.strategy en conséquence.
placeholder — mode cadre
npx tsx scripts/placeholder.ts <out>/assets/
Écrit 16 fichiers .svg (avec alias .png pour compatibilité) dans <out>/assets/. Chaque placeholder affiche l'identifiant de l'emplacement, le ratio, les dimensions en pixels et l'indice de prompt provenant de image-manifest.json. Les balises <img src='./assets/hero.png'> du compositeur fonctionnent simplement.
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 pour chaque emplacement. Compose les prompts comme suit : ancre de style (système éditorial collage papier) + variables de marque (nom / nav / headline / emphase italique issues de inputs.json) + composition par emplacement (par ex. tête en plâtre recadrée + arbre poussant à travers une arche). Ignore les emplacements dont le fichier cible existe déjà ; passez --force pour regénérer.
Sans FAL_KEY, le script affiche les prompts afin que l'opérateur puisse les router manuellement via la compétence slash-command /gpt-image-fal.
bring-your-own
Déposez 16 PNG correspondant aux noms de fichier 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 d'Atelier Zero, inline.
- Tout le balisage des sections avec attributs
data-revealpour une animation au défilement décalée. - Un script IntersectionObserver inline (miroir de
apps/landing-page/app/_components/reveal-root.tsx). - Un script de navigation Headroom inline (miroir de
header.tsx). - Un récupérateur de compteur d'étoiles GitHub inline (auto-détecté depuis
brand.primary_url).
4. (Optionnel) Miroir du 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 URL R2. Compilez avec pnpm --filter @open-design/landing-page build pour une exportation statique out/ prête pour n'importe quel CDN.
Une itération future pourrait inclure un compositeur qui génère l'arborescence complète de
apps/landing-page/à partir deinputs.jsonen une seule commande. D'ici là, le fork-édition est le chemin pris 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 emphases en italique des headlines s'affichent en Playfair (pas en sans).
- Les points terminaux corail apparaissent à chaque fin de h1/h2 d'affichage.
- Défilement du haut en bas ; chaque section s'anime une fois.
- Redimensionnement à 880 px et 560 px ; pas de défilement horizontal, pas de chevauchement.
-
prefers-reduced-motion: reduce(DevTools → Rendu) désactive proprement les transitions. - Lighthouse : contraste AA,
font-display: swap, pas de décalage de mise en page sur le hero (CLS < 0,05).
Fichiers de cette compétence
skills/open-design-landing/
├── SKILL.md # ce contrat
├── README.md # démarrage rapide
├── schema.ts # entrées typées (source unique de vérité)
├── styles.css # feuille de style Atelier Zero (source unique de vérité)
├── inputs.example.json # Open Design comme exemple travaillé
├── 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 SVG texturés papier
└── assets/
├── *.png # 16 planches de collage (instance Open Design)
├── image-manifest.json # emplacement → mappage fichier/dimensions/prompt
└── imagegen-prompts.md # pack de prompts lisible humain
Limites
- Ne pas inventer de nouvelles couleurs ou polices. Les tokens résident dans
design-systems/atelier-zero/DESIGN.md; étendez le système de design avant d'ajouter une nouvelle rampe ici. - Ne pas supprimer les attributs
data-revealdu balisage généré. Sans eux, la page devient statique et semble vide. - Ne pas encapsuler le HTML composé dans un framework qui injecte son propre ordre de feuille de style — Atelier Zero repose sur la cascade d'ordre des feuilles de style pour la texture papier et l'index z des rails latéraux.
- Ne pas ajouter un fichier de feuille de style séparé pour le fork du site d'atterrissage Astro ; copiez
styles.csstextuellement dansapp/globals.csspour que la parité visuelle reste parfaite.
Voir aussi
design-systems/atelier-zero/DESIGN.md— spécification des tokens.apps/landing-page/— contrepartie statique Astro déployable.skills/open-design-landing-deck/— compétence diapositives sœur qui réutilise ce système de design.
