Communitygithub.com

supersite-build

Construtor cirúrgico de sites para agentes de IA. Lê o contrato de especificação supersite-plan.md, gera componentes React/Next.js limpos e componíveis, conecta tokens de design e verifica a compilação com npm run build.

O que é supersite-build?

O supersite-build é uma skill especializada para agentes de IA (como Claude Code, Cursor e Codex) que transforma um plano de site, definido no arquivo `supersite-plan.md`, em um conjunto completo de componentes React/Next.js prontos para produção. Ele segue um pipeline de execução rigoroso em cinco etapas: validação do plano, scaffolding de tipos e configuração, construção de primitivas de UI (Container, Button, Card, etc.), montagem de blocos de seção (Navbar, Hero, Features, Pricing, Footer) e, por fim, a montagem das rotas com verificação de compilação via `npm run build`. A skill é útil porque impõe consistência estilística por meio de tokens de design, gera código modular e de fácil manutenção, e executa uma auditoria anti-slop para evitar estilos genéricos, placeholders e travessões. Ela funciona lendo o contrato de especificação, gerando arquivos TypeScript, CSS e componentes em `src/components/ui/` e `src/components/site/`, e garantindo que a compilação termine com sucesso antes de reportar um resumo limpo ao usuário.

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

Perguntar na sua IA favorita

Abre um novo chat com esta habilidade de agente já pré-carregada.

Documentação

🔨 supersite-build: Construtor Cirúrgico

supersite-build executa o plano arquitetural estabelecido por /supersite-plan. Ele lê supersite-plan.md, constrói componentes atômicos, conecta tokens de design e cópia, e valida a implementação contra o motor de compilação.


O Pipeline de Execução

┌─────────────────────────────────────────────────────────────┐
│ 1. Ler e Validar o Contrato de Especificação               │
│ Analisar tokens, rotas e manifesto do supersite-plan.md    │
├─────────────────────────────────────────────────────────────┤
│ 2. Scaffolding, Tipos e Configuração                       │
│ Criar src/types/site.ts, src/config/site.ts e CSS base     │
├─────────────────────────────────────────────────────────────┤
│ 3. Construir Primitivas de UI                              │
│ Container, SectionHeader, Button, Badge e Card             │
├─────────────────────────────────────────────────────────────┤
│ 4. Construir Blocos de Seção                               │
│ Navbar, Hero, Contraste, Recursos, Prova, Preços e Footer  │
├─────────────────────────────────────────────────────────────┤
│ 5. Montar Rotas e Verificar Compilação                     │
│ Conectar páginas, verificar acessibilidade e executar npm run build │
└─────────────────────────────────────────────────────────────┘

Etapa 1: Ler e Validar supersite-plan.md

  1. Procure por supersite-plan.md na raiz do workspace.
    • Se estiver faltando, pause e informe ao usuário:

      "Nenhum supersite-plan.md encontrado na raiz do projeto. Execute /supersite-plan para projetar seu plano colaborativamente, ou execute /supersite <prompt> para gerar diretamente."

  2. Analise os parâmetros arquiteturais do plano:
    • Gênero Estético e Paleta de Cores (Hex/OKLCH, distribuição 60-30-10).
    • Escolhas de Tipografia e Raio de Borda.
    • Manifesto de Rotas e Componentes.
    • Cópia da seção, títulos e elementos interativos.

Etapa 2: Scaffolding, Tipos e Configuração

  1. Verificar Dependências:
    • Garanta que utilitários padrão estejam presentes (lucide-react, clsx, tailwind-merge). Instale se estiverem faltando:
      npm install lucide-react clsx tailwind-merge
      
  2. Gerar Contratos TypeScript (src/types/site.ts):
    • Defina tipos para NavItem, FeatureItem, PricingPlan, Testimonial e FAQItem.
  3. Gerar Configuração Centralizada (src/config/site.ts):
    • Armazene links de navegação, metadados da marca e conteúdo estruturado das seções em um só lugar.
  4. Atualizar CSS Base (src/app/globals.css):
    • Injete variáveis de cor, estilos de seleção e o bloco de acessibilidade de movimento reduzido:
      @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;
        }
      }
      

Etapa 3: Construir Primitivas de UI (src/components/ui/)

Gere primitivas modulares:

  • container.tsx: Container de largura máxima (max-w-6xl ou max-w-7xl) com padding responsivo.
  • section-header.tsx: Bloco padronizado de badge, título e descrição.
  • button.tsx: Botão orientado por variante (primary, secondary, outline, ghost) com estilos explícitos de :focus-visible.
  • badge.tsx: Chips de status e pill com bordas finas.
  • card.tsx: Invólucro de superfície aplicando a cor de superfície, borda e tokens de raio do plano.

Etapa 4: Construir Blocos de Seção (src/components/site/)

Construa cada seção especificada no plano:

  • navbar.tsx: Cabeçalho responsivo com links de navegação para desktop, CTA de ação e gaveta de hambúrguer para dispositivos móveis.
  • hero.tsx: Pill de gancho, título H1, parágrafo principal, cluster de CTA e pré-visualização interativa do produto (ex.: terminal ou moldura de UI).
  • problem-contrast.tsx: Contraste visual assimétrico ilustrando a dor do status quo versus a solução moderna.
  • feature-grid.tsx: Grade bento assimétrica ou células modulares de recurso. Nenhuma cópia repetitiva de 3 cartões.
  • product-showcase.tsx: Componente interativo (explorador de código com abas, pré-visualização interativa ao vivo ou playground de configuração).
  • social-proof.tsx: Chamadas de métricas verificáveis e citações de depoimentos de clientes com cargos específicos de engenharia.
  • pricing-matrix.tsx: Alternador de faturamento Mensal/Anual (com "use client"), cartões de nível, listas de verificação de recursos e CTAs de checkout.
  • faq-accordion.tsx: FAQ técnico expansível usando transições suaves de altura com CSS grid.
  • footer.tsx: Links de navegação em várias colunas, âncoras legais, ponto de status do sistema e direitos autorais.

Etapa 5: Montar Rotas e Verificar Compilação

  1. Montar src/app/page.tsx:
    • Importe componentes de seção e componha o layout narrativo em JSX limpo e declarativo.
  2. Montar Rotas Adicionais:
    • Se o plano especificou rotas de várias páginas (/features, /pricing, /security), construa os arquivos page.tsx correspondentes.
  3. Executar Auditoria Anti-Slop de Pré-voo:
    • Verificar estilos proibidos: sem blobs de gradiente roxo, sem cartões sem fundo, sem cópia de placeholder genérica.
    • Verificar alvos de toque: verifique se as áreas interativas de clique são ≥44×44px.
    • Verificar travessões: verifique zero travessões (— ou --) em toda cópia da UI, títulos, microcópia e rótulos de botões.
  4. Compilar e Gate de Compilação:
    • Execute o comando de compilação do workspace:
      npm run build
      
    • Se ocorrer qualquer erro TypeScript ou importação faltando, corrija imediatamente e re-execute até que a compilação seja aprovada com código 0.
  5. Relatar ao Usuário:
    • Em todas as respostas conversacionais e relatórios de progresso, aplique a Regra de Zero Travessão (nunca use — ou --). Use pontos finais, dois pontos, vírgulas ou parênteses.
    • Forneça um resumo limpo dos arquivos construídos com links clicáveis:
      • [supersite-plan.md](file:///path/to/supersite-plan.md)
      • [page.tsx](file:///path/to/src/app/page.tsx)
      • Links individuais de componentes em src/components/site/
    • Confirme a compilação bem-sucedida.

Individual skills in this repo

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

Habilidades Relacionadas