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