scaffold-backend

Generate FastAPI backend applications from AGENTS.md and PRD.md specifications.

2|Updated Apr 14, 2026
One-click install
npx skills add https://github.com/emilyLi2020/WAVE --skill scaffold-backend
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: scaffold-backend
Source: https://github.com/emilyLi2020/WAVE/tree/main/.agents/skills/scaffold-backend
Command: npx skills add https://github.com/emilyLi2020/WAVE --skill scaffold-backend

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Manually building backend APIs for web projects is time-consuming and prone to inconsistencies, especially when you already have detailed product requirements and team conventions documented in PRD.md and AGENTS.md. This Skill eliminates that repetitive work by auto-generating a fully functional, typed FastAPI backend directly from your existing project specs.

Core Features & Use Cases

  • Preflight Validation: Automatically checks for required AGENTS.md and PRD.md files and confirms the project requires a backend before generating any code, avoiding wasted work.
  • Full Project Scaffolding: Creates a complete, production-ready server/ directory with FastAPI app entry point, Pydantic models, typed route stubs, environment configuration, test suites, and optional Supabase integration.
  • PRD-Driven Route Generation: Creates one type-safe route stub per entry listed in your PRD's Backend Routes section, with dummy functional data for immediate frontend integration and testing.
  • Use Case: For a project management app with PRD-defined routes for creating and listing projects, this Skill will generate the full backend structure with Pydantic models for projects, route handlers, and a health check endpoint ready to run out of the box.

Quick Start

Use the scaffold-backend skill to generate a complete FastAPI backend for your project after you have created AGENTS.md and PRD.md with your backend routes and data models defined.

Frequently Asked Questions about scaffold-backend

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I generate a FastAPI backend from a PRD document?

You can generate a FastAPI backend from a PRD by using a scaffolding tool that reads your PRD.md and AGENTS.md files to automatically create typed Pydantic models, route stubs, environment configuration, and test suites without manual boilerplate coding.

What files do I need before scaffolding a FastAPI backend from project specifications?

Before scaffolding a FastAPI backend, you need AGENTS.md and PRD.md files that define your backend requirements, route endpoints, and data models. A preflight validation checks for these files and confirms the project requires a backend before generating any code.

Can I use Supabase database integration when generating FastAPI route stubs?

Yes, you can include optional Supabase database integration when generating FastAPI route stubs. The scaffolding process creates a full project structure with Pydantic models and typed route handlers that support Supabase integration to meet backend database needs.

How does PRD-driven route generation work for Python backend APIs?

PRD-driven route generation works by reading the Backend Routes section in your PRD.md and creating one type-safe FastAPI route stub per entry. Each generated stub includes dummy functional data, allowing immediate frontend integration and testing out of the box.

What is the best way to automate creating typed Pydantic models for a new web project?

The best way to automate creating typed Pydantic models is to use a PRD-driven scaffolding approach that parses your project specifications and generates a complete, production-ready FastAPI server directory with fully typed models and route handlers.

Are there limitations to generating a FastAPI backend from existing project specs?

A limitation of generating a FastAPI backend from project specs is that the process strictly requires predefined AGENTS.md and PRD.md files. Without these documents detailing your backend routes and data models, the preflight validation will fail and no code will be generated.