⚠️ LISEZ D'ABORD :
PNPM_11_REQUIREMENTS.mddans ce dossier de skill. Les conteneurs de développement Web (où Mike prévisualise vos sites) utilisent pnpm 11.1.1 depuis le 2026-05-13. CHAQUE nouveau projet DOIT déclarerpnpm.onlyBuiltDependenciesdans package.json (au minimum :["sharp"]pour tout projet Next.js) sinon le serveur de développement NE DÉMARRERA PAS. Ignorez cela et le conteneur bouclera, le site renverra une erreur 502, et l'utilisateur vous blâmera. Une lecture de 60 secondes ; ignorez à vos risques et périls.
Constructeur de Site Web — Skill Complet pour Next.js
Création de sites web guidée par la recherche et intentionnée par le design. Chaque décision soutenue par des données, chaque section justifiée par la recherche.
Quand Utiliser Ce Skill
DÉCLENCHEZ lorsque l'utilisateur demande :
- Construire un nouveau site web
- Créer un site web pour son entreprise
- Démarrer un nouveau projet web
- "Fais-moi un site"
NE PAS UTILISER pour :
- Les pages Canvas (utilisez le skill
canvas-web-designà la place) - Modifier un projet de site web existant (suivez le fichier
.claude/CLAUDE.mdde ce projet) - Les projets vidéo Remotion (utilisez le skill
remotion-video)
RÈGLES NON-NÉGOCIABLES
- N'ÉCRIVEZ JAMAIS de code avant d'avoir terminé la recherche et la planification du design. Les phases 1 à 4 ne produisent aucun code. C'est correct.
- NE LIVREZ JAMAIS une page avec des valeurs par défaut de modèle. Si vous voyez "Logo", "(555) 000-0000", "[email protected]", "Service One" — vous avez ÉCHOUÉ.
- N'ÉCRIVEZ JAMAIS de contenu sans recherche de mots-clés. Chaque titre cible un mot-clé spécifique de la phase 3.
- NE SAUTEZ JAMAIS le plan de design. Chaque section, couleur et animation doit avoir une RAISON documentée.
- N'UTILISEZ JAMAIS de tactiques d'intimidation ou de titres basés sur la peur. Rédigez un contenu axé sur les avantages et ciblé SEO.
- EXÉCUTEZ TOUJOURS une vérification des espaces réservés avant de présenter un site. Tolérance zéro.
- PERSONNALISEZ TOUJOURS chaque section. Si une section affiche les valeurs par défaut intégrées, vous avez oublié de passer les props.
- NE LIVREZ JAMAIS de détournement du bouton de retour. Pas de boucles
history.pushState, de pièges de redirection, ou de chaînes de modales/superpositions qui empêchent le bouton Retour du navigateur de ramener l'utilisateur vers la SERP — une violation de la politique anti-spam de Google (pratiques malveillantes, appliquée à partir du 2026-06-15) entraînant un risque d'action manuelle et de déclassement. Auditez les scripts de sortie, les interstitiels, et tout code de bibliothèque/publicité inclus (la violation provient souvent de là, pas de la première partie). Vérifiez en phase 12. (developers.google.com/search/blog/2026/04/back-button-hijacking)
Types de Sites
Identifiez lors de la collecte — cela change tout :
| Type | Objectif | Sections Clés | Style de Contenu |
|---|---|---|---|
| SEO Leadgen | Classer + capturer des leads | Hero + TrustBar + CoverageGrid + HowItWorks + FAQ + Testimonials + CTA | Riche en mots-clés, axé sur les avantages, professionnel |
| Service Local | Appels téléphoniques + formulaires | Hero + TrustBar + Services + ServiceAreas + Reviews + CTA | Direct, renforçant la confiance, ciblé par emplacement |
| Portfolio | Présenter le travail | Hero + ProjectGrid + About + Process + Contact | Visuel, texte minimal, laissez le travail parler |
| SaaS / Produit | Inscriptions / essais | Hero + Features + Pricing + Testimonials + FAQ + CTA | Axé sur les avantages, comparatif |
Sites de service local : Consultez la section Règles CRO pour service local ci-dessous avant de construire un site pour un service à domicile ou un entrepreneur. La plupart des sites locaux convertissent en dessous de 1%. Ces règles visent 3–5%.
Règles CRO pour Service Local
Source : Audit de conversion de Noah Igler (@noahiglerSEO) sur les sites de service à domicile (plombiers, HVAC, couvreurs, électriciens, paysagistes, etc.). La plupart des sites obtiennent un trafic correct mais le téléphone ne sonne pas — car le site fuit les leads, pas le trafic.
La plupart des sites de service à domicile convertissent en dessous de 1%. Ces règles visent 3–5% avec le même trafic.
Au-Dessus de la Ligne de Flottaison (80% des conversions se jouent ou se perdent ici)
Dans les 3 secondes suivant l'arrivée, les visiteurs doivent savoir : ce que vous faites, où vous le faites, que vous êtes digne de confiance, et comment vous appeler. Chaque élément ci-dessous est requis — pas optionnel.
- Format du titre :
"[Service] à [Ville]"ou"[Ville]'s Trusted [Service] Company"— PAS"Votre partenaire de confiance pour les services à domicile depuis 2003" - Numéro de téléphone : En haut à droite, grande police, collant lors du défilement — lié directement à un lien
tel:(PAS de modale, PAS de popup, PAS d'étape de confirmation — une modale a causé à un client une baisse de 30% des appels) - Barre de confiance / sous-titre : Note par étoiles + nombre d'avis + années d'activité + numéro de licence + zone de service — tout dans le hero
- CTA principal :
"Appelez Maintenant"ou"Obtenez un Devis Gratuit"— affichez le numéro de téléphone SUR le bouton ou immédiatement en dessous - Image du hero : Photos réelles de votre équipe en chemises de marque, camions sur les chantiers, ou travaux réels — PAS de photos stock de familles souriantes (les visiteurs les repèrent instantanément ; la confiance devient négative)
Visibilité du Téléphone — Le Levier le Plus Important
- En-tête collant : numéro de téléphone toujours visible sur mobile lors du défilement
- Barre de pied collante sur mobile : deux boutons —
"Appelez Maintenant"(lien tel:) et"Réservez en Ligne"— toujours visibles - Bouton d'action flottant sur les longues pages
- Ajoute 15–25% au volume d'appels dans la pratique
Formulaires — Chaque Champ Supplémentaire Coûte ~10% de Conversions
Maximum 4 champs pour tout formulaire de lead de service à domicile :
- Nom
- Téléphone
- Service nécessaire (liste déroulante — pas de texte libre)
- Adresse
N'ajoutez jamais : email, "meilleur moment pour appeler", "comment nous avez-vous connus", zone de commentaires, preuve d'adresse, ou toute question de qualification. Vous n'effectuez pas une demande de crédit — vous obtenez leur numéro de téléphone pour pouvoir rappeler. La qualification se fait lors de l'appel.
Vitesse Mobile — Non-Négociable
- En dessous de PageSpeed 50 sur mobile = perte de 2–3 places dans le Map Pack
- En dessous de PageSpeed 70 = perte de 20–30% des visiteurs mobiles avant le chargement de la page
- Objectif : PageSpeed 70+ sur mobile, chargement de page < 2 secondes
Correctifs de vitesse (par ordre d'impact) :
- Compressez l'image du hero à 200–400 Ko (la plupart des sites livrent des images hero de 2–3 Mo)
- Supprimez les plugins et scripts de suivi inutiles
- Utilisez un vrai CDN (pas seulement l'option groupée de l'hôte)
- Lazy load tout ce qui est en dessous de la ligne de flottaison
- Minimisez les widgets tiers (chat en direct, intégrations sociales, agrégateurs d'avis) — ils se chargent tard et couvrent le numéro de téléphone
Avis / Preuve Sociale — Doit Apparaître à Chaque Niveau de Défilement
Ne placez pas toute la preuve dans une seule section de témoignages à mi-parcours. Les visiteurs doivent la voir à chaque niveau :
- Au-dessus de la ligne de flottaison :
"4,9 étoiles sur 312 avis Google"— nombre + note dans la barre de confiance du hero - Section Hero : 2–3 courtes citations de vrais avis, de préférence dynamiques depuis GBP
- Pages de service : section d'avis dédiée tirant des citations mentionnant ce service spécifique
- Près du formulaire : répétez la preuve juste avant la demande
L'objectif : au moment où ils atteignent le formulaire, ils ont vu la preuve 5 à 6 fois.
Photos — Images Réelles Plutôt que Stock à Chaque Fois
- Photos réelles de l'équipe en chemises de marque sur les chantiers
- Camions garés chez de vrais clients
- Photos avant-après (débouchage, travaux de panneaux, installation de climatisation, conduits, remplacements de toiture)
- Documents de licence, certifications des fabricants, certificats d'assurance photographiés et affichés
- Le site doit ressembler à une entreprise physique avec de vraies personnes, pas à un modèle dans lequel une agence marketing a inséré un logo
Financement — Requis pour les Services Coûteux (5K$+)
~60% des clients pour des travaux de remplacement veulent un financement. Si votre concurrent affiche le logo Synchrony / GreenSky / Wisetack et que vous non, ils concluent l'affaire avant que vous ne soumettiez un devis.
- Logo du partenaire de financement visible au-dessus de la ligne de flottaison sur les pages de service
- Mention
"Financement à 0% disponible"ou"Paiements à partir de 89 $/mois"dans le hero - Page de financement séparée liée depuis la navigation principale
- Widget de pré-qualification intégré sur les pages de service coûteuses
Erreurs Courantes Qui Tuent les Conversions
Ces erreurs apparaissent constamment dans les audits — n'en livrez aucune :
- Formulaires plus longs pour "qualifier" les leads — vous ne les qualifiez pas, vous les perdez
- Cacher le téléphone pour forcer les soumissions de formulaire — ils partent simplement à la place
- Vidéo en lecture automatique dans la section hero — tue la vitesse mobile, agace le visiteur
- Pop-ups lors de la première visite — déclencheur immédiat du bouton retour sur mobile
- Widgets de chat en direct — mettent 4s à charger, couvrent le numéro de téléphone, n'ajoutent aucune valeur pour le service à domicile
Stack Technique (chaque projet)
| Outil | Package | Objectif |
|---|---|---|
| Next.js 15 | next | App Router, composants serveur, actions serveur |
| React 19 | react | Framework UI |
| TypeScript | typescript | Sécurité des types |
| Tailwind CSS v3 | tailwindcss | Style utilitaire (v3 — PAS v4, v4 a des problèmes avec PostCSS) |
| shadcn/ui | shadcn (CLI) | Bibliothèque de composants (Radix + Tailwind) |
| Motion | motion | Animations (physique ressort, scroll, layout) |
| Lenis | lenis | Scroll fluide (< 4kb, accessible) |
| Lucide React | lucide-react | Icônes SVG |
Optionnel (installer quand nécessaire)
| Outil | Package | Quand |
|---|---|---|
| Pretext | @chenglou/pretext | Mesure de texte sans DOM reflow — listes virtualisées, UI de chat, grilles en maçonnerie, conteneurs de texte à auto-dimensionnement, rendu de texte sur canvas. ~500x plus rapide que getBoundingClientRect. Zero dépendances. Voir /mnt/shared-skills/pretext/SKILL.md |
| GSAP | gsap | Séquences de scroll complexes, SplitText, MorphSVG |
| Three.js | three + @react-three/fiber | Arrière-plans 3D ou éléments hero |
| MDX | @next/mdx | Blog avec contenu riche |
| Prisma | prisma | Accès à la base de données |
Workflow en 13 Phases
Suivez ces phases DANS L'ORDRE. Ne sautez pas de phases. Les phases 1 à 4 ne produisent AUCUN code — elles produisent de la recherche et un plan. C'est le but.
Phase 1 : DÉCOUVERTE
Lire : instructions/brand-intake.md
Demandez au client les questions de la fiche de marque AVANT toute autre chose :
- Identité de l'entreprise, secteur d'activité, client cible
- Couleurs de la marque, ton, personnalité
- Objectifs SEO, concurrents, ce que les clients recherchent
- Pages nécessaires, fonctionnalités spéciales, CTA principal
- Type de site (SEO leadgen, service local, portfolio, SaaS)
Livrable : Réponses complètes de la fiche de marque
Phase 2 : CONFIGURATION
Lire : instructions/folder-setup.md
Créez la structure de dossiers ai/ dans le répertoire du projet :
- Créez tous les répertoires de recherche (01-07)
- Créez les répertoires de design, contenu et recherche-blog
- Initialisez
research-status.json - Remplissez
01-business-profile/profile.mdà partir des réponses de la fiche de marque
Livrable : Structure de dossiers ai/ complète avec le profil d'entreprise renseigné
Phase 3 : RECHERCHE (la base — NE PAS SE PRÉCIPITER)
Lire : instructions/research-plan.md
Six tâches de recherche qui informent TOUT ce qui suit :
-
Recherche de mots-clés — Trouvez 50 à 100+ mots-clés dans les catégories principales, secondaires, longue traîne, et locales. Documentez dans
ai/research/02-keyword-research/. Cherchez sur Google, capturez les questions PAA, construisez des clusters de mots-clés. -
Analyse approfondie des concurrents — Examinez 5 à 10 sites concurrents en détail. Pour chacun : documentez les sections de leur page d'accueil, la disposition du hero, les CTA, le design visuel, la typographie, les animations, la qualité du contenu, les forces, les faiblesses. Créez des fichiers d'examen par concurrent dans
ai/research/03-competitor-analysis/site-reviews/. Ensuite, synthétisez danspattern-analysis.md(schémas communs dans le créneau) etgaps-opportunities.md(ce que nous exploitons). -
Stratégie de contenu — Cartographiez chaque page : URL, mots-clés, sections, H1, balises meta. Créez des briefs de contenu par page dans
ai/research/04-content-strategy/content-briefs/. Recherchez les questions FAQ à partir de PAA, Reddit, forums. -
Carte thématique — Construisez l'architecture de cluster de sujets : pages piliers, contenu de cluster, stratégie de liens internes. Documentez dans
ai/research/05-topical-map/. -
SEO local (si applicable) — Zones de service ciblées, concurrents locaux, mots-clés spécifiques à la ville. Documentez dans
ai/research/06-local-seo/. -
Modèles de conversion — Analysez les CTA des concurrents, les signaux de confiance, les modèles de preuve sociale. Cartographiez l'entonnoir de conversion. Documentez dans
ai/research/07-conversion-patterns/.
Livrable : 20 à 40 fichiers de recherche répartis dans 7 répertoires. Mettez à jour research-status.json.
Phase 4 : PLAN DE DESIGN (la phase de réflexion — chaque décision intentionnelle)
Lire : instructions/design-plan.md
C'est là qu'un site passe de "un autre modèle" à quelque chose qui FONCTIONNE. Six documents de design :
-
Audit visuel des concurrents (
ai/design/competitor-visual-audit.md) — Examinez tous les sites concurrents pour les modèles visuels : types de hero, ordre des sections, schémas de couleurs, typographie, animations, style photographique. Classez-les par qualité visuelle. Identifiez ce qu'il faut surpasser. -
Direction stylistique (
ai/design/style-direction.md) — Choisissez une esthétique avec justification. Couleurs, polices, mode sombre/clair, espacement — chaque choix tracé jusqu'à la fiche de marque + l'analyse des concurrents + le contexte du secteur. -
Plan des composants (
ai/design/component-plan.md) — Chaque composant nécessaire, dans l'ordre, avec son objectif. Pourquoi cette disposition du hero ? Pourquoi ce style de barre de confiance ? Pourquoi ces sections dans cet ordre ? Cartographiez l'entonnoir de conversion. -
Plan d'animation (
ai/design/animation-plan.md) — Quoi bouge, pourquoi, comment. Animations d'entrée, états de survol, effets de scroll. Mouvement intentionnel, pas une décoration aléatoire. -
Wireframes de page (
ai/design/page-wireframes.md) — Disposition section par section pour chaque page. Wireframes ASCII montrant la structure. -
Brief de design (
ai/design/design-brief.md) — Document maître. Résume toutes les décisions de design, liste ce qui fait que ce site "démarque" par rapport aux concurrents, relie chaque choix à la recherche.
Livrable : 6 documents de design. Le brief de design est la référence pour toute la construction.
Phase 5 : ÉCHAFAUDAGE
Lire : instructions/architecture.md
Utiliser : le répertoire templates/project/
- Copiez
templates/project/versWebsites/<nom-du-projet>/ - Exécutez
pnpm install - Installez shadcn :
pnpm dlx shadcn@latest init - Installez les composants shadcn de base :
pnpm dlx shadcn@latest add button card badge separator input textarea label - Installez les dépendances d'animation :
pnpm add motion lenis - Initialisez git, commitez l'échafaudage
- Créez un dépôt GitHub privé, pushez, créez la branche
web-dev - Remplissez
.claude/CLAUDE.mden utilisanttemplates/config/claude-project.md
Phase 6 : SYSTÈME DE DESIGN
Lire : instructions/design-system.md
Utiliser : templates/config/design-system-config.json
- Créez
app/globals.cssbasé sur le plan de design (couleurs, polices, classes utilitaires) - Définissez les variables de thème Tailwind dans
tailwind.config.ts - Créez des composants de base : Button, Input, Card, Badge — enveloppes shadcn stylisées
- Créez un composant Container avec des breakpoints prédéfinis
- Créez un composant Section avec espacement, fond, et styles d'animation
- Configurez les polices (Next.js
next/font— optimisé Google Fonts ou hébergé localement) - Créez
lib/utils.tsavec des fonctions utilitaires (cn, formatPhone, formatCurrency) - Créez
lib/seo.tsavec le composant générique generateMetadata
Livrable : Système de design fonctionnel dans components/ui/
Phase 7 : COMPOSANTS PARTAGÉS
Lire : instructions/shared-components.md
- Navigation — Header réactif (menu desktop + mobile hamburger), logo, liens de navigation, CTA
- Pied de page — Liens, coordonnées, intégration de carte, mentions légales
- TrustBar — Logos clients, notes d'avis, nombre d'avis, certifications
- SectionHero — Titre, sous-titre, CTA, image, TrustBar intégrée — configurable par page
- Grille de services / Galerie — Grille réactive avec cartes, liens, utilisation de la bibliothèque Motion
- Galerie de témoignages — Carrousel ou grille avec notation par étoiles
- Section CTA — Bannière de fond avec titre, texte, bouton
- Section FAQ — Accordéon avec données structurées Schema.org
Livrable : Tous les composants partagés dans components/shared/
Phase 8 : PAGE D'ACCUEIL
Lire : instructions/building-pages.md
Utiliser : templates/design/wireframes/homepage.md et ai/design/page-wireframes.md
- Créez
app/page.tsx - Construisez chaque section dans l'ordre (Plan de design -> Wireframe -> Composant -> Données)
- Appliquez les animations d'entrée décalées avec Motion
- Optimisez LCP (image hero prioritaire, polices préchargées, CSS critique)
- Ajoutez les données structurées (JSON-LD : LocalBusiness, Service, Review, FAQ)
- Appliquez les meilleures pratiques Core Web Vitals (CLS < 0,1, LCP < 2,5 s, INP < 200 ms)
Livrable : Page d'accueil complète et responsive
Phase 9 : PAGES INTÉRIEURES
Lire : instructions/building-pages.md
Construisez toutes les pages intérieures de la stratégie de contenu :
- Pages de service (si applicable) : sections dédiées, zone de service, CTA de devis gratuit
- Page À propos : histoire de l'entreprise, équipe, valeurs
- Page de contact : formulaire, carte, coordonnées directes
- Page de blog / ressources : aperçu des articles, pagination, catégories
- Pages de tarification (si SaaS/produit) : tableaux comparatifs
Chaque page doit avoir son propre titre H1 ciblant un mot-clé, meta description, et données structurées spécifiques à la page.
Livrable : Toutes les pages intérieures du plan du site
Phase 10 : CONTENU
Lire : instructions/content-guidelines.md
- Rédigez le contenu de chaque section en utilisant les mots-clés de la phase 3
- Titres au format
[Mot-clé principal] — [Bénéfice] - Pas de remplissage — chaque paragraphe ajoute de la valeur
- Incluez les questions FAQ de la recherche PAA
- Ajoutez des appels à l'action naturels et non commerciaux
- Utilisez le contenu du brief pour les pages de service ; pas de texte générique
Livrable : Contenu complet pour toutes les pages
Phase 11 : PERFORMANCE & SEO TECHNIQUE
Lire : instructions/performance-checklist.md
- Compressez toutes les images (WebP, AVIF, chargement réactif)
- Implémentez le lazy loading pour les images sous la ligne de flottaison
- Vérifiez que les polices sont préchargées
- Vérifiez que les données structurées sont valides (test d'outil de test de données structurées)
- Vérifiez les balises canoniques, les balises hreflang (si multilingue), les balises meta robots
- Générez un sitemap.xml et un robots.txt
- Testez avec Lighthouse sur mobile et desktop (cible : Performances > 90, SEO > 90)
- Vérifiez les Core Web Vitals avec PageSpeed Insights
- Testez l'accessibilité (lecteur d'écran, navigation au clavier, contraste des couleurs)
Livrable : Site optimisé avec scores de performance vérifiés
Phase 12 : AUDIT FINAL
Lire : instructions/final-audit.md
- Vérification des espaces réservés : Recherche automatisée de texte de modèle ("Logo", "(555) 000-0000", "[email protected]", "Service One", "Lorem ipsum"). Tolérance zéro.
- Vérification des liens : Tous les liens internes/externes sont valides, pas de liens brisés
- Vérification des formulaires : Tous les formulaires envoient correctement, validation fonctionne
- Vérification de la réactivité : Testez sur mobile (320px+), tablette (768px), desktop (1280px, 1920px)
- Vérification de l'accessibilité : Rapports complets de vérification avec axe DevTools
- Vérification anti-détournement du bouton de retour : Aucun piège de navigation, popup empêchant le retour, ou superposition coincée. Vérifiez manuellement le flux Retour depuis la SERP.
- Vérification de la console : Aucune erreur console ou avertissement en production
- Vérification de la sécurité : Aucune clé API ou secret exposé dans le code
Livrable : Liste de contrôle d'audit complétée
Phase 13 : DÉPLOIEMENT
Lire : instructions/deployment.md
- Poussez toutes les modifications vers la branche
main - Déployez via Vercel (ou option spécifiée par le client)
- Vérifiez le déploiement : toutes les pages se chargent, les formulaires fonctionnent, les données structurées sont valides
- Configurez les analyses (Google Analytics 4 ou équivalent)
- Configurez Google Search Console, soumettez le sitemap
- Configurez la surveillance des performances (si applicable)
- Livrez au client avec la documentation (informations de connexion, procédure de mise à jour du contenu, instructions SEO)
Livrable : Site déployé et documenté