13.1The Documentation Staleness Problem

API docs go stale within weeks of writing. Engineers change endpoints, add fields, and adjust error codes -- but forget to update the docs. This creates a dangerous gap: consumers build against the documentation, but the implementation has diverged.

AI agents can solve this by continuously comparing the implementation to the documentation and creating pull requests to fix discrepancies.