scaffold-backend

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.