Communitygithub.com

supersite-build

Constructeur de site web chirurgical pour les agents de codage IA. Lit le contrat de spécification supersite-plan.md, génère des composants React/Next.js propres et composables, câble les jetons de design et vérifie la compilation avec npm run build.

Qu'est-ce que supersite-build ?

supersite-build est un constructeur de site web chirurgical conçu pour les agents de codage IA fonctionnant dans des environnements comme Claude Code, Cursor ou Codex. Il exécute le plan architectural établi par /supersite-plan en lisant le fichier supersite-plan.md, puis construit atomiquement des composants React/Next.js, câble les jetons de design (couleurs, typographie, espacement) et valide l'implémentation avec npm run build. Ce skill est utile car il transforme un plan collaboratif en code propre et composable, garantissant que la sortie correspond exactement aux spécifications du plan, sans dérive créative ni contenu générique. Il prend en charge tous les projets React/Next.js et suit un pipeline d'exécution strict en cinq étapes : lecture et validation du contrat, échafaudage des types et de la configuration, construction des primitives UI, construction des blocs de sections, et assemblage des routes avec vérification de la compilation. En cas d'erreur de compilation, le skill corrige automatiquement le code et relance la construction jusqu'à ce qu'elle soit réussie, garantissant un résultat fiable et prêt à être déployé.

Compatible avec~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/developer-mohanaditya/supersite/tree/HEAD/skills/supersite-build

Demander à votre IA préférée

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

Documentation

🔨 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

  1. Rechercher supersite-plan.md dans la racine du projet.
    • S'il est manquant, mettre en pause et informer l'utilisateur :

      « Aucun supersite-plan.md trouvé à la racine du projet. Veuillez exécuter /supersite-plan pour concevoir votre plan en collaboration, ou exécuter /supersite <prompt> pour générer directement. »

  2. 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

  1. 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
      
  2. Générer les Contrats TypeScript (src/types/site.ts) :
    • Définir les types pour NavItem, FeatureItem, PricingPlan, Testimonial et FAQItem.
  3. 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.
  4. 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;
        }
      }
      

Étape 3 : Construire les Primitives UI (src/components/ui/)

Générer des primitives modulaires :

  • container.tsx : Conteneur de largeur maximale (max-w-6xl ou max-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

  1. Assembler src/app/page.tsx :
    • Importer les composants de section et composer la mise en page narrative en JSX propre et déclaratif.
  2. Assembler les Routes Supplémentaires :
    • Si le plan spécifie des routes multi-pages (/features, /pricing, /security), construire les fichiers page.tsx correspondants.
  3. 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.
  4. 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.
  5. 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.

Individual skills in this repo

This repo contains 1 individual skill — each has its own dedicated page.

Skills associés