Un agente que quiera construir con Shopify Polaris llama a la puerta de polaris.shopify.com/llms.txt, el sitio donde por convención se deja el índice para máquinas, y recibe un 404. Prueba entonces con la portada de la documentación, que sí responde, y lo primero que se encuentra en la cabecera es esto: <meta name="robots" content="noai, noimageai">. El mejor escaparate del sector está abierto de par en par para las personas y, en la misma línea de código, pide a la inteligencia artificial que no lo use.
Conviene ser exacto con lo que eso es y lo que no. noai no cierra nada: es una señal, una petición a los sistemas de IA para que no aprovechen el contenido, y depende por completo de que el otro lado quiera hacerle caso. No hay candado. Pero una señal es una decisión de diseño, y esta dice algo muy concreto sobre quién es bienvenido a leer.
Las llamadas de hoy, todas hechas esta mañana y todas verificables: Polaris, sin llms.txt (404). Material Design 3, sin llms.txt (404). IBM Carbon, con llms.txt (200), que se presenta a la máquina con una frase entera de contexto antes de darle el índice. Atlassian Design System, con llms.txt (200), que se describe como un conjunto unificado de componentes, tokens y primitivas. Dos de cuatro han escrito su README para agentes. Dos no.
El detalle de Carbon y Atlassian no es que el fichero exista, sino lo que han metido dentro. Ambos empiezan explicando qué son antes de enumerar qué tienen. Es la diferencia entre entregarle a un recién llegado el plano del edificio o una lista de puertas. Un agente que lee eso sabe en qué sistema está antes de tocar un componente, y esa frase de contexto vale más que cien páginas de documentación bonita que la máquina nunca abrirá.
Quién gana y quién paga con el cartel de Polaris. Gana Shopify a corto plazo: protege una obra en la que ha invertido años y no regala material de entrenamiento a modelos que no controla. Es una postura defendible y muchos equipos la comparten. Paga el equipo que ya usa Polaris y le pide a un agente que trabaje con él: ese agente no tiene puerta de entrada, así que improvisará a partir de lo que recuerde, que es exactamente el modo en que un sistema de diseño se rompe sin que nadie lo note.
El veredicto, con el criterio de esta casa: Polaris sigue siendo una de las mejores documentaciones del oficio para leer con ojos humanos, y hoy no ofrece a una máquina ni un índice ni una bienvenida. Carbon y Atlassian, más discretos en el escaparate, ya han escrito la línea que los hace consultables. Ninguno de los cuatro es mal sistema. Solo dos han entendido que ahora hay dos clases de lector.
La pregunta útil no es si llms.txt acabará siendo el estándar, que quizá no. Es más simple: si un agente entrara hoy en tu sistema, ¿encontraría una puerta, un cartel de prohibido o un 404 en silencio? Las tres respuestas son decisiones. Solo una de ellas se ha tomado a propósito.
Fuentes
- 01 Spec de sistema de diseño agéntico/herramientas/spec-sistema-agentico
A seguir
Redactado con ayuda de IA, contrastado contra su fuente y firmado por Redacción del Instituto.
Del diario al fondo de armario
- GlosarioAI-readiness de un design systemHasta qué punto un design system está preparado para que lo use una IA por su cuenta: con los valores de diseño (tokens) en un formato estándar, la documentación escrita de forma que una máquina pueda leerla, las reglas dichas de forma explícita y una vía de conexión (un servidor MCP) para que el agente lo consulte.
- GlosarioAuditoríaUna revisión ordenada y completa del sistema de diseño (sus componentes, sus valores base de estilo o tokens, su accesibilidad) para ver cómo está antes de decidir qué cambiar: qué es coherente y qué no, qué falta por cubrir y qué incumple las reglas.
- GlosarioDesign System ArchitectLa persona que diseña y mantiene la estructura de fondo de un sistema de diseño: cómo se organizan los valores base de estilo (los tokens) y los componentes para que el sistema aguante el paso del tiempo, crezca sin romperse y, cuando se trabaja con IA, lo puedan entender y usar también los agentes. Decide las reglas y los cimientos, no cada pantalla concreta.
