Cline rules

1# Tech Stack Rules (Python)
2 
3## Python Package Management
4 
5When adding or updating Python packages:
61. ALWAYS research online to verify you're using the LATEST stable versions from PyPI
72. Check PyPI.org for each package to confirm the latest version
83. Use `uv add <package>` to add packages (uv automatically gets the latest version)
94. After adding packages, verify in pyproject.toml that versions are current
105. Example workflow:
11   - Check https://pypi.org/project/<package-name>/ for latest version
12   - Run `uv add <package>` to install latest
13   - Verify version in pyproject.toml matches PyPI
14 
15This ensures dependencies are up-to-date and secure.
16 
17## Python-Specific Standards
18 
19### Modern Python Features
20- **Modern Python**: Use latest Python features (3.10+: match/case, type unions with |, etc.)
21- **Type Safety**: Full type hints throughout the codebase
22- **Dataclasses**: Use dataclasses for configuration and data structures
23 
24### Environment Variables
25- **Environment Variables**: Always load from .env file using `python-dotenv` at entry points (CLI, main scripts)
26 
27### Python Logging
28- Use Python's `logging` module
29- Log at appropriate levels (DEBUG, INFO, WARNING, ERROR)
30- Include context in log messages
31 
32### Package Updates
331. Always check PyPI for latest stable versions
342. Use `uv add package` for automatic latest version
353. Test after updates to ensure compatibility
364. Update version in pyproject.toml if making a release
37