Cline rules

1# Python Coding Standards
2 
3## PEP 8 Compliance
4- Follow PEP 8 guidelines strictly
5- Max line length: 100 characters
6- Proper indentation and spacing
7 
8## Naming Conventions
9- `snake_case` for functions and variables
10- `PascalCase` for classes
11- `UPPER_SNAKE_CASE` for constants
12 
13## Imports
14Group in order, separated by blank lines:
151. Standard library
162. Third-party packages
173. Local application imports
18 
19## Type Hints
20Use type hints for all function signatures to improve readability and enable static analysis.
21 
22## String Formatting
23- Use f-strings when no user input is involved
24- Use `.format()` method when user input is present (security)
25 
26## Data Structures
27- Use Pydantic models for external data boundaries (API, database, user input)
28- Use standard dataclasses for internal structures
29- Prefer `frozen=True` for immutability
30 
31## Error Handling
32- Implement structured logging throughout
33- Never log sensitive information
34- Use appropriate exception types
35 
36## Code Organization
37- Avoid deep nesting (max 3-4 levels)
38- Keep functions focused and single-purpose
39- Extract complex logic into helper functions
40