Contributing to Claude Code Agent System

Contributing to Claude Code Agent System

Thank you for your interest in contributing to the Claude Code Agent System! 🎉

This project aims to make React Native/Expo development faster and more reliable through AI-powered agents. Your contributions help the entire mobile development community.

---

📋 Table of Contents

• Code of Conduct
• How Can I Contribute?
• Development Setup
• Pull Request Process
• Coding Standards
• Testing Guidelines
• Documentation

---

📜 Code of Conduct

This project follows a simple rule: **Be kind, be helpful, be respectful.**

• Be constructive in feedback and discussions
• Be patient with new contributors
• Be respectful of different perspectives and experience levels
• Be collaborative - we're all here to improve mobile development

---

🤝 How Can I Contribute?

Reporting Bugs

Found a bug? Please create a GitHub Issue with:

1. Clear title - What's broken?
2. Steps to reproduce - How did you encounter it?
3. Expected behavior - What should happen?
4. Actual behavior - What actually happened?
5. System info:
   • Windows version
   • Claude Code version (claude --version)
   • PowerShell version
   • Expo/React Native version (if applicable)

**Example:**

Title: "installer-agents.ps1 fails when package.json contains comments"

Steps:
1. Add // comment to package.json
2. Run .\install-agents.ps1 -Scope project
3. Error appears

Expected: Installer should handle JSON with comments
Actual: "Invalid JSON" error

System: Windows 11, Claude Code 2.0.5, PowerShell 7.4

---

Suggesting Enhancements

Have an idea? Create a GitHub Issue with:

1. Clear description of the enhancement
2. Use case - What problem does it solve?
3. Examples - How would it work?
4. Alternatives - Have you considered other approaches?

---

Creating New Agents

Want to add a new agent to the 20-agent system design?

**Requirements:**

1. Follows existing pattern - Use AGENTS-REFERENCE.md as template
2. Solves real problem - Based on actual React Native pain points
3. Well-documented - Clear description, examples, use cases
4. Tested - Works on real Expo/React Native projects

**Agent File Structure:**

---
name: my-agent
description: Specific description of when to invoke (be precise for auto-invocation)
tools: Read, Grep, Edit  # Only tools actually needed
model: sonnet  # haiku/sonnet/opus based on complexity
---

# My Agent

You are an expert in [domain].

## Your Mission
[What this agent does and when to use it]

## What You Check
- Specific check 1
- Specific check 2

## Output Format
[How findings are reported]

## Examples
[Usage examples]

---

Improving Documentation

Documentation improvements are always welcome!

• Fix typos or unclear wording
• Add examples and u