Documentación legible por agentes
Documentar el sistema no solo con textos para personas, sino también en formatos ordenados (como JSON, YAML o Markdown) que una IA puede leer e interpretar sin equivocarse. Así el agente entiende las normas tal cual, sin tener que adivinarlas.
En una analogía · Es escribir el prospecto en un idioma que también entienda un robot, no solo en prosa para humanos.
También conocido como: machine-readable design
Una persona puede leer un PDF bonito con ejemplos y captar la idea. Una IA, no: si la norma vive solo en una imagen o en prosa ambigua, la pasa por alto. La documentación legible por agentes resuelve esto guardando la misma información en archivos estructurados que la máquina entiende línea a línea.
La clave es que no sustituye a la documentación para personas, la acompaña. El equipo sigue teniendo sus guías, y a la vez el agente tiene su versión fiable para trabajar sin inventar.
Lecturas de referencia
A seguir
Seguir leyendo
- GuíaFigma MCP para design systems: el circuito diseño-código sin handoffQué expone el servidor MCP de Figma, cómo lo consume un agente como Claude Code o Cursor, y qué tiene que tener tu design system para que el circuito funcione de verdad.
- GuíaCómo se implementa un MCP server para tu design systemAnatomía mínima de un servidor Model Context Protocol que expone los tokens, principios y componentes de tu sistema a un cliente agéntico.
- El ParteAgent Plugins estandarizaAgent Plugins 1.0.0 es una iniciativa que busca estandarizar la forma en que se empacan y distribuyen habilidades de agentes y servidores MCP
Recibe la próxima guía en tu correo
Una guía operativa nueva cada poco: cómo se construye, qué decisiones implica y qué no se hace. Sin ruido, solo cuando hay algo útil.