🔨 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
- Procure por
supersite-plan.mdna raiz do workspace.- Se estiver faltando, pause e informe ao usuário:
"Nenhum
supersite-plan.mdencontrado na raiz do projeto. Execute/supersite-planpara projetar seu plano colaborativamente, ou execute/supersite <prompt>para gerar diretamente."
- Se estiver faltando, pause e informe ao usuário:
- 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
- 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
- Garanta que utilitários padrão estejam presentes (
- Gerar Contratos TypeScript (
src/types/site.ts):- Defina tipos para
NavItem,FeatureItem,PricingPlan,TestimonialeFAQItem.
- Defina tipos para
- 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.
- 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; } }
- Injete variáveis de cor, estilos de seleção e o bloco de acessibilidade de movimento reduzido:
Etapa 3: Construir Primitivas de UI (src/components/ui/)
Gere primitivas modulares:
container.tsx: Container de largura máxima (max-w-6xloumax-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
- Montar
src/app/page.tsx:- Importe componentes de seção e componha o layout narrativo em JSX limpo e declarativo.
- Montar Rotas Adicionais:
- Se o plano especificou rotas de várias páginas (
/features,/pricing,/security), construa os arquivospage.tsxcorrespondentes.
- Se o plano especificou rotas de várias páginas (
- 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.
- 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.
- Execute o comando de compilação do workspace:
- 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.
- Em todas as respostas conversacionais e relatórios de progresso, aplique a Regra de Zero Travessão (nunca use