Cline rules

1# Dependency Management
2 
3## Package Manager
4ONLY USE UV for dependency management. DO NOT USE pip or conda.
5 
6## Standard Package Requirements
7 
8### Core Data & Validation
9- `pydantic` - ALL data validation, serialization, JSON encoding/decoding, data models
10- `pydantic_settings` - Configuration and environment management
11- `pydantic_ai` - AI-related data models and validation
12 
13### Testing
14- `pytest` - Test framework
15- `pytest-mock` - Mocking support
16 
17### Standard Library Usage
18- `asyncio` - Asynchronous programming
19- `logging` - Application logging
20- `datetime.datetime` - Date/time operations
21- `typing` - Type hints and annotations
22- `pathlib` - Filesystem paths
23- `contextlib` - Context managers
24- `collections` - Specialized containers
25- `functools` - Higher-order functions
26- `itertools` - Iterator building blocks
27 
28### Additional Tools
29- `sphinx` - Documentation generation
30- `uv` - Dependency management (ONLY)
31- `click` - CLI development
32- `sqlalchemy` - Database interactions
33 
34## UV Workflow
35 
36Use Makefile targets for common tasks:
37- `make install` - Install dependencies
38- `make update` - Update dependencies
39- `make docs` - Build Sphinx documentation
40- `make precommit` - Install pre-commit hooks
41- `make clean` - Remove build artifacts
42- `make lock` - Create the uv.lock file
43 
44If no Makefile exists, create one with these commands following the existing structure and conventions.
45