prompts/docs/skills/async-fastapi-sqlmodel/references/index.md

FastAPI Async SQLAlchemy References Index

Purpose: concept registry for the principles, mechanics, and implementation guidance used by this skill.

---

Concepts

Concept	File	Status	Decision Level	Owner	Last Reviewed
Engine lifecycle and ownership	engine.md	adopted	mandatory	platform/backend	2026-06-17
Session factory and scope	session.md	adopted	mandatory	platform/backend	2026-06-17
Transaction boundaries	transactions.md	adopted	mandatory	platform/backend	2026-06-17
Implicit ORM I/O under asyncio	implicit_io.md	adopted	advisory	platform/backend	2026-06-17
Observability and resilience	observability.md	adopted	mandatory	platform/backend	2026-06-17
SQLModel modeling and async boundaries	sqlmodel.md	adopted	mandatory	platform/backend	2026-07-26
Basic CRUD repository and functions	crud.md	adopted	advisory	platform/backend	2026-07-26
Test database targets and fixture data	testing.md	adopted	mandatory	platform/backend	2026-07-30

---

How to Use This Folder

• SKILL.md defines the explanatory workflow and shared mental model.
• Each concept doc defines policy-level guidance for one concern.
• Use the template in template.md for new concept docs.
• Keep references source-linked and implementation snippets minimal.

---

Update Rules

• If a PR changes database lifecycle/session/ORM loading behavior, update the relevant concept file.
• Keep Status, Decision Level, and Last Reviewed current.
• Use advisory for recommendations that depend on application context; use mandatory for required runtime policy.