Every operation should have a description long enough for an AI agent to understand what the operation does and call it correctly. Short or missing operation descriptions leave agents guessing about intent, inputs, and side effects, so descriptions should carry enough detail to be self-sufficient.
OpenAPI Operation Description Agent Sufficient Warn
Message: Operations SHOULD have a description long enough for an AI agent to call them correctly.
Policies
Operations Are Agent-Legible
I require that every operation in an OpenAPI carries a description rich enough that an agent can decide, from the definition alone, what the operation does, when to call it, and what it will get ba...
