Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
Beyond annotations (readOnlyHint=true, destructiveHint=false), the description adds meaningful behavioral details: revisions are pre-edit, original ACL is included, explicit deletion purges revision text, and it is not a complete audit. These caveats help an agent understand limits and side effects.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.