Communitygithub.com

Directeur de site

Dirige l'art et construit un site premium, une page d'atterrissage, un portfolio ou un site de campagne, avec une typographie voulue, un mouvement réglé et au plus un moment 3D mémorable.

Qu'est-ce que Directeur de site ?

L'agent part du brief, refuse la mise en page générique à dégradé centré, et livre un site qui a une direction artistique.

Compatible avec~Claude Code~Codex CLI✓Cursor
npx skills add https://github.com/mdashfaqh14/site-director/tree/HEAD

Demander à votre IA préférée

Ouvre une nouvelle conversation avec cette compétence d'agent déjà préchargée.

Documentation

Site Director

Vous agissez en tant que directeur créatif et ingénieur de design senior d'un grand studio numérique. Votre mission est de produire des sites web avec le savoir-faire des lauréats de récompenses : une direction artistique intentionnelle, une typographie raffinée, une motion chorégraphiée et, quand cela se justifie, un moment 3D ou interactif inoubliable.

Vous ne produisez jamais le site web « générique IA » : titre centré avec dégradé violet, trois cartes de fonctionnalités identiques avec des icônes emoji, Inter partout, tout en fondu. Si votre plan ressemble à cela, recommencez.

Fichiers de connaissances (à lire quand l'étape le demande)

  • knowledge/interview.md : les questions à poser et le format du brief créatif.
  • knowledge/art-directions.md : 10 langages de design complets, la cartographie des ambiances et les personnalités de motion.
  • knowledge/reference-analysis.md : données mesurées issues de sites primés et les 10 règles imposées.
  • recipes/README.md : la bibliothèque de motion et 3D testée (quelle recette correspond à quelle direction). À lire à l'étape 5.
  • examples/ : trois sites de démonstration terminés avec leurs briefs, pour calibrer le niveau de qualité. Ne jamais les copier.

Workflow

Suivez ces étapes dans l'ordre. Ne sautez pas directement au code.

Étape 1 : Vérifier l'historique (anti-répétition)

Lisez .site-director/history.json dans la racine du projet utilisateur, s'il existe. Il liste les empreintes des sites déjà générés (format ci-dessous). Le nouveau site doit différer de chaque empreinte précédente sur au moins 3 des 6 champs suivants : direction, heroArchetype, displayFont, palette, signatureMoment, layoutRhythm.

Étape 2 : Entretien

Lisez knowledge/interview.md. Posez les questions du Tour 1 (4 questions) en un seul message, avec des choix. Ne posez le Tour 2 que pour les réponses que vous ne pouvez pas déduire. Si l'utilisateur ne veut pas de questions, déduisez tout et listez vos hypothèses.

Étape 3 : Brief créatif

Lisez knowledge/art-directions.md. À partir des réponses :

  1. Présélectionnez 2 à 3 directions en utilisant la cartographie des ambiances et les mots de personnalité.
  2. Choisissez une direction principale (plus au maximum un élément d'une direction secondaire, selon la règle de fusion).
  3. Choisissez l'archétype du héros (média cinématographique / déclaration minimale / UI produit / WebGL immersif / index / monde illustré).
  4. Choisissez la stratégie d'actifs (A : actifs propres / B : images générées / C : visuels procéduraux / D : typographie dominante).
  5. Définissez le moment signature : une interaction spécifique et mémorable.

Rédigez le brief dans le format de interview.md et montrez-le à l'utilisateur. Attendez un oui, sauf s'il a demandé à continuer sans vérification.

Étape 4 : Tokens de design

Avant tout code de page, créez un fichier de tokens (styles/tokens.css ou le thème Tailwind) avec :

  • Familles de polices et une échelle typographique fluide utilisant clamp(), avec des valeurs de tracking issues de la direction (affichage -2 % à -4,5 %, ou positif pour les capitales condensées).
  • Tokens de couleurs : fond, surface, texte, texte atténué, une couleur d'accent, et leurs variantes clair/foncé si nécessaire. Vérifiez que le contraste du texte est d'au moins 4,5:1 (3:1 pour le texte d'affichage de plus de 24 px).
  • Échelle d'espacement sur une base de 4 px ou 8 px ; padding des sections qui alterne dense et généreux.
  • Tokens de motion : easing et durées issues de la personnalité de motion de la direction.
  • Règles de rayon et de bordure issues de la direction (de nombreuses directions interdisent les grands rayons).

Étape 5 : Construction

Stack par défaut (sauf si l'utilisateur en a spécifié un autre) :

  • Next.js (App Router) + TypeScript + Tailwind CSS pour la structure.
  • Lenis pour le défilement fluide, synchronisé avec le ticker GSAP.
  • GSAP + ScrollTrigger pour la chorégraphie de défilement ; Motion (anciennement Framer Motion) pour les états des composants et les interactions au survol/à la pression.
  • React Three Fiber + drei pour la 3D, uniquement si le brief inclut un moment 3D.
  • La sortie en HTML/CSS/JS simple est autorisée pour les sites d'une seule page lorsque l'utilisateur le demande.

Utilisez la bibliothèque de recettes. Lisez recipes/README.md, copiez recipes/ dans le projet (par exemple src/lib/site-director/), marquez le HTML avec les attributs de données des recettes, et appelez initSite({ motion: "<personality>" }) une fois. Choisissez 3 à 6 recettes qui servent le brief ; ne les utilisez pas toutes. Écrivez du code personnalisé uniquement pour le moment signature si aucune recette ne convient, et gardez-le aux mêmes normes (mouvement réduit, tactile, pause hors écran).

Règles de construction (issues de reference-analysis.md) :

  1. Construisez d'abord le héros et le moment signature et réussissez-les avant de construire le reste.
  2. Technique d'entrée principale : révélations par masque clip-path et révélations ligne par ligne, pas de simples fondus.
  3. Effets de verre (backdrop-filter) uniquement sur la navigation ou l'interface flottante.
  4. Au maximum un moment WebGL par page, avec un repli d'image statique et un budget de performance (< 3 Mo au premier chargement, actifs compressés).
  5. Les pages de plus d'environ 6 000 px nécessitent au moins un chapitre épinglé/sticky.
  6. Mondes illustrés en héros : gardez l'illustration fixe et faites réagir exactement un objet au curseur (glyph-window pour une porte, lune, fenêtre ou écran), ajoutez une couche particles clairsemée pour la profondeur, et proposez ui-toggle pour que les visiteurs puissent voir l'art. Si la marque a un personnage réel, laissez-le devenir le curseur dans une section avec cursor-creature. Vérifiez l'art généré pour les lettres fictives.
  7. Alternez la densité des sections : dense → calme → dense.
  8. Chaque animation respecte prefers-reduced-motion : remplacez le mouvement par de simples changements d'opacité ou rien.
  9. Contenu réel ou texte de remplacement réaliste écrit dans la voix de la marque. Jamais « Lorem ipsum », « Jean Dupont », « Acme » ou de fausses statistiques comme « 10 000+ utilisateurs ».
  10. Responsive par conception : repensez les compositions pour mobile (ordre d'empilement, échelle typographique, effets lourds désactivés), ne les réduisez pas simplement.
  11. HTML sémantique, interactions accessibles au clavier, états de focus visibles, texte alternatif sur les images.

Gestion de la stratégie d'actifs :

  • A : optimisez les médias de l'utilisateur (images AVIF/WebP, vidéo compressée avec images d'affiche, DRACO/KTX2 pour la 3D).
  • B : écrivez des prompts de génération d'images avec une recette de style partagée (éclairage, objectif, étalonnage couleur, composition) pour que toutes les images ressemblent à une seule séance photo ; listez-les pour l'utilisateur et utilisez des espaces réservés clairement marqués jusqu'à ce que les images existent.
  • C : construisez les visuels dans le code (shaders, particules, SVG génératif) et gardez-les dans la palette.
  • D : laissez la typographie et la motion porter la page ; augmentez le contraste typographique et ajoutez un moment de type cinétique.

Étape 6 : Contrôle qualité

Avant de déclarer le site terminé, vérifiez chaque élément. Corrigez les échecs, puis vérifiez à nouveau.

Anti-négligence :

  • Pas de dégradé violet-bleu (ou similaire) sur le texte ou le fond du héros.
  • Pas de rangée de trois cartes identiques avec des icônes.
  • Pas d'emoji utilisé comme icône ou puce.
  • La police d'affichage n'est pas Inter avec un tracking par défaut ; le tracking correspond à la direction.
  • Pas de preuve sociale inventée, de faux logos ou de fausses statistiques.
  • Toutes les sections n'utilisent pas la même animation d'entrée.

Qualité artisanale :

  • Le moment signature du brief existe et fonctionne.
  • La liste des éléments « interdits » de la direction est respectée.
  • L'échelle typographique a un fort contraste entre les tailles d'affichage et de corps.
  • L'espacement suit l'échelle ; la densité des sections alterne.
  • Les états de survol, de focus et d'actif existent sur chaque élément interactif.

Performance et accessibilité :

  • prefers-reduced-motion est pris en compte.
  • Le contraste du texte atteint 4,5:1 (corps) et 3:1 (affichage grand).
  • Les images sont dimensionnées et chargées paresseusement sous la ligne de flottaison ; la vidéo a une affiche.
  • La 3D a un repli et ne bloque pas la première peinture.
  • Fonctionne aux largeurs 375 px, 768 px et 1440 px.

Si un navigateur ou un outil de capture d'écran est disponible, ouvrez le site, prenez des captures d'écran à 375 px et 1440 px, parcourez toute la page et passez-les en revue avec cette liste de contrôle avant de terminer. Recherchez spécifiquement : les descentes tronquées dans le texte révélé, un objet 3D ou une image couvrant le titre, des cellules de grille vides, une navigation mobile surchargée, et des espaces vides plus longs qu'un écran.

Étape 7 : Enregistrer l'empreinte

Ajoutez le nouveau site à .site-director/history.json :

{
  "date": "2026-11-21",
  "project": "nom de la marque",
  "direction": "Swiss Precision",
  "secondary": "Immersive Spatial : approche 3D",
  "heroArchetype": "déclaration minimale",
  "displayFont": "Switzer",
  "palette": "#F2F2F0 / #0D0D0D / #FF4F00",
  "signatureMoment": "liste d'index avec aperçu d'image suivant le curseur",
  "layoutRhythm": "déclaration → index → étude de cas épinglée → chiffres → CTA",
  "assetStrategy": "D"
}

Message final à l'utilisateur

Soyez bref : ce qui a été construit, la direction artistique et le moment signature en une ligne chacun, comment l'exécuter, et quels actifs (le cas échéant) l'utilisateur doit encore fournir ou générer.

Skills associés