/design-handoff
Si ves marcadores de posición desconocidos o necesitas verificar qué herramientas están conectadas, consulta CONNECTORS.md.
Genera documentación completa de traspaso a desarrollo a partir de un diseño.
Uso
/design-handoff $ARGUMENTOS
Generar especificaciones de traspaso para: @$1
Si se proporciona una URL de Figma, extrae el diseño desde Figma. De lo contrario, trabaja a partir de la descripción o captura de pantalla proporcionada.
Qué Incluir
Especificaciones Visuales
- Mediciones exactas (padding, márgenes, anchos)
- Referencias a tokens de diseño (colores, tipografía, espaciado)
- Puntos de corte responsivos y comportamiento
- Variantes y estados de los componentes
Especificaciones de Interacción
- Comportamiento al hacer clic/tocar
- Estados hover
- Transiciones y animaciones (duración, easing)
- Soporte de gestos (deslizar, pellizcar, pulsación larga)
Especificaciones de Contenido
- Límites de caracteres
- Comportamiento de truncamiento
- Estados vacíos
- Estados de carga
- Estados de error
Casos Extremos
- Contenido mínimo/máximo
- Texto internacional (cadenas más largas)
- Conexiones lentas
- Datos faltantes
Accesibilidad
- Orden de foco
- Etiquetas y roles ARIA
- Interacciones por teclado
- Anuncios del lector de pantalla
Principios
- No asumas — Si no está especificado, el desarrollador adivinará. Especifica todo.
- Usa tokens, no valores — Referencia
spacing-mdno16px. - Muestra todos los estados — Predeterminado, hover, activo, desactivado, carga, error, vacío.
- Describe el porqué — "Esto se colapsa en móvil porque los usuarios usan principalmente una mano" ayuda a los desarrolladores a tomar buenas decisiones.
Salida
## Especificación de Traspaso: [Nombre de Pantalla/Funcionalidad]
### Resumen
[Qué hace esta pantalla/funcionalidad, contexto del usuario]
### Diseño
[Sistema de cuadrícula, puntos de corte, comportamiento responsivo]
### Tokens de Diseño Utilizados
| Token | Valor | Uso |
|-------|-------|-----|
| `color-primary` | #[hex] | Botones CTA, enlaces |
| `spacing-md` | [X]px | Entre secciones |
| `font-heading-lg` | [tamaño/peso/familia] | Título de página |
### Componentes
| Componente | Variante | Props | Notas |
|------------|----------|-------|-------|
| [Componente] | [Variante] | [Props] | [Comportamiento especial] |
### Estados e Interacciones
| Elemento | Estado | Comportamiento |
|----------|--------|----------------|
| [Botón CTA] | Hover | [Fondo oscurecer 10%] |
| [Botón CTA] | Carga | [Spinner, desactivado] |
| [Formulario] | Error | [Borde rojo, mensaje de error debajo] |
### Comportamiento Responsivo
| Punto de Corte | Cambios |
|----------------|---------|
| Escritorio (>1024px) | [Diseño predeterminado] |
| Tablet (768-1024px) | [Qué cambia] |
| Móvil (<768px) | [Qué cambia] |
### Casos Extremos
- **Estado vacío**: [Qué mostrar cuando no hay datos]
- **Texto largo**: [Reglas de truncamiento]
- **Carga**: [Esqueleto o spinner]
- **Error**: [Apariencia del estado de error]
### Animación / Movimiento
| Elemento | Disparador | Animación | Duración | Easing |
|----------|------------|-----------|----------|--------|
| [Elemento] | [Disparador] | [Descripción] | [ms] | [easing] |
### Notas de Accesibilidad
- [Orden de foco]
- [Etiquetas ARIA necesarias]
- [Interacciones por teclado]
Si Hay Conectores Disponibles
Si la herramienta de diseño está conectada:
- Extrae mediciones exactas, tokens y especificaciones de componentes desde Figma
- Exporta recursos y genera una hoja de especificaciones completa
Si el gestor de proyectos está conectado:
- Vincula el traspaso al ticket de implementación
- Crea subtareas para cada sección de la especificación
Consejos
- Comparte el enlace de Figma — Puedo extraer mediciones exactas, tokens e información de componentes.
- Menciona casos extremos — "¿Qué pasa con 100 elementos?" me ayuda a especificar condiciones límite.
- Especifica la pila tecnológica — "Usamos React + Tailwind" me ayuda a dar notas de implementación relevantes.