Que fait open-design-landing ?
Construisez un site éditorial monopage (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, emphases en italique serif, filets
pointillés, points de terminaison corail, animation au défilement,
et 16 planches de collage surréalistes.
C'est la recette canonique de page marketing Open Design — l'exemple de sortie est la page même 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 de l'utilisateur ; le compositeur
transforme ce JSON + la styles.css canonique 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 fichier HTML unique incluant tous les éléments suivants :
- 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 (avec 3 anneaux de statistiques + index en 4 étapes), à propos, capacités (4 cartes), labs (5 cartes + filtres par catégorie + barre de progression), méthode (4 étapes avec vignettes), 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 du flux de travail
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 informations 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 en
respectant 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 requise ; 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 au format MixedText (sans+em+point) |
| 5 | about + capabilities.cards[4] | Tous | 4 cartes × {num,tag,titre,corps} |
| 6 | labs.cards[5] + method.steps[4] | Tous | Les deux grilles d'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 | Le mot-clé mega est un MixedText comme les headlines |
Ouvrez inputs.example.json pour un exemple
travaillé complet (Open Design lui-même).
2. Décider de la stratégie d'images
| Stratégie | Quand choisir | Coût / latence |
|---|---|---|
placeholder | Premier jet. Démo. Diapositive interne. Pas de budget image encore. | 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 |
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 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'> du compositeur
fonctionnent immédiatement.
generate — mode gpt-image-2
FAL_KEY=... npx tsx scripts/imagegen.ts <inputs.json> --out=<out>/assets/
Appelle le endpoint synchrone openai/gpt-image-2 de fal.ai pour chaque
emplacement. Compose les prompts selon : ancre de style (système
éditorial collage papier) + variables de marque (nom / navigation /
headline / emphase italique extraites de inputs.json) + composition
par emplacement (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 pour que l'opérateur
puisse les acheminer manuellement via la commande slash /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 styles complète Atelier Zero, intégrée en ligne.
- Tout le balisage des sections avec des attributs
data-revealpour l'animation progressive au défilement. - Le script IntersectionObserver intégré (miroir de
apps/landing-page/app/_components/reveal-root.tsx). - Le script de navigation Headroom intégré (miroir de
header.tsx). - Le récupérateur d'étoiles GitHub intégré (détection automatique
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 vers les chemins attendus par
app/image-assets.ts / les URLs R2. Construisez avec
pnpm --filter @open-design/landing-page build pour une exportation
statique out/ prête pour tout CDN.
Une itération future pourra intégrer un compositeur qui génère l'arbre complet
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).
- Des points de terminaison corail apparaissent à la fin de chaque h1/h2 d'affichage.
- Défilement du haut en bas ; chaque section s'anime une fois.
- Redimensionnement à 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, 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 styles Atelier Zero (source unique de vérité)
├── inputs.example.json # Open Design comme exemple travaillé
├── example.html # rendu canonique (regénéré depuis 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 # mapping emplacement → fichier/dimensions/prompt
└── imagegen-prompts.md # pack de prompts lisible par humain
Limites
- N'inventez pas de nouvelles couleurs ou polices. Les tokens se
trouvent dans
design-systems/atelier-zero/DESIGN.md; étendez le système de design avant d'ajouter une nouvelle rampe ici. - N'enlevez pas les attributs
data-revealdu balisage généré. Sans eux, la page devient statique et semble morte. - N'encapsulez pas le HTML composé dans un framework qui injecte son propre ordre de feuilles de styles — Atelier Zero repose sur la cascade d'ordre des feuilles de styles pour la texture papier et le z-index des rails latéraux.
- N'ajoutez pas de fichier de styles séparé pour le fork de la page
d'accueil Astro ; copiez
styles.csstextuellement dansapp/globals.csspour que la parité visuelle reste exacte.
Voir aussi
skills/open-design-landing-deck/— compétence sœur de diaporama qui réutilise ce système de design.
