python-project-conventions

# Skill: Python project conventions ## Goal Provide a consistent Python dev experience (install/lint/test/format/coverage) via Make targets. ## Expected repo files - `pyproject.toml` (preferred) or `requirements*.txt` - Package code under `src/` (preferred) or top-level package dir - Tests under `tests/` ## Make targets (recommended) - `make install` → `python -m pip install -e .` - `make install-dev` → install dev extras + ruff/pytest - `make lint` → `ruff check ...` - `make format` → `ruff format ...` - `make test` → `python -m pytest` - `make coverage` → `python -m pytest --cov=... --cov-report=term-missing` - `make check` → `make lint && make coverage` ## Quality Bars - End product should be installable from the final repo URL via `uv tool` or `pip`