/sistema-de-diseño
Si ves marcadores de posición desconocidos o necesitas comprobar 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
/design-system audit # Auditoría completa del sistema
/design-system document [componente] # Documentar un componente
/design-system extend [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, pesos, alturas de línea)
- Espaciado (escala, rellenos de componentes)
- Bordes (radio, ancho)
- Sombras (niveles de elevación)
- Movimiento (duraciones, easing)
Componentes
Elementos de interfaz reutilizables con:
- Variantes (primario, secundario, ghost)
- Estados (normal, hover, activo, deshabilitado, cargando, error)
- Tamaños (sm, md, lg)
- Comportamiento (interacciones, animaciones)
- Accesibilidad (ARIA, teclado)
Patrones
Soluciones de interfaz comunes 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
- Documenta todo — Si no está documentado, no existe
- Versiones y migraciones — Los cambios importantes 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 en Nombres
| Problema | Componentes | Recomendación |
|----------|-------------|---------------|
| [Nombre inconsistente] | [Lista] | [Estándar a adoptar] |
### Cobertura de Tokens
| Categoría | Definido | 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 | Docs | 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 | Cuándo Usar |
|----------|-------------|
| [Primario] | [Acciones principales] |
| [Secundario] | [Acciones secundarias] |
### Props / Propiedades
| Propiedad | Tipo | Valor por defecto | Descripción |
|-----------|------|------------------|-------------|
| [prop] | [tipo] | [defecto] | [descripción] |
### Estados
| Estado | Visual | Comportamiento |
|--------|--------|----------------|
| Normal | [descripción] | — |
| Hover | [descripción] | [interacción] |
| Activo | [descripción] | [interacción] |
| Deshabilitado | [descripción] | No interactivo |
| Cargando | [descripción] | [animación] |
### Accesibilidad
- **Rol**: [rol ARIA]
- **Teclado**: [comportamiento de Tab, Enter, Escape]
- **Lector de pantalla**: [Se anuncia como...]
### Lo que se debe y no se debe hacer
| ✅ Sí | ❌ No |
|------|------|
| [Mejor práctica] | [Antipatrón] |
### Ejemplo de Código
[Fragmento de código apropiado para el framework]
Salida — Ampliar
## Nuevo Componente: [Nombre]
### Problema
[Qué necesidad del usuario o brecha soluciona este componente]
### Patrones Existentes
| Componente Relacionado | Similitud | Por Qué No Es Suficiente |
|------------------------|-----------|--------------------------|
| [Componente] | [Qué comparten] | [Qué falta] |
### Diseño Propuesto
#### API / Props
| Propiedad | Tipo | Valor por defecto | Descripción |
|-----------|------|------------------|-------------|
| [prop] | [tipo] | [defecto] | [descripción] |
#### Variantes
| Variante | Cuándo Usar | Visual |
|----------|-------------|--------|
| [Variante] | [Escenario] | [Descripción] |
#### Estados
| Estado | Comportamiento | Notas |
|--------|----------------|-------|
| Normal | [Descripción] | — |
| Hover | [Descripción] | [Interacción] |
| Deshabilitado | [Descripción] | No interactivo |
| Cargando | [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:
- Auditar componentes directamente en Figma — verificar nombres, variantes y uso de tokens
- Extraer propiedades de componentes y estructura de capas para documentación
Si ~~base de conocimiento está conectada:
- Buscar documentación de componentes existente y pautas de uso
- Publicar documentación actualizada en tu wiki
Consejos
- Comienza 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 componentes documentados supera al 100% de 10 componentes.