/sistema-de-diseño
Si ves marcadores de posición desconocidos o necesitas verificar qué herramientas están conectadas, consulta CONNECTORS.md.
Gestiona tu sistema de diseño — audita la consistencia, documenta componentes o diseña nuevos patrones.
Uso
/sistema-de-diseño auditoría # Auditoría completa del sistema
/sistema-de-diseño documentar [componente] # Documentar un componente
/sistema-de-diseño extender [patrón] # Diseñar un nuevo componente o patrón
Componentes de un Sistema de Diseño
Tokens de Diseño
Valores atómicos que definen el lenguaje visual:
- Colores (marca, semánticos, neutros)
- Tipografía (escala, grosores, alturas de línea)
- Espaciado (escala, padding de componentes)
- Bordes (radio, ancho)
- Sombras (niveles de elevación)
- Movimiento (duraciones, aceleraciones)
Componentes
Elementos de UI reutilizables con definidos:
- Variantes (primaria, secundaria, fantasma)
- Estados (predeterminado, hover, activo, deshabilitado, carga, error)
- Tamaños (sm, md, lg)
- Comportamiento (interacciones, animaciones)
- Accesibilidad (ARIA, teclado)
Patrones
Soluciones comunes de UI que combinan componentes:
- Formularios (grupos de entrada, validación, envío)
- Navegación (barra lateral, pestañas, migas de pan)
- Visualización de datos (tablas, tarjetas, listas)
- Retroalimentación (toasts, modales, mensajes en línea)
Principios
- Consistencia sobre creatividad — El sistema existe para que los equipos no reinventen la rueda.
- Flexibilidad dentro de restricciones — Los componentes deben ser componibles, no rígidos.
- Documentar todo — Si no está documentado, no existe.
- Versionar y migrar — Los cambios disruptivos necesitan rutas de migración.
Salida — Auditoría
## Auditoría del Sistema de Diseño
### Resumen
**Componentes revisados:** [X] | **Problemas encontrados:** [X] | **Puntuación:** [X/100]
### Consistencia de Nombres
| Problema | Componentes | Recomendación |
|----------|-------------|---------------|
| [Nombre inconsistente] | [Lista] | [Estándar a adoptar] |
### Cobertura de Tokens
| Categoría | Definidos | Valores Codificados Encontrados |
|-----------|-----------|--------------------------------|
| Colores | [X] | [X] instancias de hex codificado |
| Espaciado | [X] | [X] instancias de valores arbitrarios |
| Tipografía | [X] | [X] instancias de fuentes/tamaños personalizados |
### Completitud de Componentes
| Componente | Estados | Variantes | Documentación | Puntuación |
|------------|---------|-----------|---------------|------------|
| Botón | ✅ | ✅ | ⚠️ | 8/10 |
| Entrada | ✅ | ⚠️ | ❌ | 5/10 |
### Acciones Prioritarias
1. [Mejora de mayor impacto]
2. [Segunda prioridad]
3. [Tercera prioridad]
Salida — Documentar
## Componente: [Nombre]
### Descripción
[Qué es este componente y cuándo usarlo]
### Variantes
| Variante | Usar Cuando |
|----------|-------------|
| [Primaria] | [Acciones principales] |
| [Secundaria] | [Acciones de apoyo] |
### Props / Propiedades
| Propiedad | Tipo | Predeterminado | Descripción |
|-----------|------|----------------|-------------|
| [prop] | [tipo] | [predeterminado] | [descripción] |
### Estados
| Estado | Visual | Comportamiento |
|--------|--------|----------------|
| Predeterminado | [descripción] | — |
| Hover | [descripción] | [interacción] |
| Activo | [descripción] | [interacción] |
| Deshabilitado | [descripción] | No interactivo |
| Carga | [descripción] | [animación] |
### Accesibilidad
- **Rol**: [rol ARIA]
- **Teclado**: [comportamiento Tab, Enter, Escape]
- **Lector de pantalla**: [Se anuncia como...]
### Qué Hacer y Qué No Hacer
| ✅ Hacer | ❌ No Hacer |
|----------|-------------|
| [Mejor práctica] | [Anti-patrón] |
### Ejemplo de Código
[fragmento de código apropiado al framework]
Salida — Extender
## Nuevo Componente: [Nombre]
### Problema
[Qué necesidad del usuario o brecha aborda este componente]
### Patrones Existentes
| Componente Relacionado | Similitud | Por Qué No Es Suficiente |
|------------------------|-----------|--------------------------|
| [Componente] | [Qué comparten] | [Qué falta] |
### Diseño Propuesto
#### API / Props
| Propiedad | Tipo | Predeterminado | Descripción |
|-----------|------|----------------|-------------|
| [prop] | [tipo] | [predeterminado] | [descripción] |
#### Variantes
| Variante | Usar Cuando | Visual |
|----------|-------------|--------|
| [Variante] | [Escenario] | [Descripción] |
#### Estados
| Estado | Comportamiento | Notas |
|--------|----------------|-------|
| Predeterminado | [Descripción] | — |
| Hover | [Descripción] | [Interacción] |
| Deshabilitado | [Descripción] | No interactivo |
| Carga | [Descripción] | [Animación] |
#### Tokens Utilizados
- Colores: [Qué tokens]
- Espaciado: [Qué tokens]
- Tipografía: [Qué tokens]
### Accesibilidad
- **Rol**: [rol ARIA]
- **Teclado**: [Interacciones esperadas]
- **Lector de pantalla**: [Se anuncia como...]
### Preguntas Abiertas
- [Decisión que necesita revisión de diseño]
- [Caso límite por resolver]
Si Hay Conectores Disponibles
Si ~~herramienta de diseño está conectada:
- Audita componentes directamente en Figma — verifica nombres, variantes y uso de tokens.
- Extrae propiedades de componentes y estructura de capas para documentación.
Si ~~base de conocimiento está conectada:
- Busca documentación existente de componentes y pautas de uso.
- Publica documentación actualizada en tu wiki.
Consejos
- Empieza con una auditoría — Conoce dónde estás antes de decidir hacia dónde ir.
- Documenta mientras construyes — Es más fácil documentar un componente mientras lo diseñas.
- Prioriza la cobertura sobre la perfección — El 80% de los componentes documentados supera al 100% de 10 componentes.