I have two questions about your statement:
1) Forge Documentation - You say that Forge documentation “consistently” models REST API calls as backend responsibilities. And yet, the Forge CLI automatically provisions an Agents.md file with the following guidance:
When calling product APIs, it is often simpler to make API requests on the frontend using
requestJira,requestConfluence, etc from the@forge/bridgepackage, rather than using a resolver on the backend.
That seems like an inconsistency. Is this guidance in Agents.md incorrect?
Internal Guidance – What is “internal guidance”? If it’s internal to Atlassian, does that mean we (external developers) don’t have access to it? And if so, how is it relevant?