# python-guidelines

> Python coding guidelines and best practices

- Author: Claude Agent
- Repository: mguttmann/autonomous-org-framework
- Version: 20260121124308
- Stars: 0
- Forks: 0
- Last Updated: 2026-02-06
- Source: https://github.com/mguttmann/autonomous-org-framework
- Web: https://mule.run/skillshub/@@mguttmann/autonomous-org-framework~python-guidelines:20260121124308

---

---
name: python-guidelines
description: Python coding guidelines and best practices
---

# Python Guidelines

## Style
- Follow PEP 8
- Use Black formatter
- Max line length: 88

## Naming
```python
# Variables/functions: snake_case
user_name = "John"
def get_user(): pass

# Classes: PascalCase
class UserService: pass

# Constants: SCREAMING_SNAKE_CASE
MAX_RETRIES = 3
```

## Best Practices
- Use type hints
- Use dataclasses
- Handle exceptions explicitly
- Use pathlib for paths

## File Structure
```
src/
  models/
  services/
  utils/
tests/
```

## Testing
- Use pytest
- Test files in tests/
- Use fixtures