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, emphase italique avec sérif, règles pointillées, points de terminaison corail, animation au défilement et 16 planches de collage surréalistes.
C'est la recette canonique de la page marketing 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 inputs.json typé à partir du brief de l'utilisateur ; le compositeur transforme ce JSON + le 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 seul fichier HTML avec tous les éléments suivants :
- Barre éditoriale (volume / numéro / langue), barre de navigation collante de style 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 en 4 étapes), à propos, capacités (4 cartes), labs (5 cartes + filtres + barre de progression), méthode (4 étapes avec vignettes), travail sélectionné (dalle sombre + 2 cartes inclinées), témoignage (citation + 5 glyphes partenaires), CTA (ruban + pilule email).
- Pied de page avec 4 colonnes de liens + grand mot-clé italique sérif.
- 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 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 entrées de la marque
Utilisez AskQuestion (ou l'équivalent dans votre interface) pour recueillir
le brief de la marque par morceaux ; ne déversez pas tout le schema.ts sur l'utilisateur.
Mappez leurs réponses dans inputs.json correspondant à la structure 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 = un seul glyphe (Ø, ▲, ★…) |
| 2 | brand.{license,version,year,primary_url,contact_email} | 4 | URL est 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 tant que MixedText (sans+em+point) |
| 5 | about + capabilities.cards[4] | Tous | 4 cartes × {num,tag,title,body} |
| 6 | labs.cards[5] + method.steps[4] | Tous | Les deux grilles fixes |
| 7 | work.cards[2] + testimonial | Tous | 5 glyphes partenaires sous forme de données de chemin SVG en ligne |
| 8 | cta + footer.{columns[4],mega} | Tous | Le mot-clé mega 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. Diaporama 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 dans 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 des alias .png pour la 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 simplement.
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 par emplacement.
Compose les prompts ainsi : ancre de style (système éditorial collage papier)
- variables de marque (nom / navigation / headline / emphase italique extraites
de
inputs.json) + composition par emplacement (par exemple tête en plâtre recadrée + arbre poussant à travers une arche). Ignore les emplacements dont le fichier existe déjà ; passez--forcepour regénérer.
Sans FAL_KEY, le script affiche les prompts pour que l'opérateur puisse
les transmettre manuellement via la compétence 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 style complète Atelier Zero, intégrée en ligne.
- Tout le balisage des sections avec attributs
data-revealpour une animation de défilement échelonnée. - Script IntersectionObserver en ligne (reflète
apps/landing-page/app/_components/reveal-root.tsx). - Script de navigation Headroom en ligne (reflète
header.tsx). - Récupérateur de comptage d'étoiles GitHub en ligne (détecté automatiquement depuis
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 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 regrouper un compositeur qui génère l'arborescence complète
apps/landing-page/à partir deinputs.jsonen une seule commande. En attendant, forker et éditer est le chemin pris en charge.
Auto-vérification avant livraison
Avant de marquer la tâche comme terminée, 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 des DevTools).
- Les emphase italiques des headlines s'affichent en Playfair (pas en sans).
- Les points de terminaison corail apparaissent à chaque fin de h1/h2
display. - Faites défiler du haut en bas ; chaque section s'anime une fois.
- Redimensionnez à 880 px et 560 px ; 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 dans 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 (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 l'humain
Limites
- Ne pas inventer de nouvelles couleurs ou polices. Les tokens vivent 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 morte. - Ne pas encapsuler le HTML composé dans un framework qui injecte son propre ordre de feuilles de style — Atelier Zero repose sur la cascade d'ordre des feuilles de style pour la texture du papier et le z-index des rails latéraux.
- Ne pas ajouter un 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 tokens.apps/landing-page/— équivalent statique Astro déployable.skills/open-design-landing-deck/— compétence sœur de diaporama qui réutilise ce système de design.
