One spec, two audiences: the human reading your docs and the agent calling your API

The team is shipping a set of inventory APIs. Developers need documentation. AI coding assistants need accurate interface structure. On the business side, people want to ask an AI about stock levels a