Clean Code Guide

Clean Code Guide

General Principles

• Write clean, readable code
• Use meaningful variable names instead of single letters
• Keep functions small and focused on one thing
• Don't repeat yourself (DRY)
• Handle errors properly with try/except
• Add comments to explain complex logic
• Follow PEP 8 style guidelines
• Use type hints for function parameters and return values

Testing

• Write tests for your code
• Use pytest as the test framework
• Aim for 80% code coverage
• Test edge cases like empty inputs, None values, and large datasets
• Mock external services in unit tests

Code Review Checklist

• Are variable names descriptive?
• Are functions under 50 lines?
• Is there code duplication?
• Are errors handled correctly?
• Are there security issues?
• Is the code well-documented?

Git Workflow

• Write descriptive commit messages
• Use feature branches
• Don't commit secrets or .env files
• Run tests before pushing

Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

• Author: Benkapner
• Source: Benkapner/claude-code-basecamp
• License: MIT

Install and usage instructions live in the source repository linked above.