Contributing

# Fork on GitHub, then clone
git clone https://github.com/YOUR-USERNAME/raptor.git
cd raptor

# Open in VS Code
code .
# Use: Dev Container: Open Folder in Container

# Install dependencies
pip install -r requirements-dev.txt
pip install semgrep

# Set up environment
export PYTHONPATH="$(pwd):$(pwd)/packages:$PYTHONPATH"

git checkout -b feature/your-feature-name

# Make your changes

# Run tests
bash test/comprehensive_test.sh

# Test your changes
python3 raptor.py scan --repo test/data

git add .
git commit -m "Add: your feature description"
git push origin feature/your-feature-name

# Open PR on GitHub

mkdir packages/your_package
touch packages/your_package/__init__.py

# packages/your_package/api.py
def your_main_function(target: str) -> dict:
    """
    Main entry point for your package.
    """
    # Implementation
    return results

mkdir packages/your_package/tests
touch packages/your_package/tests/test_your_package.py

# packages/your_package/tests/test_your_package.py
def test_your_function():
    result = your_main_function("test_input")
    assert result is not None

# raptor.py
elif mode == "your-mode":
    from packages.your_package.api import your_main_function
    results = your_main_function(args.target)

# Update docs/EXTENDING_LAUNCHER.md
# Add usage examples
# Document API

# .claude/commands/your-command.md
# /your-command - Brief description

Detailed description of what the command does.

**Usage:**

**Examples:**

# CLAUDE.md
## COMMANDS

/your-command - Brief description

# tiers/personas/your_expert.md
# Your Expert Name - Domain Expertise

**Background:** [Expert background]

**Expertise:**
- Skill 1
- Skill 2

**Approach:**
[How the expert analyzes problems]

**When to invoke:** [Use cases]

# tiers/personas/README.md
| Persona | Expert | Purpose |
| Your Expert | Your Name | Your domain |

git add .
git commit -m "Update: address review feedback"
git push