🔨 supersite-build : Constructeur Chirurgical
supersite-build exécute le plan architectural établi par /supersite-plan. Il lit supersite-plan.md, construit des composants atomiques, câble les jetons de design et la copie, et valide l'implémentation par rapport au moteur de construction.
Le Pipeline d'Exécution
┌─────────────────────────────────────────────────────────────┐
│ 1. Lire et Valider le Contrat de Spécification │
│ Analyser les jetons, les routes et le manifeste depuis │
│ supersite-plan.md │
├─────────────────────────────────────────────────────────────┤
│ 2. Échafaudage, Types & Configuration │
│ Créer src/types/site.ts, src/config/site.ts & CSS de base │
├─────────────────────────────────────────────────────────────┤
│ 3. Construire les Primitives UI │
│ Container, SectionHeader, Button, Badge & Card │
├─────────────────────────────────────────────────────────────┤
│ 4. Construire les Blocs de Sections │
│ Navbar, Hero, Contraste, Fonctionnalités, Preuve, Tarifs │
│ & Footer │
├─────────────────────────────────────────────────────────────┤
│ 5. Assembler les Routes et Vérifier la Construction │
│ Câbler les pages, vérifier l'accessibilité et exécuter │
│ npm run build │
└─────────────────────────────────────────────────────────────┘
Étape 1 : Lire et Valider supersite-plan.md
- Rechercher
supersite-plan.mddans la racine du projet.- S'il est manquant, mettre en pause et informer l'utilisateur :
« Aucun
supersite-plan.mdtrouvé à la racine du projet. Veuillez exécuter/supersite-planpour concevoir votre plan en collaboration, ou exécuter/supersite <prompt>pour générer directement. »
- S'il est manquant, mettre en pause et informer l'utilisateur :
- Analyser les paramètres architecturaux du plan :
- Genre esthétique et palette de couleurs (Hex/OKLCH, répartition 60-30-10).
- Choix de typographie et de rayon de bordure.
- Manifeste des routes et des composants.
- Copie des sections, titres et éléments interactifs.
Étape 2 : Échafaudage, Types & Configuration
- Vérifier les Dépendances :
- S'assurer que les utilitaires standards sont présents (
lucide-react,clsx,tailwind-merge). Installer s'ils sont manquants :npm install lucide-react clsx tailwind-merge
- S'assurer que les utilitaires standards sont présents (
- Générer les Contrats TypeScript (
src/types/site.ts) :- Définir les types pour
NavItem,FeatureItem,PricingPlan,TestimonialetFAQItem.
- Définir les types pour
- Générer la Configuration Centralisée (
src/config/site.ts) :- Stocker les liens de navigation, les métadonnées de marque et le contenu structuré des sections en un seul endroit.
- Mettre à Jour le CSS de Base (
src/app/globals.css) :- Injecter les variables de couleur, les styles de sélection et le bloc d'accessibilité pour mouvement réduit :
@layer base { ::selection { background-color: var(--accent); color: var(--accent-foreground); } } @media (prefers-reduced-motion: reduce) { *, ::before, ::after { animation-duration: 0.01ms !important; animation-iteration-count: 1 !important; transition-duration: 0.01ms !important; scroll-behavior: auto !important; } }
- Injecter les variables de couleur, les styles de sélection et le bloc d'accessibilité pour mouvement réduit :
Étape 3 : Construire les Primitives UI (src/components/ui/)
Générer des primitives modulaires :
container.tsx: Conteneur de largeur maximale (max-w-6xloumax-w-7xl) avec rembourrage réactif.section-header.tsx: Bloc standardisé de badge, titre et description.button.tsx: Bouton basé sur les variantes (primary,secondary,outline,ghost) avec styles explicites:focus-visible.badge.tsx: Pastilles et puces d'état avec bordures fines.card.tsx: Enveloppe de surface appliquant la couleur de surface, la bordure et les jetons de rayon du plan.
Étape 4 : Construire les Blocs de Sections (src/components/site/)
Construire chaque section spécifiée dans le plan :
navbar.tsx: En-tête réactif avec liens de navigation desktop, appel à l'action et tiroir hamburger mobile.hero.tsx: Pilule d'accroche, titre H1, paragraphe d'introduction, groupe d'appels à l'action et aperçu interactif du produit (par exemple terminal ou cadre UI).problem-contrast.tsx: Contraste visuel asymétrique illustrant la douleur du statu quo par rapport à la solution moderne.feature-grid.tsx: Grille bento asymétrique ou cellules de fonctionnalités modulaires. Zéro copie répétitive de 3 cartes.product-showcase.tsx: Composant interactif (explorateur de code à onglets, aperçu interactif en direct ou terrain de jeu de configuration).social-proof.tsx: Métriques vérifiables et citations de témoignages clients avec des rôles techniques spécifiques.pricing-matrix.tsx: Bascule de facturation mensuelle/annuelle (avec"use client"), cartes de niveau, listes de fonctionnalités et appels à l'action de paiement.faq-accordion.tsx: FAQ technique extensible utilisant des transitions de hauteur de grille CSS fluides.footer.tsx: Liens de navigation multi-colonnes, ancres légales, point d'état du système et droits d'auteur.
Étape 5 : Assembler les Routes et Vérifier la Construction
- Assembler
src/app/page.tsx:- Importer les composants de section et composer la mise en page narrative en JSX propre et déclaratif.
- Assembler les Routes Supplémentaires :
- Si le plan spécifie des routes multi-pages (
/features,/pricing,/security), construire les fichierspage.tsxcorrespondants.
- Si le plan spécifie des routes multi-pages (
- Exécuter l'Audit Anti-Déchets Pré-Construction :
- Vérifier les styles interdits : pas de dégradés violets, pas de cartes non ancrées, pas de copie générique de placeholder.
- Vérifier les cibles tactiles : confirmer que les zones interactives sont ≥44×44px.
- Vérifier les tirets cadratins : confirmer zéro tiret cadratin (
—ou--) dans toute la copie UI, les titres, la microcopie et les étiquettes de boutons.
- Compilation et Porte de Construction :
- Exécuter la commande de construction du projet :
npm run build - En cas d'erreur TypeScript ou d'import manquant, corriger immédiatement et relancer jusqu'à ce que la construction réussisse proprement avec le code 0.
- Exécuter la commande de construction du projet :
- Rapporter à l'Utilisateur :
- Dans toutes les réponses conversationnelles et les rapports de progression, appliquer la Règle Zéro Tiret Cadratin (ne jamais utiliser
—ou--). Utiliser des points, des deux-points, des virgules ou des parenthèses à la place. - Fournir un résumé propre des fichiers construits avec des liens cliquables :
[supersite-plan.md](file:///chemin/vers/supersite-plan.md)[page.tsx](file:///chemin/vers/src/app/page.tsx)- Liens individuels des composants dans
src/components/site/
- Confirmer la compilation réussie.
- Dans toutes les réponses conversationnelles et les rapports de progression, appliquer la Règle Zéro Tiret Cadratin (ne jamais utiliser