AI-readiness score · @halden/ui 4.2.0

Halden (privado, ficticio)

Cómo de bien usa un agente de IA este design system, sin reglas y con reglas.

100→100
sin reglascon reglas

Si los tipos son buenos, la IA no necesita ayuda.

Casi no hay margen de mejora: el agente ya lo hace bien sin ayuda.

Las cifras

Uso de componentes del sistema
100% → 100%
Pantallas que no compilan
0/10 → 0/10
Valores escritos a mano
0 → 0
Atributos style
0 → 0

Lo más importante

Ejemplo: Formulario de registro, sin reglas

onChange={setName}

El agente respeta la convención propia (onChange recibe el valor) sin que nadie se lo diga: la sacó de los tipos.

Encargo por encargo

EncargoSin reglasProblemasCon reglasProblemas
Formulario de registro100—100—
Tabla de usuarios100—100—
Modal de borrado100—100—
Ajustes con pestañas100—100—
Sección de precios100—100—
Cabecera de app100—100—
Estado vacío100—100—
Avisos100—100—
Panel de filtros100—100—
Panel de inicio100—100—

Storybook ante la IA

Design system ficticio: tipos documentados en el paquete y Storybook simulado por MCP

  • Tipos completos y comentados dentro del paquete
  • Historias de 34 de 35 componentes servidas por MCP
  • Caso ideal: no representa a un design system real
Qué haríamos primero
  1. Medir el design system real del cliente: la diferencia con este caso ideal es lo que hay que arreglar.
  2. Si los tipos no se explican solos, documentarlos (comentarios, historias) y servirlos por MCP.
  3. Control en el CI para mantenerlo así cuando el design system cambie.
Método. 10 encargos de interfaz estándar lanzados a Claude Sonnet 5.5 (vía Claude Code) en un proyecto React + TypeScript con el paquete instalado. Una ejecución por encargo y condición. Sin reglas: solo se le dice qué design system usa el proyecto. Con reglas: además, un archivo CLAUDE.md con reglas, tabla de equivalencias e índice de componentes. Con reglas + MCP (Halden y EUI): además, un servidor MCP con props e historias de cada componente, como el de Storybook. + compilar (EUI): además, el agente puede ejecutar el comprobador de tipos. En el resto de condiciones no puede ejecutar comandos. Nota sobre 100: uso de componentes (40), compila sin errores de tipos (25), valores escritos a mano (20), componentes rehechos (15). Muestra pequeña: los resultados indican tendencias, no son una medición definitiva. 20 de noviembre de 2026.