diff --git a/.claude/skills/port-quest-game/SKILL.md b/.claude/skills/port-quest-game/SKILL.md
index 9980424..dcbdfc9 100644
--- a/.claude/skills/port-quest-game/SKILL.md
+++ b/.claude/skills/port-quest-game/SKILL.md
@@ -6,7 +6,7 @@ description: Port a Meta Quest standalone game (APK + OBB dump) to the Valve Ste
 # Port a Quest game to the Steam Frame
 
 Work from the repo root (`frameport/`). Read `CLAUDE.md` (facts) and `docs/PLAYBOOK.md` (symptom → fix) first.
-Set `UV_PROJECT_ENVIRONMENT=~/.cache/frameport-venv` (the repo is on NTFS).
+The dev environment is `.venv` in the repo root (`UV_LINK_MODE=copy uv sync --extra dev` if it's missing).
 
 ## 1. Setup (once)
 ```
diff --git a/CLAUDE.md b/CLAUDE.md
index 5c48f75..8f82380 100644
--- a/CLAUDE.md
+++ b/CLAUDE.md
@@ -32,8 +32,8 @@ Read `docs/PLAYBOOK.md` (symptom → fix) before debugging a game, and `docs/FRA
 
 ## Dev commands
 ```
-export UV_PROJECT_ENVIRONMENT=~/.cache/frameport-venv   # keep the venv off NTFS (repo lives on D:)
-uv sync --extra dev          # or: uv pip install -e .[dev]
+# the dev venv is .venv in the repo root (git-ignored); on the NTFS drive uv needs UV_LINK_MODE=copy
+UV_LINK_MODE=copy uv sync --extra dev   # creates/updates ./.venv
 uv run pytest                # unit tests (no device, no game files)
 uv run frameport --help      # CLI;  uv run frameport-gui  for the GUI
 uv run frameport parity --known-good <PATCHED/_known-good-*> --sources "<VR CyberDeck downloads>"