Whoa there, you don't need to be so sadistic to your team. It's not GraphQL, but having a document describing how your API works, including types, that is important.

I expect you could achieve the same with a comprehensive OpenAPI specification. If you want something a bit stricter I guess SOAP would work too, LLMs love XML after all.

We have well described OpenAPI and GraphQL specifications already. :)

Being AI-first means we are naturally aligned with that kind of structured documentation. It helps both humans and robots.