name	uv-rules
description	MUST READ before running any pip, uv, venv, or package-related commands. Contains strict rules for uv usage — violating them can break the project.
metadata	{"author":"namingpaper","version":"1.0"}

uv Rules

Add dependency: uv add &lt;package&gt; (or uv add --dev &lt;package&gt; )
Remove dependency: uv remove &lt;package&gt;
Run commands: uv run &lt;command&gt;
Install dependencies: uv sync --all-extras --dev
CI lockfile check: uv sync --locked

This project uses uv as its Python package and project manager. Follow these rules strictly.

Never edit pyproject.toml dependencies by hand — always use uv add/uv remove so the lockfile stays in sync.
Never use pip install, python -m pip, or uv pip. Mixing uv pip with uv sync corrupts the editable install and breaks the venv.
uv.lock is auto-managed. Do not manually edit it.
If the venv breaks: rm -rf .venv && uv sync --all-extras --dev to recreate from scratch.

name	uv-rules
description	MUST READ before running any pip, uv, venv, or package-related commands. Contains strict rules for uv usage — violating them can break the project.
metadata	{"author":"namingpaper","version":"1.0"}

This project uses uv as its Python package and project manager. Follow these rules strictly.

Never edit pyproject.toml dependencies by hand — always use uv add/uv remove so the lockfile stays in sync.
Never use pip install, python -m pip, or uv pip. Mixing uv pip with uv sync corrupts the editable install and breaks the venv.
uv.lock is auto-managed. Do not manually edit it.
If the venv breaks: rm -rf .venv && uv sync --all-extras --dev to recreate from scratch.

uv-rules