Communitygithub.com

supersite-plan: Arquitecto Colaborativo

Arquitecto web colaborativo para agentes de codificación de IA. Realiza entrevistas estructuradas de frontera con opciones e instrucciones personalizadas, diseña la narrativa y estética del sitio, y genera una especificación completa en supersite-plan.md.

¿Qué es supersite-plan: Arquitecto Colaborativo?

supersite-plan es una habilidad especializada para agentes de codificación de IA (como Claude Code, Cursor, Codex) que planifica sitios web completos antes de escribir una sola línea de código. Su propósito principal es alinear las expectativas del usuario y el agente mediante una entrevista estructurada de frontera (cuatro áreas de descubrimiento) que cubre el alcance del sitio, la estética visual, la propuesta de valor y la relación con el código base. Tras la entrevista, la habilidad sintetiza la información en un contrato de proyecto llamado `supersite-plan.md`, que incluye el sistema de diseño (paleta 60-30-10, tipografía), la jerarquía de rutas, el desglose sección por sección con titulares y microcopias, un manifiesto de archivos y componentes, y criterios de verificación previa al vuelo. Este plan puede ser ejecutado posteriormente por otra habilidad (`/supersite-build`) para construir el sitio automáticamente. La habilidad impone reglas estrictas de calidad como la 'Regla Cero de la Raya' (prohibición de rayas em en el texto generado) y evita artefactos genéricos de IA, garantizando un diseño auténtico y de alto estándar.

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

Preguntar en tu IA favorita

Abre un nuevo chat con esta habilidad de agente ya precargada.

Documentación

📐 supersite-plan: Arquitecto Colaborativo

supersite-plan planifica el sitio web antes de escribir código. Evita expectativas desalineadas realizando una entrevista enfocada, estableciendo el sistema de diseño, redactando la secuencia narrativa y produciendo un contrato de proyecto completo supersite-plan.md.

Una vez que el plan está confirmado, el usuario simplemente ejecuta /supersite-build para implementarlo.


El Flujo de Planificación Colaborativa

┌─────────────────────────────────────────────────────────────┐
│ 1. Entrevista de Descubrimiento Multidimensional            │
│ Preguntas estructuradas de frontera (Opciones + Prompt      │
│ personalizado)                                              │
├─────────────────────────────────────────────────────────────┤
│ 2. Síntesis de Token de Diseño y Género                     │
│ Mapear selecciones a paleta 60-30-10, tipografía y         │
│ materiales                                                  │
├─────────────────────────────────────────────────────────────┤
│ 3. Arquitectura Narrativa y de Rutas                        │
│ Detallar secuencia de secciones, titulares y desglose de    │
│ componentes                                                 │
├─────────────────────────────────────────────────────────────┤
│ 4. Generar Contrato de Especificación supersite-plan.md     │
│ Persistir la arquitectura completa para su ejecución por    │
│ /supersite-build                                            │
└─────────────────────────────────────────────────────────────┘

Paso 1: La Entrevista de Descubrimiento de Frontera

Haz al usuario un conjunto de preguntas dirigidas. Para cada pregunta, proporciona opciones estructuradas con un valor predeterminado recomendado, invitando explícitamente a instrucciones personalizadas.

Patrón de Pregunta:

Pregunta [N]: [Tema]
[A] (Recomendado) Descripción de la opción 1
[B] Descripción de la opción 2
[C] Descripción de la opción 3

👉 Responde con la letra de una opción (A, B, C) o escribe tus propias instrucciones específicas directamente.

La Regla Cero de la Raya (Obligatorio)

Al hacer preguntas, redactar opciones, formular copias o responder al usuario, NUNCA uses una raya (— o --). Las rayas hacen que las preguntas y opciones de la entrevista parezcan texto sintético de IA. Divide las ideas en oraciones limpias y seguras, o utiliza dos puntos, comas o paréntesis en su lugar.

Las 4 Áreas de Descubrimiento:

