Add simple prompt example for Python API generation

[AchuthReddy-16]

This PR adds a minimal prompt-driven example demonstrating prompt-as-source for generating code, tests, and documentation.

[gltanaka]

Thanks for this contribution! A FastAPI example is a great addition — it's a popular framework and this would be a practical, beginner-friendly example for the project.

Feedback

The prompt content itself is well-structured with clear sections (Goal, Requirements, Testing, Documentation, Output Files, Constraints). However, there are a few structural changes needed to align with the existing examples:

1. Directory Structure

Other examples live in their own subdirectories:

• examples/hello/hello_python.prompt
• examples/pi_calc/pi_calc_python.prompt
• examples/agentic_fallback_example/main_python.prompt

Please create a subdirectory like examples/fastapi_health/ or examples/simple_api/ and place the prompt there.

2. Naming Convention

Existing prompts follow the pattern <name>_<language>.prompt. Consider renaming to something like:

• fastapi_health_python.prompt
• simple_api_python.prompt

3. Documentation

Please add an entry to examples/README.md describing this new example, similar to how other examples are documented there.

---

Once these changes are made, this will be ready to merge. Looking forward to your updates, and thanks again for contributing to PDD! 🙌

[AchuthReddy-16]

Thanks for the detailed feedback — much appreciated! I’ll update the example to follow the existing directory structure and naming conventions, and I’ll add an entry to examples/README.md. I’ll push the changes shortly.

…

On Sun, Jan 25, 2026 at 4:49 PM Greg Tanaka ***@***.***> wrote: *gltanaka* left a comment (promptdriven/pdd#388) <#388 (comment)> Thanks for this contribution! A FastAPI example is a great addition — it's a popular framework and this would be a practical, beginner-friendly example for the project. Feedback The prompt content itself is well-structured with clear sections (Goal, Requirements, Testing, Documentation, Output Files, Constraints). However, there are a few structural changes needed to align with the existing examples: 1. Directory Structure Other examples live in their own subdirectories: - examples/hello/hello_python.prompt - examples/pi_calc/pi_calc_python.prompt - examples/agentic_fallback_example/main_python.prompt Please create a subdirectory like examples/fastapi_health/ or examples/simple_api/ and place the prompt there. 2. Naming Convention Existing prompts follow the pattern <name>_<language>.prompt. Consider renaming to something like: - fastapi_health_python.prompt - simple_api_python.prompt 3. Documentation Please add an entry to examples/README.md describing this new example, similar to how other examples are documented there. ------------------------------ Once these changes are made, this will be ready to merge. Looking forward to your updates, and thanks again for contributing to PDD! 🙌 — Reply to this email directly, view it on GitHub <#388 (comment)>, or unsubscribe <https://github.com/notifications/unsubscribe-auth/BRVLIIE5KANWNGIRJP6CEK34IVB6HAVCNFSM6AAAAACSZASRKOVHI2DSMVQWIX3LMV43OSLTON2WKQ3PNVWWK3TUHMZTOOJXGM2TINJXGE> . You are receiving this because you authored the thread.Message ID: ***@***.***>