Qué necesita un agente de tu sistema de diseño
Un punto de partida para describir componentes de forma que un equipo y un agente puedan usarlos con el mismo criterio.
Empieza por un componente
Elige uno que aparezca en varias pantallas. Documenta su propósito, las variantes permitidas, qué datos espera y qué estados contempla. Un botón, por ejemplo, puede especificar cuándo usar el estilo primario y cómo indicar que una acción está en curso.
Conecta la regla con la implementación
Identifica el componente equivalente en código y vincula las decisiones visuales a sus tokens. Añade un ejemplo correcto y un caso límite para que la regla pueda comprobarse en una revisión.
Prueba con una tarea pequeña
Pide al agente que use el componente en un flujo real y comprueba dónde toma una decisión que el contrato deja abierta. Usa esa observación para ajustar la documentación antes de extenderla a más componentes.