Prompt generator helps AI agents implement a new email API

The post by mikeapple introduces a prompt generator built around a new email API aimed at Firebase developers. The author observed that Firebase handles basic auth well but lacks native support for app emails such as notifications and billing, and set out to build a solution. In doing so, they also tackled the question of how to effectively communicate a new, unfamiliar API to a coding agent.

The approach involves dynamically generating an OpenAPI spec via a script, which then feeds into a prompt generator.

The approach involves dynamically generating an OpenAPI spec via a script, which then feeds into a prompt generator. The author notes this technique is uncommon and explains why: striking the right balance in prompt specificity is genuinely difficult. A prompt must carry enough detail for an agent to implement the API correctly, yet remain abstract enough to be reusable across diverse codebases. The author is actively seeking feedback on both the approach and its execution.

Key facts

1. 01The project is an email API targeting Firebase app developers, covering use cases like notifications and billing emails.
2. 02The author dynamically generates an OpenAPI spec via a script.
3. 03The OpenAPI spec is used as the input for a prompt generator aimed at coding agents.
4. 04The author describes the prompt-specificity balance as a 'fine balance' — enough detail to implement the API, but not so specific it only works in one codebase.
5. 05The author notes this prompt-generator-from-spec approach is not something they have come across before.
6. 06The post invites community feedback on both the approach and its execution.

Topics