# AX-SYS-03: Mantén la documentación para máquinas sincronizada con el producto

> Context and comprehension · intermediate · AX-SYS-03

Vincula la documentación para agentes a los lanzamientos para que nunca actúen sobre endpoints obsoletos o parámetros deprecados.

## Por qué

El desfase entre el código y la documentación hace que los agentes generen llamadas contra parámetros deprecados (Fern). El marco canónico de AX (agentexperience.ax, Alineación Contextual) exige que el contexto se mantenga consistente con el producto en vivo, porque los agentes no pueden saber qué ha cambiado desde que se entrenó su modelo. A diferencia de los usuarios humanos, que ven avisos de obsolescencia, los agentes actúan sobre la documentación que reciben sin ninguna alternativa.

## Haz

Practica documentación como código en el mismo PR que los cambios de la API.

## No hagas

Mantener la documentación en un ciclo separado y más lento.

## Artefacto

Artefacto de proceso: añade una comprobación de CI que falle la compilación si un esquema de API cambia sin una actualización de documentación correspondiente en el mismo pull request. El artefacto es una comprobación de estado obligatoria, no código para desplegar.

## Fuentes

1. [agentexperience.ax — Principles of AX](https://agentexperience.ax/concepts/principles-of-ax/) — Contextual Alignment: maintain consistency of content with information accessible from human-oriented context systems; context quality must be robust to work across various models
2. [Fern — Optimizing API Docs for AI Agents](https://buildwithfern.com/post/optimizing-api-docs-ai-agents-llms-txt-guide) — Lag between code and documentation causes agents to generate calls against deprecated parameters, a leading cause of silent agent failures
3. [Mathias Biilmann — AX in Practice](https://biilmann.blog/articles/ax-in-practice/) — LLMs need to know which unique APIs, versions, or knowledge applies — especially anything that may have changed since the model's knowledge cut-off

---
Source: Agent Experience Principles (axprinciples.com)