Wrote about this myself a while ago, especially around the topic of discoverability: https://slinkydeveloper.com/blog/designing-apis-for-vibe-cod...

It's nice to see more people are exploring this topic.