Python Virtual Environment Management

Core Principle

ALWAYS use the project's .venv when running Python commands in the terminal. NEVER run Python commands without first activating or using the virtual environment.

Critical Rules

1. Check for .venv first - Always verify .venv exists before running Python commands
2. Use activation commands - Activate .venv in every terminal session
3. Shell-aware - Detect shell type (Bash, Zsh, PowerShell) and use appropriate commands
4. No global Python - Never use system Python when .venv exists
5. Fail fast - If .venv doesn't exist, create it or fail clearly
6. macOS default - Prefer Bash/Zsh patterns on macOS

Shell Detection & Commands

macOS Terminal (Zsh - Default)