🔨 supersite-build: Constructor Quirúrgico
supersite-build ejecuta el plan arquitectónico establecido por /supersite-plan. Lee supersite-plan.md, construye componentes atómicos, conecta tokens de diseño y copia, y valida la implementación contra el motor de compilación.
El Pipeline de Ejecución
┌─────────────────────────────────────────────────────────────┐
│ 1. Leer y Validar el Contrato de Especificación │
│ Parsear tokens, rutas y manifiesto desde supersite-plan.md │
├─────────────────────────────────────────────────────────────┤
│ 2. Andamiaje, Tipos y Configuración │
│ Crear src/types/site.ts, src/config/site.ts y CSS base │
├─────────────────────────────────────────────────────────────┤
│ 3. Construir Primitivas de UI │
│ Container, SectionHeader, Button, Badge y Card │
├─────────────────────────────────────────────────────────────┤
│ 4. Construir Bloques de Sección │
│ Navbar, Hero, Contrast, Features, Proof, Pricing y Footer │
├─────────────────────────────────────────────────────────────┤
│ 5. Ensamblar Rutas y Verificar Compilación │
│ Cablear páginas, verificar accesibilidad y ejecutar npm run build │
└─────────────────────────────────────────────────────────────┘
Paso 1: Leer y Validar supersite-plan.md
- Buscar
supersite-plan.mden la raíz del espacio de trabajo.- Si falta, pausar e informar al usuario:
"No se encontró
supersite-plan.mden la raíz del proyecto. Ejecute/supersite-planpara diseñar su plan de forma colaborativa, o ejecute/supersite <prompt>para generar directamente."
- Si falta, pausar e informar al usuario:
- Parsear los parámetros arquitectónicos del plan:
- Género estético y paleta de colores (Hex/OKLCH, distribución 60-30-10).
- Elecciones de tipografía y radio de esquina.
- Manifiesto de rutas y componentes.
- Copia de secciones, titulares y elementos interactivos.
Paso 2: Andamiaje, Tipos y Configuración
- Verificar Dependencias:
- Asegurar que las utilidades estándar estén presentes (
lucide-react,clsx,tailwind-merge). Instalar si faltan:npm install lucide-react clsx tailwind-merge
- Asegurar que las utilidades estándar estén presentes (
- Generar Contratos TypeScript (
src/types/site.ts):- Definir tipos para
NavItem,FeatureItem,PricingPlan,TestimonialyFAQItem.
- Definir tipos para
- Generar Configuración Centralizada (
src/config/site.ts):- Almacenar enlaces de navegación, metadatos de marca y contenido estructurado de secciones en un solo lugar.
- Actualizar CSS Base (
src/app/globals.css):- Inyectar variables de color, estilos de selección y el bloque de accesibilidad de movimiento reducido:
@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; } }
- Inyectar variables de color, estilos de selección y el bloque de accesibilidad de movimiento reducido:
Paso 3: Construir Primitivas de UI (src/components/ui/)
Generar primitivas modulares:
container.tsx: Contenedor de ancho máximo (max-w-6xlomax-w-7xl) con padding responsive.section-header.tsx: Bloque estandarizado de badge, título y descripción.button.tsx: Botón basado en variantes (primary,secondary,outline,ghost) con estilos explícitos:focus-visible.badge.tsx: Chips de estado y píldoras con bordes finos.card.tsx: Envoltorio de superficie que aplica el color de superficie, borde y tokens de radio del plan.
Paso 4: Construir Bloques de Sección (src/components/site/)
Construir cada sección especificada en el plan:
navbar.tsx: Cabecera responsive con enlaces de navegación de escritorio, CTA de acción y menú hamburguesa móvil.hero.tsx: Píldora de gancho, título H1, párrafo principal, grupo de CTAs y vista previa interactiva del producto (por ejemplo, terminal o marco de UI).problem-contrast.tsx: Contraste visual asimétrico que ilustra el dolor del status quo versus la solución moderna.feature-grid.tsx: Cuadrícula bento asimétrica o celdas de características modulares. Sin copias repetitivas de 3 tarjetas.product-showcase.tsx: Componente interactivo (explorador de código con pestañas, vista previa interactiva en vivo o área de juegos de configuración).social-proof.tsx: Llamadas a métricas verificables y citas de testimonios de clientes con roles de ingeniería específicos.pricing-matrix.tsx: Alternancia de facturación Mensual/Anual (con"use client"), tarjetas de niveles, listas de verificación de características y CTAs de pago.faq-accordion.tsx: Preguntas y respuestas técnicas expandibles utilizando transiciones suaves de altura con CSS grid.footer.tsx: Enlaces de navegación multicolumna, anclajes legales, punto de estado del sistema y derechos de autor.
Paso 5: Ensamblar Rutas y Verificar Compilación
- Ensamblar
src/app/page.tsx:- Importar componentes de sección y componer el diseño narrativo en JSX limpio y declarativo.
- Ensamblar Rutas Adicionales:
- Si el plan especificó rutas multipágina (
/features,/pricing,/security), construir los archivospage.tsxcorrespondientes.
- Si el plan especificó rutas multipágina (
- Ejecutar Auditoría Anti-Slop Pre-Vuelo:
- Verificar estilos prohibidos: sin manchas de gradiente púrpura, sin tarjetas sin fundamento, sin copia de marcador de posición genérica.
- Verificar objetivos táctiles: confirmar que las áreas interactivas de impacto tengan ≥44×44px.
- Verificar guiones largos: confirmar que no haya guiones largos (
—o--) en ninguna copia de UI, titulares, microcopia o etiquetas de botón.
- Compilar y Puerta de Compilación:
- Ejecutar el comando de compilación del espacio de trabajo:
npm run build - Si ocurre algún error de TypeScript o falta una importación, corregirlo inmediatamente y re-ejecutar hasta que la compilación pase limpiamente con código 0.
- Ejecutar el comando de compilación del espacio de trabajo:
- Informar al Usuario:
- En todas las respuestas conversacionales e informes de progreso, hacer cumplir la Regla de Cero Guiones Largos (nunca usar
—o--). Usar puntos, dos puntos, comas o paréntesis en su lugar. - Proporcionar un resumen limpio de los archivos construidos con enlaces clicables:
[supersite-plan.md](file:///path/to/supersite-plan.md)[page.tsx](file:///path/to/src/app/page.tsx)- Enlaces a componentes individuales en
src/components/site/
- Confirmar la compilación exitosa.
- En todas las respuestas conversacionales e informes de progreso, hacer cumplir la Regla de Cero Guiones Largos (nunca usar