Contributing To Claude Builder — Development skill for Claude Code

Contributing to Claude Builder

Welcome to Claude Builder! We're excited to have you contribute to making this the best universal Claude Code environment generator.

📋 Table of Contents

• Code of Conduct
• Getting Started
• Development Setup
• Contributing Guidelines
• Pull Request Process
• Issue Guidelines
• Code Standards
• Testing
• Documentation

Code of Conduct

This project adheres to a code of conduct. By participating, you are expected to uphold this code. Please report unacceptable behavior to the project maintainers.

Our Standards

• Be respectful - Treat everyone with respect and kindness
• Be inclusive - Welcome newcomers and help them learn
• Be constructive - Provide helpful feedback and suggestions
• Be collaborative - Work together towards common goals

Getting Started

Prerequisites

• Python 3.8+ installed
• Git installed and configured
• Basic understanding of Python development
• Familiarity with Claude Code ecosystem (helpful but not required)

Development Setup

1. **Fork and Clone**

   git clone https://github.com/YOUR_USERNAME/claude_builder.git
   cd claude_builder

2. **Create Virtual Environment**

   python -m venv venv
   source venv/bin/activate  # On Windows: venv\Scripts\activate

3. **Install Development Dependencies**

   pip install -e ".[dev,test]"

4. **Install Pre-commit Hooks**

   pre-commit install

5. **Verify Setup**

   pytest
   claude-builder --help

Contributing Guidelines

Types of Contributions

We welcome various types of contributions:

• 🐛 Bug fixes - Fix issues and improve reliability
• ✨ New features - Add new functionality or templates
• 📚 Documentation - Improve docs, examples, and guides
• 🧪 Tests - Add test coverage or improve existing tests
• 🏗️ Templates - Create new project templates
• 🤖 Agents - Add or improve agent configurations
• 🎨 Performance - Optimize speed and efficiency

Before You Start

1. Check existing issues - See if your idea is already being discussed
2. Create an issue - For new features or major changes, create an issue first
3. Get feedback - Discuss your approach with maintainers
4. Start small - Begin with smaller contributions to understand the codebase

Pull Request Process

1. Create a Feature Branch

git checkout -b feature/your-feature-name
# or
git checkout -b fix/issue-description

2. Make Your Changes

• Write clean, well-documented code
• Follow the existing code style and patterns
• Add tests for new functionality
• Update documentation as needed

3. Test Your Changes

# Run all tests
pytest

# Run tests with coverage
pytest --cov=claude_builder --c