Start writing the official OpenAPI API spec

[scottpersinger]

We should start crafting the API spec for the protocol. Easy for a pretty minimal set of endpoints. Harder part will be all the JSON schemas.

Actually this is a great job for Claude! So once we get the terms right in the README, we can do this:

• Craft a Claude prompt for generating the API spec from the README
• Commit that prompt to the repo
• Use the prompt to create the spec

Question is how to do edits? Do we try to always round trip through Claude again, or at some point do we accept hand editing the spec?

[NeuroPeakX]

!