- ALL code comments MUST be in English
- ALL documentation files MUST be in English
- ALL commit messages MUST be in English
- ALL variable/function names MUST be in English
- ALL README files MUST be in English
- Russian is ONLY allowed in Claude Code chat for discussion
- Any text that will be committed to the repository MUST be in English
- Follow PEP 8
- Use descriptive variable names
- Add docstrings to all functions
- Keep functions small and focused
- Write comments in English only
- Explain WHY, not WHAT
- Keep comments up-to-date with code changes
- Use conventional commits format
- Start with emoji for visual clarity
- Keep first line under 72 characters
- Add detailed description if needed
Examples:
β¨ Add new feature for tactical analysis
π Fix game fetching timeout issue
π Update documentation for Lichess integration
β»οΈ Refactor analysis pipeline for better performance
- Create a feature branch
- Make changes following these guidelines
- Test locally
- Commit with English message
- Push and create PR with English description
Remember: This is an international open-source project. English ensures maximum accessibility and collaboration.
These guidelines ensure consistency and international collaboration