diff --git a/CLAUDE.md b/CLAUDE.md
index ab66f22..2a2d908 100644
--- a/CLAUDE.md
+++ b/CLAUDE.md
@@ -236,6 +236,6 @@ The project uses strict mypy configuration with `disallow_untyped_defs=true`. Ru
 - Do not include unrelated files
 - Use descriptive commit messages
 - Group related files together (e.g., tests with the code they test)
-- **Always run tests before committing**: `docker compose exec -T app pytest tests/ -v --tb=short`. If Docker is not running or not available, warn the user that tests could not be verified before committing.
+- **Always run tests before committing**: `docker compose exec -T app pytest tests/ -v --tb=short`. If Docker is not available, use the local venv fallback: `/tmp/rec-test-venv/bin/pytest tests/ -v --tb=short` (set up with `python3 -m venv /tmp/rec-test-venv && /tmp/rec-test-venv/bin/pip install pytest pytest-asyncio pytest-cov httpx fakeredis aioresponses fastapi uvicorn sqlmodel sqlalchemy alembic pyjwt cryptography celery redis click aiohttp aiohttp-socks pillow numpy pytesseract opentelemetry-api opentelemetry-sdk opentelemetry-exporter-prometheus opentelemetry-instrumentation-fastapi opentelemetry-instrumentation-sqlalchemy python-dotenv webauthn apprise tenacity prometheus-client email-validator opencv-python-headless tqdm pandas cachetools watchdog`). If neither works, warn the user.
 - **After each meaningful change, ask the user if they want to commit and push the changes**