Give agents files they actually read, put documentation where the agent already is: your types, make the API self-explanatory.