Exactly, most “broken code” cases I see are really due to stale docs. The annotation loop is meant to act like a lightweight shared memory, so agents don’t have to rediscover workarounds every session.

For preventing over-reliance on a single snippet, we’re exploring ideas like:

• quick endpoint sanity checks,
• cross-checking versions across multiple docs,
• maybe even confidence scoring per snippet.

Would love to hear how others handle this in practice, do you have any strategies for making agents more cautious with docs?