Uv Ruff Only Tooling Migration

When To Use

• Repo has uv.lock (or wants UV).
• User wants no Poetry and/or no Black.

Steps

• Remove Poetry artifacts
  • Delete poetry.lock.
  • Remove Poetry commands/docs references.
• Make pyproject.toml UV-native
  • Ensure PEP 621 [project] is source of truth.
  • Prefer [dependency-groups] for dev/docs tool deps.
  • Add missing runtime deps surfaced by imports/tests.
  • Run uv lock to regenerate uv.lock.
• Pre-commit
  • Remove Black hook.
  • Add ruff-format and ruff hooks.
  • Ensure hooks run via the repo’s standard workflow.
• CI
  • Replace Black check with uv run ruff format --check.
  • Lint with uv run ruff check.
  • Use uv sync --dev and uv pip install -e ..
  • If needed, temporarily run a stable smoke suite while fixing failing tests.
• Docs/agent guidance
  • Update AGENTS.md, README.md, and contrib/dev docs to reference UV + Ruff only.

Verify

• uv sync --dev
• uv pip install -e .
• uv run ruff format --check src tests
• uv run ruff check src tests
• uv run pytest (or smoke suite if full is broken)

Manual notes

This section is preserved when the skill is updated. Put human notes, caveats, and exceptions here.

Converted and distributed by TomeVault — claim your Tome and manage your conversions.