python
Installation
SKILL.md
Python Coding Standards
Opinionated conventions for modern Python (3.12+) emphasizing type safety, clear function signatures, consistent module organization, and a layered architecture.
App Architecture
Screaming Architecture
Name modules after the domain — billing/, authentication/, annual_reports/ — so the
directory listing says what the app does rather than which framework it uses. Directories carry
the domain; the layers below live in files inside them (billing/services.py, billing/api.py).
A top-level models/ or views/ directory inverts that and scatters one domain across the tree.
Keep the modules flat — auth/, users/, and billing/ as siblings, not users/auth/ and
users/billing/. Nesting buries domains a level down, so the top-level listing stops telling
you at a glance what the app is about.