Python

Core Posture

Use uv as the default workflow for Python projects, standalone scripts, dependency management, quality checks, and package release. Prefer the repository's existing configuration and documented commands over introducing new tooling.

Mode Selection

• Choose project mode when the work has a pyproject.toml, shared package code, or lockfile.
• Treat a brand-new repository created with uv init as project mode.
• Choose standalone-script mode when the work is a single file, stdin snippet, or ad hoc invocation that should not become a full project.
• Treat a script inside a project as project mode when it imports local package code.
• Use --no-project only when a script must ignore the surrounding project.

Project Workflow