¿Qué hace 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 para desarrolladores a partir de un diseño.
Uso
/design-handoff $ARGUMENTOS
Genera especificaciones de traspaso para: @$1
Si se proporciona una URL de Figma, obtén el diseño desde Figma. De lo contrario, trabaja a partir de la descripción o captura de pantalla proporcionada.
Qué Incluir
Especificaciones Visuales
- Medidas exactas (padding, márgenes, anchos)
- Referencias a tokens de diseño (colores, tipografía, espaciado)
- Puntos de ruptura responsive y comportamiento
- Variantes de componentes y estados
Especificaciones de Interacción
- Comportamiento de clic/toque
- 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 Límite
- Contenido mínimo/máximo
- Texto internacional (cadenas más largas)
- Conexiones lentas
- Datos faltantes
Accesibilidad
- Orden de enfoque
- Etiquetas y roles ARIA
- Interacciones con teclado
- Anuncios de lector de pantalla
Principios
- No asumas: Si no se especifica, el desarrollador supondrá. Especifica todo.
- Usa tokens, no valores: Referencia
spacing-mdno16px. - Muestra todos los estados: Default, hover, activo, deshabilitado, carga, error, vacío.
- Describe el por qué: "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 la Funcionalidad/Pantalla]
### Resumen
[Qué hace esta pantalla/funcionalidad, contexto del usuario]
### Layout
[Sistema de rejilla, puntos de ruptura, comportamiento responsive]
### Tokens de Diseño Usados
| Token | Valor | Uso |
|-------|-------|------|
| `color-primary` | #[hex] | Botones CTA, enlaces |
| `spacing-md` | [X]px | Entre secciones |
| `font-heading-lg` | [tamaño/grosor/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 oscurece 10%] |
| [Botón CTA] | Cargando | [Spinner, deshabilitado] |
| [Formulario] | Error | [Borde rojo, mensaje de error debajo] |
### Comportamiento Responsive
| Punto de Ruptura | Cambios |
|------------------|---------|
| Escritorio (>1024px) | [Layout por defecto] |
| Tablet (768-1024px) | [Qué cambia] |
| Móvil (<768px) | [Qué cambia] |
### Casos Límite
- **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 enfoque]
- [Etiquetas ARIA necesarias]
- [Interacciones con teclado]
Si hay Conectores Disponibles
Si ~~herramienta de diseño está conectada:
- Obtén medidas exactas, tokens y especificaciones de componentes desde Figma
- Exporta activos y genera una hoja de especificaciones completa
Si ~~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 obtener medidas exactas, tokens e información de componentes.
- Menciona casos límite: "¿Qué pasa con 100 elementos?" me ayuda a especificar condiciones de borde.
- Especifica el stack tecnológico: "Usamos React + Tailwind" me ayuda a dar notas de implementación relevantes.