Writing API docs an AI agent can actually consume

I found the gap the embarrassing way: one of my own agents couldn't call one of my own APIs. FamNest runs a small agent graph — a router hands a parent's message to a retriever, the retriever grounds