Code Rules

Universal rules for all languages + index to language-specific guides.

Language Rules

Should USE ‘English’ for all code comments, docstrings, and commit messages. This ensures clarity and consistency across projects and collaborators.

Tier 1: Essential (Universal)

ALWAYS follow these. No exceptions.

• Format before commit: Run the language-specific formatter
• Type hints / annotations: Required on all public functions
• No magic: No hidden side effects, no implicit behavior
• Tests: Write tests for new functionality
• Docstrings: On modules, classes, and public functions

Pre-Commit Documentation Check