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.

Layers

Installs
59
GitHub Stars
4
First Seen
Jun 24, 2026