New Python Project

Turn a directory into a working uv project: dependencies locked, tests running, lint and format clean, types checked, and all of it wired into a pre-commit hook so it stays that way.

The job is not done when the files exist. It is done when Step 5 goes green.

Before you scaffold

Ask the user the things you genuinely cannot infer, in one batch (in Claude Code, one AskUserQuestion call with multiple questions):

1. Location - which directory, or a new subdirectory of the cwd.
2. Package or application - packages are imported or installed as a command; applications are just run. This one is load-bearing, see Gotchas.
3. Tooling depth - full (ruff + pytest + ty + pre-commit), or lighter.