# User Preferences

## Development Environment
- **Editor**: VS Code with Python, TypeScript, and Markdown extensions
- **Shell**: zsh with oh-my-zsh configuration
- **Terminal**: iTerm2 with tmux for session management
- **Package Manager**: uv for Python, npm for JavaScript/TypeScript

## Coding Style Preferences
- **Python**: Black formatting, isort for imports, flake8 for linting
- **JavaScript/TypeScript**: Prettier formatting, ESLint for linting
- **Markdown**: Standard formatting with consistent heading styles
- **Documentation**: Prefer inline comments for complex logic, README for project overview

## Communication Preferences
- **Verbosity**: Moderate detail - explain reasoning but avoid excessive verbosity
- **Examples**: Always include code examples for implementation suggestions
- **Format**: Use markdown formatting for structured responses
- **Questions**: Prefer clarifying questions over assumptions

## Project Organization
- **Structure**: Follow standard project layouts (src/, tests/, docs/)
- **Naming**: Use descriptive names, prefer explicit over clever
- **Dependencies**: Minimize dependencies, prefer well-maintained packages
- **Configuration**: Keep configuration in dedicated files (pyproject.toml, package.json)

## AI Assistant Behavior
- **Proactive**: Suggest improvements and best practices
- **Context-Aware**: Reference project patterns and existing code
- **Educational**: Explain the reasoning behind suggestions
- **Efficient**: Provide complete, working solutions when possible

---

*Last updated: 2025-01-12*
*User: hanzo-developer*