Cap 5: Skills de Diseño
Pipeline de diseño
Los skills de diseño de gstack producen código real, no solo recomendaciones:
flowchart LR
DC[/design-consultation/] -->|DESIGN.md + mockups| DS[/design-shotgun/]
DS -->|variante aprobada| DH[/design-html/]
DH -->|HTML producción| DR[/design-review/]
DR -->|fixes atómicos| SHIP[listo para ship]
/design-consultation
Construye un sistema de diseño completo desde cero para el proyecto.
Qué hace:
- Investiga el landscape competitivo de la categoría
- Propone opciones creativas (riesgosas) junto a opciones seguras
- Genera mockups interactivos en HTML (light + dark mode)
- Escribe
DESIGN.mdcomo fuente de verdad del diseño
Output estructurado:
DESIGN.md
├── Paleta de colores (primarios, secundarios, semánticos)
├── Tipografía (escala, pesos, line-heights)
├── Espaciado y grid
├── Componentes base (botones, inputs, cards)
├── Tono de voz (copy guidelines)
└── Decisiones de diseño con razonamiento
Cuándo usarlo: Al iniciar un proyecto nuevo o al rediseñar una sección completa.
/design-shotgun
Genera 3 variantes visuales distintas para una decisión de diseño.
Flujo:
- Usa GPT Image API para generar 3 mockups visuales con estilos diferentes
- Abre un board de comparación en el navegador
- Captura las aprobaciones del usuario para construir “taste memory”
- Las preferencias se guardan en
~/.gstack/projects/para coherencia futura
Ejemplos de variantes:
- Minimalista vs. rico en información vs. visual bold
- Luz vs. oscuro vs. colorido
- Dense vs. aireado vs. compacto
Por qué 3 y no 1: Evita anclar en la primera opción. Fuerza una decisión consciente de estilo.
/design-html
Convierte mockups aprobados en HTML de producción.
Características:
Pretext (text reflow inteligente):
- Adapta el texto sin medir el DOM
- Evita overflow y truncamiento invisible
- Funciona con contenido dinámico
Auto-detección de framework:
- Detecta si el proyecto usa React, Svelte, Vue o HTML puro
- Genera código en el formato correcto del proyecto
- Respeta convenciones de naming del codebase existente
Live-reload durante refinamiento:
Iteración 1: HTML base generado
→ Preview en navegador con live-reload
→ "El botón CTA es muy pequeño en mobile"
Iteración 2: Fix aplicado, screenshot before/after
→ "El espaciado del header necesita más aire"
Iteración 3: Fix aplicado
→ Aprobado
/design-review
Auditoría visual del sitio en vivo con fixes automáticos.
Checklist de 80 ítems que incluye:
- Jerarquía visual y scannability
- Consistencia de espaciado y tipografía
- Contraste y accesibilidad (WCAG)
- Responsive behavior
- Estados vacíos, de error y de carga
- Animaciones y transiciones
- Performance visual percibida
Proceso:
sequenceDiagram
participant DR as /design-review/
participant B as Browser
participant Git as Git
DR->>B: Screenshot inicial
DR->>DR: Auditoría contra checklist
loop Para cada issue
DR->>Git: Fix atómico en commit
DR->>B: Screenshot post-fix
DR->>DR: Before/after documentado
end
DR->>DR: Reporte final con métricas
Diferencia con /plan-design-review:
/plan-design-review— revisa el plan antes de construir/design-review— audita el sitio ya construido, hace fixes reales
Casos de uso combinados
Proyecto nuevo:
/office-hours → DESIGN.md con dirección del producto
/design-consultation → sistema de diseño completo
/design-shotgun → elige estilo visual
/design-html → HTML de producción
Refactor visual:
/design-review → auditoría completa del estado actual
→ fixes atómicos automáticos
→ reporte de mejoras
Feature nueva en proyecto existente:
/design-shotgun → genera variantes contextualizadas al sistema existente
/design-html → HTML adaptado al framework del proyecto
Integración con el design system existente
Si ya tienes un DESIGN.md o sistema de diseño establecido, los skills lo leen antes de generar cualquier output. No rompen convenciones existentes: las extienden.