Backend Engineering

Default Stack (Ask First)

Before applying anything, ask:

"Can I use the Supernova backend stack? Python 3.12 + FastAPI + SQLAlchemy 2.0 async + PostgreSQL. Or do you have an existing backend stack I should match?"

If an existing requirements.txt, pyproject.toml, or setup.py is detected, read it and match the existing stack.

Progressive Disclosure

• Load references/fastapi-patterns.md when setting up dependency injection, middleware, or lifespan events.
• Load references/sqlalchemy-async.md when implementing async DB sessions or complex ORM queries.

SOP: Backend Implementation

Step 1 - Project Scaffold (New Projects Only)

For greenfield projects, structure the project as follows. Do not deviate: