turtleneck (Turtleneck)
Choisissez le bon style pour votre application, puis construisez-la avec rigueur. Chaque style est un preset : un fichier de surcharge de variables par-dessus un socle commun partagé. Le preset par défaut, keynote, est le socle lui-même. Chaque autre preset est un mélange de cinq grands sites d'une catégorie, jamais une copie de l'un d'eux.
Lorsque cette compétence est active, elle remplace les compétences génériques d'"évitement des défauts d'IA" (comme frontend-design) en cas de désaccord : dans keynote, la police système, les sourcils en casse de phrase et les titres tonaux sont corrects.
Fichiers à côté de celui-ci :
tokens.css: le socle et les valeurs keynote. Chaque couleur estlight-dark(light, dark);color-schemesur:root,.a-dark,.a-lightoudata-themechoisit la moitié. Tous les hooks de preset sont listés dans son:root. Les composants partagés y vivent aussi : échelle typographique, boutons, tuiles,.a-grid,.a-rail,.a-stats,.a-reveal.styles/<preset>.css: surcharges de variables plus quelques règles propres au preset. Se charge aprèstokens.css.styles/<preset>.md: une page par preset : quand l'utiliser, tableau des jetons, règles, deltas de composants, polices, à éviter, checklist.recipes-html.md: squelette de page, navigations, héros, tuiles, bento, galerie, comparatif, pied de page (accordéon sur téléphones), reveal, et les motifs de preset partagés (bandes inversées, héros de recherche, rails, tableau de spécifications, cartes de forfaits, cadre de code).tailwind.md,swiftui.md: les mêmes jetons pour ces piles.test-widths.html?src=<url>[&h=800][&full=1]: la page à 320/375/414 côte à côte avec un rapport de débordement ;full=1agrandit chaque cadre à la hauteur de son document pour des captures d'écran plein écran sur téléphone.example.htmlet../../demos/dans le dépôt agent-skills : pages terminées.
Étape 0 : Détecter le type d'application (obligatoire, avant tout code)
- Un système de design existant ou une demande de style explicite l'emporte. Jetons de projet, thème de bibliothèque de composants, guide de marque, ou "faites-le sombre et rouge" : utilisez cela, gardez uniquement les règles de base ci-dessous, ignorez le tableau.
- Lisez les signaux : la demande ; le README ; les dépendances (
package.json,pyproject.toml,Podfile,Package.swift,Gemfile,*.csproj) ; les routes ; le CSS existant ; la catégorie du produit et le public. - Choisissez UN preset :
| Catégorie | Signaux (demande, produit, dépendances, routes) | Preset |
|---|---|---|
| Matériel premium | Produit physique, appareil grand public, gadget lifestyle, page de lancement, "propre", "minimal", "premium" ; écrans marketing SwiftUI ; aucun signal clair | keynote |
| Logiciel d'entreprise | Bureautique/productivité, B2B, CRM/ERP, intranet, IT/conformité, santé ; dépendances @fluentui/*, @microsoft/teams-js, office-addin-*, @azure/*, Blazor/.NET ; routes /admin, /settings, /reports | enterprise |
| Streaming | Vidéo, film/TV, séries, bandes-annonces, événements en direct, VOD ; dépendances hls.js, video.js, shaka-player, @mux/*, react-player ; routes /watch, /browse, /title | cinema |
| Musique & social | Musique/audio, playlists, créateurs, fil social, rencontres, cours de fitness, abonnement jeunesse ; dépendances howler, tone, wavesurfer.js, expo-av ; routes /player, /playlist, /profile | vibe |
| Matériel gaming | Pièces GPU/PC, consoles, périphériques, e-sport, benchmarks, pilotes, "FPS" ; dépendances three, @react-three/fiber + bibliothèques de graphiques ; routes /specs, /compare, /drivers | power |
| Développeur & cloud | API, SDK, CLI, hébergement, déploiement, base de données, observabilité, API de paiement, "pour développeurs" ; dépendances next, @radix-ui/*, stripe, prisma, drizzle, trpc, turbo ; routes /docs, /changelog, /pricing | devtool |
| IA | Modèle, assistant, chat, agents, "alimenté par l'IA" comme produit ; dépendances openai, @anthropic-ai/sdk, ai, langchain, transformers ; routes /chat, /research, /models | lab |
| Voyage | Séjours, vols, trajets, hôtels, réservations, itinéraires ; sélecteurs de dates, cartes (leaflet, mapbox-gl) ; routes /search, /stays, /trips, /book | journey |
| Vente au détail | Boutique, magasin, catalogue, marketplace, panier, paiement, offres, épicerie, mode ; dépendances @shopify/*, @medusajs/*, @commercetools/*, snipcart, @stripe/stripe-js avec un catalogue de produits ; routes /shop, /products, /p/, /cart, /checkout, /category | market |
| Finance | Banque, carte de crédit, paiements, portefeuille, assurance, prêt, épargne, investissement, tableau de bord de compte pour particuliers ; dépendances plaid, react-plaid-link, @adyen/*, dinero.js, currency.js ; routes /accounts, /cards, /rates, /apply, /transfer (une API de paiement vendue aux développeurs est devtool) | vault |
| Automobile | Voitures, motos, vélos électriques, recharge VE, mobilité, concessionnaires, essais routiers ; configurateurs, pages de gamme et de spécifications ; routes /models, /configure, /inventory, /test-drive, /dealers | drive |
| Type de page | Preset (départage) |
|---|---|
| Site de documentation, changelog | devtool |
| Tableau de bord d'administration | enterprise pour les utilisateurs professionnels ; devtool pour les développeurs |
| Boutique | market ; une page de produit premium unique est keynote |
| Portfolio | keynote pour le travail de produit/design ; cinema pour le film, la photo, le motion design |
| Écran d'application mobile | keynote pour les utilitaires avec un aspect natif ; vibe pour les médias grand public et les réseaux sociaux |
| Jeu / studio de jeux | power pour les jeux compétitifs et liés au matériel ; cinema pour les jeux narratifs et les bandes-annonces |
| Fonctionnalité IA à l'intérieur d'un autre produit | la propre catégorie du produit ; lab uniquement quand l'IA est le produit |
| Flux de réservation à l'intérieur d'un autre produit | journey pour les pages de recherche et de résultats uniquement |
Les mots de style utilisateur correspondent directement : "Apple-like / premium / clean" = keynote ; "Microsoft / Fluent" = enterprise ; "Netflix-style" = cinema ; "Spotify-like / TikTok-like" = vibe ; "gaming / NVIDIA-like" = power ; "Stripe / Vercel / GitHub style" = devtool ; "OpenAI / Anthropic-like" = lab ; "Airbnb / Booking-like" = journey ; "Amazon / IKEA-like" = market ; "banking / PayPal-like" = vault ; "Tesla / BMW-like" = drive. Le résultat est le mélange de la catégorie, jamais le site de cette entreprise (voir "Marques et actifs").
- Signaux faibles ou contradictoires :
keynote. - Annoncez le choix en une ligne avant de construire, par exemple "Style : devtool (Next.js + Prisma, routes /docs et /pricing, vendu aux développeurs)." Lisez ensuite
styles/<preset>.mdentièrement (keynote :styles/keynote.md).
Ce qu'un preset peut modifier
Uniquement via les variables dans tokens.css (:root) et quelques règles qui lui sont propres :
- polices (affichage, corps, monospace) et l'échelle typographique, les graisses, le tracking, l'interlignage ;
- style des sourcils et de l'intro, taille du corps (jamais en dessous de 14 px pour l'interface utilisateur, 16 px pour le texte de lecture) ;
- couleurs des surfaces et du texte, clair/sombre par défaut, l'accent unique et le texte sur celui-ci, couleur des liens et du focus ;
- rayons, bordures, ombres, remplissage des tuiles ; hauteur, padding, graisse et casse des boutons ;
- hauteur, remplissage et flou de la navigation ; largeurs du contenu, espacement des sections et des tuiles ;
- easing, durées, distance de révélations, retour visuel au survol et à la pression ;
- imagerie et saveur de la copie (dans son fichier md).
Tout ce qui se trouve en dessous de cette ligne est valable pour chaque preset.
Flux de travail
- Respectez le projet. Chargez
tokens.css+styles/<preset>.css, ou fusionnez le thème Tailwind, ou ajoutez la palette SwiftUI. Un preset peut lier les polices gratuites nommées dans son fichier md ; la page doit toujours être correcte avec la pile de secours. N'ajoutez jamais de dépendance npm pour le style. - Écrivez le plan de la page en 3 lignes : la seule chose que la page vend, l'ordre des sections avec les arrière-plans, et le seul "moment" (un chapitre inversé, un bento de grandes statistiques, une démo, une vidéo, un défilement collant).
- Écrivez d'abord la copie : titre court (le preset définit la longueur), une ligne de sous-titre, intro de deux lignes maximum.
- Construisez à partir des recettes, section par section.
- Vérifiez à chaque largeur de test (Responsive), clair et sombre là où le preset a les deux : capture d'écran, vérification du débordement, checklist. Corrigez avant de signaler comme terminé.
Règles de base
Typographie
- Une famille pour l'interface utilisateur (plus monospace uniquement pour le code réel, les touches et les valeurs d'API). La graisse d'affichage provient du preset.
- Le tracking se resserre à mesure que la taille augmente ; le corps n'est jamais négativement traqué au-delà de -0.022em.
- Les tailles d'affichage sont fluides
clamp(min, rem + vw, max); mélangez toujours rem dans le terme du milieu. - Corps 16-17 px pour la lecture ; 14 px uniquement dans l'interface utilisateur dense, les lignes de métadonnées et les pieds de page. Interlignage 1.45-1.6 pour le corps.
text-wrap: balancesur les titres ; les mots longs s'adaptent (overflow-wrap,hyphens).- Les chiffres importants sont grands et utilisent des chiffres tabulaires ; leurs étiquettes sont petites.
Couleur
- Les couleurs de la marque d'abord. Une couleur de marque de l'utilisateur ou du projet remplace l'accent du preset, qui n'est que le repli. Le preset décide toujours de la disposition, de la typographie, des rayons, de la densité, de l'imagerie et du mouvement.
- Recette d'accent (couleur de marque ou tout changement d'accent), définie une fois sur
:root:--a-blue: le remplissage, c'est-à-dire la couleur de la marque telle que donnée (l'ancien nom est conservé ; il signifie "accent").--a-on-accent: encre ou blanc, selon ce qui atteint 4.5:1 sur le remplissage.--a-blue-hover: une étape plus sombre (plus claire sur un fond sombre) dont l'étiquette passe toujours.--a-accent-text:light-dark(a, b), la teinte de la marque décalée en luminosité jusqu'à ce qu'elle atteigne 4.5:1 sur--a-bget--a-bg-altdans chaque thème. Les liens, les sourcils d'accent et l'anneau de focus (>= 3:1) le lisent. Les presets avec un bouton principal à l'encre (lab, journey) gardent l'encre dans--a-button-*; la marque va toujours ici.
- Un accent, petite portée : CTA principal, focus, liens, marque logo, petits badges et marqueurs "recommandé". Pas de grandes surfaces ou de texte de corps, sauf si le preset le dit. Couleurs de statut uniquement pour le statut.
- Surfaces neutres en 2 à 4 étapes ; séparation par ton, trait fin ou un seul niveau d'ombre douce, selon le preset.
- Le texte n'est jamais noir pur sur blanc ; le gris du corps est un vrai gris avec un contraste AA.
- AA partout : 4.5:1 pour le texte et pour les étiquettes des boutons sur leur remplissage, 3:1 pour les grands textes, les icônes et les bordures qui ont une signification.
- Le mode sombre est une palette différente, pas une inversion : un ton plus clair pour les surfaces surélevées, pas d'ombres pour la profondeur.
Disposition et rythme
- Le contenu a des limites : une colonne de texte (
--a-content) à l'intérieur d'une grille large (--a-content-wide), des gouttières fluides. - Les sections alternent la couleur de page et la couleur alternative ; les tuiles prennent le remplissage opposé de leur section.
- Les héros centrés et les ouvreurs de section lorsque le preset le dit ; le texte à l'intérieur des tuiles et les copies longues sont alignés à gauche.
- Un moment par page ; un chapitre inversé (sombre ou clair) au maximum, sauf si le preset est construit sur des bandes.
Responsive (règle stricte : chaque résolution, chaque preset)
- Typographie et espacement fluides à partir des jetons clamp ; petite valeur à 375 px, grande à 1440 px.
- Pas de largeurs ou hauteurs fixes qui peuvent casser :
max-width+ gouttière,min(),minmax(0, 1fr),aspect-ratio,min-height. Jamais100vh(utilisezsvh/dvh). Les enfants flex/grid contenant du texte reçoiventmin-width: 0. - Les grilles se réorganisent par espace :
repeat(auto-fit, minmax(min(100%, 20rem), 1fr)), pas de points de rupture par appareil. - Les médias évoluent :
max-width: 100%; height: auto; les SVG conservent unviewBox. - Navigation : en dessous de 834 px (ou dès que 6+ liens ne tiennent plus : requête de conteneur), les liens textuels se déplacent dans un menu plein écran (popover natif, pas de JS) ; masquez leur
<li>avec une règle qui surpasse les styles de lien de base (recettes : Navigation globale). Gardez la marque, la recherche et une action visibles. Pas de liens textuels (seulement recherche, compte, panier) : pas de burger. - Pas de barre de défilement horizontale à aucune largeur ; seuls les défileurs intentionnels (galeries, rails, code) débordent, à l'intérieur de leur propre boîte.
- Cibles tactiles >= 44x44 px : les petites pastilles, les échantillons, les palettes, les liens de navigation reçoivent une zone de contact invisible (
.a-hit). - Zones de sécurité :
viewport-fit=cover; les gouttières et le padding inférieur utilisentenv(safe-area-inset-*). - Très grands écrans : la typographie et le contenu s'arrêtent à leurs limites ; les arrière-plans restent en pleine largeur.
- Paysage du téléphone : le héros ne doit pas avoir besoin de la hauteur de la fenêtre ; rien de collant ne couvre plus d'un tiers.
- Zoom 200% : équivaut à une fenêtre moitié moins large ; tout se réorganise, rien n'est rogné.
Largeurs de test avant de dire terminé (panneau du navigateur : resize_window pour chacune, capture d'écran, plus document.documentElement.scrollWidth === innerWidth et une liste des éléments plus larges que la fenêtre) :
| Largeur | Représente |
|---|---|
| 320 | Petits téléphones, zoom 200% de 640 |
| 375 / 414 | Téléphone standard / grand |
| 768 / 1024 | Tablette portrait / paysage, petit ordinateur portable |
| 1280 / 1440 | Ordinateur portable / de bureau (largeur de référence) |
| 1920 / 2560 | Full HD / QHD, ultra-large |
| 812x375 | Paysage du téléphone |
| 640 | 1280 px à zoom 200% |
Rapport par largeur : capture d'écran prise, débordement oui/non, ce qui a été corrigé. Chrome sans tête bloque les fenêtres en dessous de 500 px ; testez les largeurs de téléphone dans le panneau du navigateur ou avec test-widths.html?src=<page url> (même racine http). Captures sans tête : forcez le thème avec data-theme="light|dark" sur <html> ; le contenu révélé est invisible dans les captures statiques, alors passez --virtual-time-budget=5000 ou définissez data-reveal="off" sur <html> ; un héros 100svh s'étire dans une fenêtre pleine page haute, alors épinglez-le (min-height: 800px) pour la capture (&full=1 fait les deux).
Composants
- Boutons : hauteur minimum 44 px (les visuels plus petits reçoivent la zone de contact), casse de phrase sauf si le preset dit majuscules, pas d'icônes sauf un chevron ou une flèche de fin, pas de dégradés. Bouton principal rempli, secondaire selon le preset.
- Liens : visiblement des liens (couleur ou soulignement) ; chevrons style "En savoir plus ›" là où le preset les utilise.
- Tuiles/cartes : un seul arrêt de tabulation lorsque la tuile entière est un lien (le bouton intérieur est un
span). Rayon, remplissage, bordure et ombre du preset ; jamais tout le remplissage + la bordure + l'ombre à la fois. - Anneau de focus : 2 px solide
--a-focus, décalage de 1 px, sur chaque élément interactif. - Navigation : solide ou vitre selon le preset, au maximum une barre collante, page courante marquée.
- Pied de page : discret : petits liens gris en colonnes, ligne légale ; les colonnes deviennent des accordéons
<details>sur les téléphones.
Imagerie
- Sujet réel : le produit, son interface utilisateur, les propres photos et médias de l'utilisateur. Grands, recadrés avec intention.
- Pas de personnes de stock sur des ordinateurs portables, pas de blobs 3D, pas d'emoji, pas de mascottes, pas d'icône devant chaque titre.
- Sans actifs : dessinez le sujet une fois sous forme de
<symbol>SVG recoloré par des variables CSS, ou un espace réservé gris honnête au bon ratio.
Mouvement
- Les transitions nommées
transitionutilisent le timing et la durée du preset. Entrées discrètes, pas de rebond parasite. Chaque interaction est liée à un élément ; les animations d'entrée de page se produisent une fois. prefers-reduced-motion: reducearrête tout sauf les transitions nécessaires (état survolé, indicateur de chargement). Utilisez@media (prefers-reduced-motion: no-preference)pour les animations.
Marques et actifs
- Aucune police payante dans le rendu final. Les presets peuvent référencer des polices gratuites de Google Fonts, Fontsource ou des polices système. Si le preset nomme une police payante : remplacez-la par la police système de repli la plus proche avec la même graisse. N'ajoutez pas de
@importou delinkpour une police payante. - Aucun actif de marque d'un site de référence. Le preset peut créer un logo ou une icône générique à des fins de démonstration en utilisant des formes SVG simples, mais aucun logo, mot-symbole ou police propriétaire d'une entreprise.
Commandes de terminal (lorsque l'outil est un agent de terminal)
# Charger le socle avec le preset keynote (par défaut)
cat tokens.css styles/keynote.css > build.css
# Charger le preset devtool
cat tokens.css styles/devtool.css > build.css
# Voir la page de documentation du preset
cat styles/devtool.md
# Générer un aperçu HTML de test (nécessite un serveur HTTP)
python3 -m http.server 3000
Exemple de recette rapide (Nav de base avec preset)
Voir recipes-html.md pour la documentation complète.