AI-Driven API Design

Chapter 1. Meet Your First Coach

A Note for Early Release Readers

With Early Release ebooks, you get books in their earliest form—the author’s raw and unedited content as they write—so you can take advantage of these technologies long before the official release of these titles.

This will be the 1st chapter of the final book. Please note that the GitHub repo will be made active later on.

If you’d like to be actively involved in reviewing and commenting on this draft, please reach out to the editor at [e-mail].

Vignette to come.

Figure 1-1. Image to come

hello-coach

Welcome. This is a quiet place to slow down a bit
and build something small on purpose.

When you are ready, just say yes, and we will begin.

What you see above is the start of an interaction with a specially-built “AI Coach”. Artificial Intelligence (AI) coaches are specialized system prompts or context files designed to facilitate structured inquiry. Unlike a standard chat bot, a coach follows a specific workflow to help you explore design trade-offs before generating code. I have built many coaches like this over the last year and have collected a set of them here in this book to help us design great web Application Programming Interfaces (APIs). And this one is your introduction to the world of AI coaches.

We’ll take this time to work through a small example of AI coaching. Along the way, I’ll share ...