1. Alcance del Sitio y Jerarquía de Rutas

  • [A] (Recomendado) Página de Aterrizaje de Alta Conversión: Narrativa de desplazamiento de una sola página optimizada para máxima velocidad de conversión (Hero -> Problema -> Vista Previa del Producto -> Prueba Social -> Precios -> CTA).
  • [B] Arquitectura SaaS Multipágina: Estructura multi-ruta (/ Inicio, /features Análisis Detallado, /pricing Matriz y FAQ, /security Cumplimiento).
  • [C] Portafolio de Estudio y Casos de Éxito: Escaparate visual (/ Demostración, /work/[slug] Casos de Éxito Interactivos, /inquire Formulario de Contacto).

2. Género Estético y Base de Materiales

  • [A] (Recomendado) Precisión Oscura: Superficies de obsidiana (#09090b), bordes finos (border-white/10), telemetría monoespaciada, acento láser esmeralda o cian.
  • [B] Lujo Silencioso: Lienzo de marfil táctil (#faf8f5), tinta verde bosque profundo (#0c2217), detalles en champán dorado, titulares serif editoriales.
  • [C] Editorial Suizo: Papel de periódico de gran formato, cuadrículas divisorias sólidas de 1px negro, acentos rojo bermellón, contraste grotesco/serif audaz.
  • [D] Empresa Moderna: Superficies blancas nítidas, acentos de confianza azul marino profundo, cintas de cumplimiento SOC2/HIPAA, tablas comparativas densas.
  • [E] Consumidor Audaz: Lienzo crema cálido, bordes de tinta sólidos de 2.5px, sombras paralelas duras, acentos neón llamativos, microcopia juguetona.
  • [F] Estudio Cinematográfico: Escenario teatral oscuro a pantalla completa, viñeta de fondo ambiental, demostración de producto en vivo, marcadores de escena impulsados por desplazamiento.

3. Capacidad Central y Contraste

  • ¿Qué fricción específica o statu quo roto elimina este producto?
  • ¿Qué métrica concreta y cuantificable demuestra tu superioridad (por ejemplo, "Arranques en frío por debajo de 14 ms", "Sin márgenes de salida de AWS" en lugar de un genérico "Rápidísimo")?

4. Relación con el Código Base

  • [A] (Recomendado) Construcción Limpia desde Cero: Nuevo proyecto usando Next.js, React, Tailwind CSS e iconos Lucide estándar.
  • [B] Heredar del Código Base Existente (from-codebase): Inspeccionar el repositorio local (globals.css, tokens de Tailwind, package.json) para coincidir con la marca del producto existente.

Paso 2: Sintetizar el Contrato del Proyecto

Una vez que el usuario proporcione sus respuestas o instrucciones:

  1. Carga el plano del género correspondiente desde ../supersite/references/genres/.
  2. Aplica las reglas anti-relleno de ../supersite/references/anti-slop.md.
  3. Redacta titulares y copias auténticas y de alto estatus usando ../supersite/references/copy-craft.md.
  4. Define el desglose de componentes componibles basado en ../supersite/references/component-system.md.
  5. Aplica la Regla Cero de la Raya: asegúrate de que supersite-plan.md no contenga rayas (— o --) en sus descripciones, planos de sección, titulares y microcopias.

Paso 3: Escribir supersite-plan.md

Persiste la arquitectura acordada en supersite-plan.md en la raíz del proyecto:

# ⚡ Contrato de Especificación supersite: [Nombre del Proyecto]

> Generado por `/supersite-plan`. Ejecutar con `/supersite-build`.

## 1. Resumen del Proyecto y Público Objetivo
* **Producto:** [Descripción concisa del producto]
* **Público Objetivo:** [Rol específico, ej., Ingenieros de Infraestructura Senior]
* **Objetivo de Conversión Principal:** [Ej., Implementar clúster de staging gratuito / Reservar demo empresarial]

## 2. Tokens del Sistema de Diseño
* **Género Estético:** [Ej., Precisión Oscura]
* **Paleta 60-30-10:**
  * 60% Lienzo: `#09090b` (Obsidiana)
  * 30% Estructural: `#121317` (Paneles) / `#27272a` (Bordes Finos) / `#fafafa` (Tinta)
  * 10% Acento Láser: `#10b981` (Esmeralda Eléctrica)
* **Tipografía:** Display (`Geist Sans`), Telemetría (`Geist Mono`)
* **Radio de Esquina:** `rounded-lg` (8px para botones, 12px para tarjetas)

## 3. Navegación del Sitio y Jerarquía de Rutas
* Ruta 1: `/` (Narrativa de conversión de inicio)
* Ruta 2: `/features` (Análisis detallado de arquitectura y API)
* Ruta 3: `/pricing` (Matriz de niveles interactiva y FAQ)

## 4. Plano Sección por Sección
* **Barra de Navegación:** Cabecera pegajosa de vidrio esmerilado (`backdrop-blur-md`), logo, enlaces, CTA principal.
* **Sección 1 (Hero):**
  * Píldora: `v2.4 LANZAMIENTO // CACHÉ DE VECTORES DISTRIBUIDO`
  * Titular: *"Implementa indexación de vectores sin servidor con réplicas de solo lectura globales de 12 ms."*
  * Subtítulo: *"Almacena embeddings en el borde. Sincronización automática en 32 regiones sin márgenes de salida."*
  * CTA: *"Implementar Clúster Ahora"* + *"Leer el RFC"*
  * Visual del Producto: Terminal interactivo con pestañas en vivo (`TypeScript` / `cURL`).
* **Sección 2 (Contraste del Problema):** Comparación Antes/Después de cuellos de botella de bases de datos centralizadas vs. caché de borde distribuido.
* **Sección 3 (Bento de Características):** 3 celdas asimétricas (diagrama de flujo de arquitectura, gráfico de latencia, muestra ergonómica de SDK).
* **Sección 4 (Prueba Social):** Métricas cuantificadas (14.2M vectores diarios, 99.99% de disponibilidad) + 2 citas verificadas de ingenieros.
* **Sección 5 (Matriz de Precios):** Desarrollador (Gratis), Equipo ($49/mes), Empresa (Personalizado) con alternancia de intervalo de facturación.
* **Sección 6 (FAQ):** 4 acordeones de divulgación técnica.
* **Pie de Página:** Mapa del sitio, indicador de estado, derechos de autor e insignias de cumplimiento.

## 5. Manifiesto de Archivos y Componentes
* `src/components/ui/container.tsx`
* `src/components/ui/section-header.tsx`
* `src/components/ui/button.tsx`
* `src/components/site/navbar.tsx`
* `src/components/site/hero.tsx`
* `src/components/site/problem-contrast.tsx`
* `src/components/site/feature-grid.tsx`
* `src/components/site/social-proof.tsx`
* `src/components/site/pricing-matrix.tsx`
* `src/components/site/faq-accordion.tsx`
* `src/components/site/footer.tsx`
* `src/config/site.ts`
* `src/types/site.ts`

## 6. Criterios de Verificación Previa al Vuelo
* Sin orbes degradados púrpura ni manchas genéricas de IA.
* Cumplimiento de contraste WCAG 2.2 AA (texto >=4.5:1, bordes de interfaz >=3.0:1).
* Objetivos táctiles móviles >=44x44px.
* `npm run build` se ejecuta sin errores de TypeScript ni advertencias de estilo.

Paso 4: Indicación de Acción Siguiente

Después de escribir supersite-plan.md, informa al usuario:

Plan completado. El contrato de arquitectura se ha escrito en supersite-plan.md. Revisa el plan o solicita cualquier ajuste. Cuando estés listo para construir el sitio, ejecuta: /supersite-build

Individual skills in this repo

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

Skills relacionados