Moat → Page d'accueil 3D
Vous transformez une entreprise (son site en ligne, ou une phrase décrivant son avantage concurrentiel) en une page d'accueil opérationnelle, en production, et vérifiée par captures d'écran. Le moteur est écrit (template/) ; pour chaque client, vous écrivez un seul fichier, src/content.js, générez les visuels et vérifiez. Les modifications du moteur sont reportées dans template/ afin que chaque client suivant en bénéficie.
Lisez au besoin (tout se trouve dans references/) :
intake.md recherche du client · narrative.md moat → récit → contenu · art-direction.md théorie des couleurs, typographie, lumière, lisibilité · scenes.md objet vs scène, coupures de sections · engine.md schéma et modules · qa.md scripts de capture et grille d'évaluation · advanced.md ressources réelles et feuille de route des tendances · lessons.md toutes les erreurs commises jusqu'à présent — parcourez-le avant de commencer.
Recherche de référence (conservée avec le skill) : references/research/oryzo-teardown.md, graphify-teardown.md, video-and-writeup-research.md. Clients réalisés : pages/poolco/, pages/secureco/, pages/hotelsaas/.
Les références en un paragraphe
Oryzo garde un objet héros central et fait évoluer le monde autour de lui (caméra, mode de rendu, étalonnage, clair/sombre) — un contenu court et impassible, une affirmation + une preuve par temps ; un seul canevas WebGL fixe derrière un DOM haut, chaque valeur atténuée est un ressort. Graphify utilise la 3D comme assaisonnement : un « comment ça marche » collant dont le diagramme est la métaphore du produit (schémas SVG projetés), et vend par la densité de preuves. Nous les fusionnons — et, pour les entreprises physiques, remplaçons l'objet abstrait par une scène réelle et reconnaissable, que l'on peut découper et étiqueter.
Workflow (faites tout, dans l'ordre)
1 · Collecte et recherche → research/<slug>/brief.md
Si le client a un site, parcourez chaque page en premier (intake.md) : texte, services, processus, lieux, FAQ, conditions générales/mentions légales, fichier du vrai logo, couleurs et polices de la marque échantillonnées, contact public. Extrayez : entreprise, l'avantage concurrentiel en une phrase (leur affirmation récurrente), acheteurs, le vrai appel à l'action, la preuve qui existe réellement. Posez une question à l'utilisateur une seule fois pour ce qui ne peut être trouvé ou déduit. Identifiants de connexion / numéros de compte / données personnelles dans l'entrée → arrêtez et prévenez d'abord.
2 · Stratégie (écrite dans le brief avant le code)
- Type de moat → métaphore (
narrative.md §2). - Objet ou scène ? Appliquez le test de la seconde (
scenes.md). Lieux/installations → scène (modèlepool) ; logiciel d'accès/visibilité →repo; logiciel pour lieux gérés par l'horloge (hôtels, salles, commerce de détail) →ville; produits → formes d'objets. - Phrase de thèse (habitude de catégorie vs ce que le moat rend vrai).
- Plan de chapitres : 10–15 chapitres (
narrative.md §3, ou §3b ordre de construction pour les entreprises de services). Chaque chapitre modifie ≥ 2 éléments parmi caméra, scène/mode, étalonnage, valeur, forme de mise en page. - Tout le contenu (
§4) : titre ≤ 7 mots, corps ≤ 35, une affirmation + une preuve, à partir du brief uniquement. - Variez le format — deux clients n'ont pas la même page. Décidez et écrivez dans le brief ce que le défilement signifie (un voyage, un ordre de construction, une horloge…), ce que le lecteur fait (lire, tapoter, glisser, jouer), et à quoi la 3D répond (défilement uniquement, ou widgets via
send/receive). Pour les logiciels avec un dépôt, rendez les chapitres jouables (type: 'play') : de petites copies honnêtes des vrais composants du produit sur des données de démonstration qui animent la 3D (engine.md→ HotelSaaS).
3 · Direction artistique
art-direction.md : palette 60·30·10 basée sur la lumière, à partir de la marque + couleur du produit + un accent complémentaire (expliquez la théorie dans la transmission), les propres polices du client, bloom à 0 pour le réalisme, cartes de contenu au-dessus d'une 3D chargée, images clés mobiles pour chaque chapitre 3D.
4 · Images (en parallèle)
Écrivez research/<slug>/images.json (une photo par service + og) et exécutez
node .claude/skills/moat-landing/tools/gen-batch.mjs research/<slug>/images.json
en arrière-plan pendant que vous construisez. Vérifiez la planche contact ; régénérez les rejets. Les fichiers bruts restent dans research/, jamais dans public/. Clé : GEMINI_API_KEY dans votre environnement shell — ne l'imprimez jamais et ne la passez pas en argument.
Marques de logiciel / développeurs : sautez la photographie ; créez public/og.jpg à partir de votre propre rendu du héros (capture d'écran 1200×630) une fois le héros approuvé.
5 · Construction
SLUG=<slug>; ROOT="${CLAUDE_PROJECT_DIR:-$(pwd)}"
mkdir -p "$ROOT/pages/$SLUG" && rsync -a --exclude node_modules --exclude dist "$ROOT/.claude/skills/moat-landing/template/" "$ROOT/pages/$SLUG/"
cd "$ROOT/pages/$SLUG" && npm install
Réécrivez src/content.js (schéma : en haut du content.js du template + engine.md), en incluant meta.url/image, business, brand.copyCards, quickActions, les notes/cover/mobile des chapitres. Le CSS spécifique à la page va dans brand.css. Nouvelle fonctionnalité → construisez-la dans template/, puis rsync -a --exclude content.js template/src/ pages/<slug>/src/.
5b · Autres pages (quand le site du client en a)
Reconstruisez chaque page du site original à son URL d'origine (src/pages/<slug>.js, engine.md → Multi-page) : chaque sous-page conserve le même monde 3D, le langage des cartes et une pièce jouable (fonctionnalités → un explorateur, tarification → un sélecteur de forfait, à propos → un widget d'histoire) ; les pages juridiques utilisent le type doc avec le texte en direct (signalez les dates et la juridiction pour révision) ; contact utilise le formulaire WhatsApp/email (pas de backend sans approbation).
6 · Vérification (obligatoire, à chaque itération, les deux tailles)
npm run check (seuil budgétaire) → prévisualisation → capturez tous les chapitres à 1440×900 et 390×844 → planches contact → vérifications comportement + SEO → la grille dans qa.md. Attendez-vous à 2–3 tours.
7 · Transmission
Où elle s'exécute (npm run dev / URL de prévisualisation), thèse, carte des chapitres, la justification de la théorie des couleurs, ce que le client doit encore fournir (preuve réelle, endpoint de formulaire, identifiants analytiques, domaine), choix par défaut, et les 2–3 améliorations principales de advanced.md §9. Rappelez que les chiffres, les affirmations réglementaires et comparatives doivent être vérifiés avant publication. Mettez à jour lessons.md et la mémoire avec tout ce qui a été appris.
Règles de conception (issues des retours clients — appliquez par défaut)
- Reconnaissabilité en une seconde. Construisez la chose réelle d'abord ; ensuite découpez-la.
- Pas de lueur. Bloom à 0 pour tout ce qui est réel ; la lumière provient du soleil, du ciel et des sources dans la scène.
- Palettes claires et ensoleillées pour les entreprises physiques/de services ; le sombre uniquement pour les sujets nocturnes/technologiques.
- Jamais de texte sur une texture. Cartes au-dessus de l'eau, des tuiles et d'une 3D chargée.
- Expliquez avec des coupes de section + des étiquettes ancrées, pas de lueur de radiographie.
- Ne livrez jamais d'espaces réservés visibles. Preuve manquante → omettez le chapitre, listez-le dans la transmission.
Non-négociables
- Un seul héros (objet ou scène) pour toute la page ; le contenu de défilement vit dans les chapitres
cover. - Balayez la scène, déclenchez le contenu (le contenu se rejoue à l'entrée ; jamais ponctuel).
- Le texte est en HTML, jamais intégré dans des textures ou des images ; les données structurées indiquent seulement ce que la page affiche.
- Honnêteté. Pas de métriques, clients, logos, citations, certifications ou faits sur les concurrents inventés ; les images générées sont étiquetées comme illustratives ; les personnes générées ne sont jamais présentées comme des clients.
- N'usurpez jamais l'identité d'une marque que l'utilisateur n'est pas autorisé à représenter ; les démos fictives le mentionnent.
- Marque. Toujours la propre marque du client (polices, couleurs, logo) — lisez-les depuis le site en ligne.
- Budget (
npm run check) : JS de la page ≤ 55 Ko gz, scène ≤ 205 Ko gz, images ≤ 500 Ko, un seul canevas, DPR ≤ 1.75 ; fonctionne avec WebGL désactivé, mouvement réduit activé, à 390 px ; 0 erreur console ; 0 débordement. - Pas de déploiements, d'endpoints de formulaire, d'identifiants analytiques ou de comptes externes sans l'accord explicite de l'utilisateur.