bloqaudio

Contributing to Claude Builder

Development community intermediate

SOURCE https://github.com/bloqaudio/claude_builder

Description

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

Installation

This entry records only its repository, not the path inside it, so there is no exact command to give. Open the source below and copy the folder into ~/.claude/skills/, or the file into ~/.claude/agents/.

Repository README

This is the README for bloqaudio/claude_builder, shared by 2 entries in this directory. It describes the repository, not this entry specifically.

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

**Fork and Clone**

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

**Create Virtual Environment**

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

**Install Development Dependencies**
```
pip install -e ".[dev,test]"
```
**Install Pre-commit Hooks**
```
pre-commit install
```
**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

Check existing issues - See if your idea is already being discussed
Create an issue - For new features or major changes, create an issue first
Get feedback - Discuss your approach with maintainers
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