Habilidad de Laboratorio de Diseño
Esta habilidad implementa un flujo de trabajo completo de exploración de diseño: entrevista, generar variaciones, recopilar comentarios, refinar, previsualizar y finalizar.
CRÍTICO: Comportamiento de Limpieza
Todos los archivos temporales DEBEN eliminarse cuando el proceso termine, ya sea por:
- El usuario confirma el diseño final → limpiar, luego generar plan
- El usuario aborta/cancela → limpiar inmediatamente, no generar plan
Nunca dejes atrás .claude-design/ o rutas __design_lab. Si el usuario dice "cancelar", "abortar", "detener" o "olvídalo" en cualquier momento, confirma y luego elimina todos los artefactos temporales.
Fase 0: Detección Previa
Antes de comenzar la entrevista, detecta automáticamente:
Gestor de Paquetes
Busca archivos de bloqueo en la raíz del proyecto:
pnpm-lock.yaml→ usapnpmyarn.lock→ usayarnpackage-lock.json→ usanpmbun.lockb→ usabun
Detección de Framework
Busca archivos de configuración:
next.config.jsonext.config.mjsonext.config.ts→ Next.js- Busca el directorio
app/→ App Router - Busca el directorio
pages/→ Pages Router
- Busca el directorio
vite.config.jsovite.config.ts→ Viteremix.config.js→ Remixnuxt.config.jsonuxt.config.ts→ Nuxtastro.config.mjs→ Astro
Detección de Sistema de Estilos
Busca dependencias en package.json y archivos de configuración:
tailwind.config.jsotailwind.config.ts→ Tailwind CSS@mui/materialen dependencias → Material UI@chakra-ui/reacten dependencias → Chakra UIantden dependencias → Ant Designstyled-componentsen dependencias → styled-components@emotion/reacten dependencias → Emotion- Archivos
.csso.module.css→ CSS Modules
Verificación de Memoria de Diseño
Busca el archivo existente de Memoria de Diseño:
docs/design-memory.mdDESIGN_MEMORY.md.claude-design/design-memory.md
Si se encuentra, léelo y úsalo para rellenar valores predeterminados y omitir preguntas redundantes.
Inferencia de Estilo Visual (CRÍTICO)
NO uses estilos predefinidos/genéricos. Extrae el lenguaje visual del proyecto:
Si se detecta Tailwind, lee tailwind.config.js o tailwind.config.ts:
// Extrae y usa:
theme.colors // Paleta de colores
theme.spacing // Escala de espaciado
theme.borderRadius // Valores de radio
theme.fontFamily // Tipografía
theme.boxShadow // Sistema de elevación
Si existen Variables CSS, lee globals.css, variables.css o definiciones :root:
:root {
--color-* /* Tokens de color */
--spacing-* /* Tokens de espaciado */
--font-* /* Tokens de tipografía */
--radius-* /* Tokens de radio de borde */
}
Si se detecta una librería de UI (MUI, Chakra, Ant), lee la configuración del tema:
- MUI:
theme.tso llamadacreateTheme() - Chakra:
theme/index.tso llamadaextendTheme() - Ant: prop
themedeConfigProvider
Siempre escanea componentes existentes para entender los patrones:
- Encuentra 2-3 botones existentes → anota sus patrones de estilo
- Encuentra 2-3 tarjetas existentes → anota padding, bordes, sombras
- Encuentra formularios existentes → anota estilos de entrada, ubicación de etiquetas
- Encuentra tipografía existente → anota tamaños de encabezados, texto del cuerpo
Almacena los estilos inferidos en el Brief de Diseño para un uso consistente en todas las variantes.
Fase 1: Entrevista
Usa la herramienta AskUserQuestion para todos los pasos de la entrevista. Adapta las preguntas según la Memoria de Diseño si existe.
Paso 1.1: Alcance y Objetivo
Haz estas preguntas (pueden combinarse en una sola AskUserQuestion con múltiples preguntas):
Pregunta 1: Alcance
- Encabezado: "Alcance"
- Pregunta: "¿Estamos diseñando un solo componente o una página completa?"
- Opciones:
- "Componente" - Un elemento de UI reutilizable (botón, tarjeta, formulario, modal, etc.)
- "Página" - Un layout de página o pantalla completo
Pregunta 2: Nuevo o Rediseño
- Encabezado: "Tipo"
- Pregunta: "¿Es un diseño nuevo o un rediseño de algo existente?"
- Opciones:
- "Nuevo" - Crear algo desde cero
- "Rediseño" - Mejorar un componente/página existente
Si se selecciona "Rediseño", pregunta: Pregunta 3: Ruta Existente
- Encabezado: "Ubicación"
- Pregunta: "¿Cuál es la ruta de archivo o la ruta de la UI existente?"
- Opciones: (deja que el usuario proporcione mediante "Otro")
Si el objetivo no está claro, propón un nombre basado en los patrones del repositorio y confírmalo.
Paso 1.2: Puntos Débiles e Inspiración
Pregunta 1: Puntos Débiles
- Encabezado: "Problemas"
- Pregunta: "¿Cuáles son los principales puntos débiles con el diseño actual (o qué debería evitar este nuevo diseño)?"
- Opciones:
- "Demasiado recargado/denso" - Sobrecarga de información, difícil de escanear
- "Jerarquía poco clara" - Las acciones principales no son obvias
- "Mala experiencia móvil" - No funciona bien en pantallas pequeñas
- "Aspecto desactualizado" - Se siente antiguo o inconsistente con la marca
- multiSelect: true
Pregunta 2: Inspiración Visual
- Encabezado: "Estilo visual"
- Pregunta: "¿Qué productos o marcas debo referenciar para inspiración visual?"
- Opciones:
- "Stripe" - Limpio, minimalista, confiable
- "Linear" - Denso, primero el teclado, enfocado en desarrolladores
- "Notion" - Flexible, centrado en contenido, divertido
- "Apple" - Premium, espacioso, refinado
- multiSelect: true
Pregunta 3: Inspiración Funcional
- Encabezado: "Interacciones"
- Pregunta: "¿Qué patrones de interacción debo emular?"
- Opciones:
- "Edición en línea" - Editar en el lugar sin modales
- "Divulgación progresiva" - Mostrar más según sea necesario
- "Actualizaciones optimistas" - Retroalimentación instantánea, sincronización en segundo plano
- "Atajos de teclado" - Eficiencia para usuarios avanzados
Paso 1.3: Dirección de Marca y Estilo
Pregunta 1: Adjetivos de Marca
- Encabezado: "Tono de marca"
- Pregunta: "¿Qué 3-5 adjetivos describen la sensación de marca deseada?"
- Opciones:
- "Minimalista" - Limpio, simple, sin desorden
- "Premium" - De alta gama, pulido, refinado
- "Divertido" - Alegre, amigable, accesible
- "Utilitario" - Funcional, eficiente, directo
- multiSelect: true
Pregunta 2: Densidad
- Encabezado: "Densidad"
- Pregunta: "¿Qué densidad de información prefieres?"
- Opciones:
- "Compacto" - Más información visible, espaciado más ajustado
- "Cómodo" - Espaciado equilibrado, escaneo fácil
- "Espacioso" - Espacio en blanco generoso, atención enfocada
Pregunta 3: Modo Oscuro
- Encabezado: "Modo oscuro"
- Pregunta: "¿Se requiere modo oscuro?"
- Opciones:
- "Sí" - Debe soportar modo oscuro
- "No" - Solo modo claro
- "Agradable tenerlo" - Soporte si es fácil, no requerido
Paso 1.4: Persona y Trabajos por Hacer
Pregunta 1: Usuario Principal
- Encabezado: "Usuario"
- Pregunta: "¿Quién es el usuario final principal?"
- Opciones:
- "Desarrollador" - Técnico, orientado al teclado
- "Diseñador" - Visual, orientado a los detalles
- "Usuario de negocio" - Centrado en la eficiencia, menos técnico
- "Consumidor final" - Público general, habilidad técnica variada
Pregunta 2: Contexto
- Encabezado: "Contexto"
- Pregunta: "¿Cuál es el contexto de uso principal?"
- Opciones:
- "Primero escritorio" - Usado principalmente en pantallas grandes
- "Primero móvil" - Usado principalmente en teléfonos
- "Ambos por igual" - Debe funcionar bien en todos los dispositivos
Pregunta 3: Tareas Clave
- Encabezado: "Tareas clave"
- Pregunta: "¿Cuáles son las 3 tareas principales que los usuarios deben completar?"
- (Deja que el usuario proporcione mediante "Otro" - esto es abierto)
Paso 1.5: Restricciones
Pregunta 1: Elementos que Deben Mantenerse
- Encabezado: "Mantener"
- Pregunta: "¿Hay elementos que deben conservarse?"
- Opciones:
- "Copias/etiquetas existentes" - Mantener el texto actual
- "Campos/entradas actuales" - Mantener la estructura del formulario
- "Estructura de navegación" - Mantener la navegación actual
- "Ninguno" - Libre de cambiar todo
Pregunta 2: Restricciones Técnicas
- Encabezado: "Restricciones"
- Pregunta: "¿Hay restricciones técnicas?"
- Opciones:
- "Sin nuevas dependencias" - Usar solo librerías existentes
- "Usar componentes existentes" - Construir sobre el sistema de diseño actual
- "Debe ser accesible (WCAG)" - Requisitos estrictos de accesibilidad
- "Ninguna" - Sin restricciones especiales
- multiSelect: true
Fase 2: Generar Brief de Diseño
Después de la entrevista, crea un Brief de Diseño estructurado como JSON y guárdalo en .claude-design/design-brief.json:
{
"scope": "component|page",
"isRedesign": true|false,
"targetPath": "src/components/Example.tsx",
"targetName": "Example",
"painPoints": ["Demasiado denso", "Acción principal poco clara"],
"inspiration": {
"visual": ["Stripe", "Linear"],
"functional": ["Validación en línea"]
},
"brand": {
"adjectives": ["minimalista", "confiable"],
"density": "cómodo",
"darkMode": true
},
"persona": {
"primary": "Desarrollador",
"context": "primero-escritorio",
"keyTasks": ["Completar compra", "Revisar pedido", "Aplicar descuento"]
},
"constraints": {
"mustKeep": ["campos existentes"],
"technical": ["sin nuevas dependencias", "accesible WCAG"]
},
"framework": "nextjs-app",
"packageManager": "pnpm",
"stylingSystem": "tailwind"
}
Muestra un resumen al usuario antes de continuar.
Fase 3: Generar Laboratorio de Diseño
Estructura de Directorios
Crea todos los archivos bajo .claude-design/:
.claude-design/
├── lab/
│ ├── page.tsx # Página principal del laboratorio (específica del framework)
│ ├── variants/
│ │ ├── VariantA.tsx
│ │ ├── VariantB.tsx
│ │ ├── VariantC.tsx
│ │ ├── VariantD.tsx
│ │ └── VariantE.tsx
│ ├── components/
│ │ └── LabShell.tsx # Envoltorio de layout del laboratorio
│ ├── feedback/ # Sistema de comentarios interactivo
│ │ ├── types.ts # Interfaces de TypeScript
│ │ ├── selector-utils.ts # Identificación de elementos
│ │ ├── format-utils.ts # Formateo de comentarios
│ │ ├── FeedbackOverlay.tsx # Componente principal de superposición
│ │ └── index.ts # Exportaciones del módulo
│ └── data/
│ └── fixtures.ts # Datos simulados compartidos
├── design-brief.json
└── run-log.md
Configuración del Sistema de Comentarios (CRÍTICO - NUNCA SALTAR)
El FeedbackOverlay es la característica PRINCIPAL del Laboratorio de Diseño. Sin él, los usuarios no pueden proporcionar comentarios interactivos. NUNCA generes un Laboratorio de Diseño sin el FeedbackOverlay.
Estrategia de Fiabilidad: Para evitar problemas con rutas de importación en diferentes configuraciones de proyecto, crea el FeedbackOverlay directamente en el directorio de la ruta (ej., app/design-lab/FeedbackOverlay.tsx), NO en .claude-design/. Esto asegura que una importación relativa simple (./FeedbackOverlay) siempre funcione.
Archivos Requeridos en el Directorio de Ruta:
app/design-lab/ # o app/__design_lab/ si los guiones bajos funcionan
├── page.tsx # Página principal del laboratorio con variantes
└── FeedbackOverlay.tsx # Componente de superposición autocontenido (copia de plantillas)
Fuente de la Plantilla: design-and-refine/templates/feedback/FeedbackOverlay.tsx
Por qué este enfoque:
- Las rutas de
.claude-design/pueden fallar debido a configuraciones del empaquetador - Las importaciones relativas desde el mismo directorio siempre funcionan
- El directorio de la ruta se elimina durante la limpieza de todos modos
Integración de Ruta
Next.js App Router:
Crear app/__design_lab/page.tsx que importe desde .claude-design/lab/
Next.js Pages Router:
Crear pages/__design_lab.tsx que importe desde .claude-design/lab/
Vite React:
- Si React Router existe: agregar ruta a
/__design_lab - Si no hay router: crear un renderizado condicional en
App.tsxbasado en el parámetro de consulta?design_lab=true
Otros frameworks: Crear la ruta temporal más apropiada para el framework detectado.
Directrices de Generación de Variantes
IMPORTANTE: Lee DESIGN_PRINCIPLES.md para mejores prácticas de UX, interacción y movimiento. Pero NO uses estilos visuales predefinidos—infiérelos del proyecto.
Aplica principios universales (de DESIGN_PRINCIPLES.md):
- UX: Heurísticas de Nielsen, reducción de carga cognitiva, divulgación progresiva
- Comportamiento del componente: Estados de botón, anatomía de formulario, estructura de tarjeta
- Interacción: Patrones de retroalimentación, manejo de estados, actualizaciones optimistas
- Movimiento: Tiempo (150-300ms), aceleración (entradas con ease-out, salidas con ease-in)
- Accesibilidad: Estados de enfoque, patrones ARIA, objetivos táctiles (mínimo 44px)
Infiera los estilos visuales del proyecto:
- Colores → de la configuración de Tailwind, variables CSS o componentes existentes
- Tipografía → de encabezados existentes, texto del cuerpo en el código base
- Espaciado → de la escala de espaciado del proyecto o patrones existentes
- Radio de borde → de tarjetas, botones, entradas existentes
- Sombras → de componentes elevados existentes
Cada variante DEBE explorar un eje de diseño diferente. No crees variaciones menores—hazlas significativamente distintas. Usa el lenguaje visual existente del proyecto para todas las variantes.
Variante A: Enfoque en Jerarquía de Información
- Reestructurar la jerarquía de contenido (¿qué es más importante?)
- Aplicar proximidad de Gestalt—agrupar elementos relacionados más juntos
- Una acción principal por vista
- Usar la escala tipográfica existente para crear niveles claros
Variante B: Exploración de Modelo de Layout
- Probar un enfoque de layout diferente (tarjeta vs lista vs tabla vs panel dividido)
- Aplicar anatomía de tarjeta o patrones de comportamiento de tabla de DESIGN_PRINCIPLES
- Considerar el comportamiento responsivo en cada punto de quiebre
- Usar el sistema de cuadrícula/layout existente del proyecto
Variante C: Variación de Densidad
- Si el brief dice "cómodo", probar una versión más compacta
- Si el brief dice "compacto", probar una versión más espaciosa
- Usar los tokens de espaciado existentes del proyecto—solo aplicarlos de manera diferente
- Mostrar las compensaciones: más datos visibles vs escaneo más fácil
Variante D: Modelo de Interacción
- Patrón de interacción diferente (modal vs en línea vs panel vs cajón)
- Aplicar patrones de retroalimentación: inmediato → progreso → finalización
- Implementar todos los estados requeridos (carga, error, vacío, deshabilitado)
- Considerar actualizaciones optimistas para acciones no destructivas
Variante E: Dirección Expresiva
- Empujar la dirección de marca que el usuario describió en la entrevista
- Explorar diferentes usos de los tokens de diseño existentes del proyecto
- Más o menos uso de sombras, bordes, colores de fondo
- Aplicar movimiento donde añada significado (hover, focus, transiciones)
Requisitos de la Página de Laboratorio
La página del Laboratorio de Diseño debe incluir:
-
Encabezado con:
- Resumen del Brief de Diseño (objetivo, alcance, requisitos clave)
- Instrucciones para revisar
-
Cuadrícula de Variantes con:
- Etiquetas claras (A, B, C, D, E)
- Justificación breve para cada variante ("Por qué existe esto")
- La variante renderizada real
...
[truncado para traducción]