developer-toolbox

# Developer Toolbox

A collection of essential development workflow agents that integrate seamlessly with Claude Code.

## What's Included

### Agents (7)

| Agent | Purpose | Triggers On |
|-------|---------|-------------|
| **commit-helper** | Generate conventional commit messages | "commit message", "staged changes" |
| **build-verifier** | Verify dist/ matches source after builds | "changes not appearing", "verify build" |
| **code-reviewer** | Security audits and code quality reviews | "code review", "security audit", "OWASP" |
| **debugger** | Systematic debugging with root cause analysis | "error", "TypeError", "stack trace", "bug" |
| **test-runner** | TDD workflow and test creation | "write tests", "TDD", "coverage", "jest" |
| **orchestrator** | Coordinate complex multi-step projects | "coordinate", "multi-step", "complex feature" |
| **documentation-expert** | README, API docs, architecture diagrams | "document", "README", "API docs" |

### Rules (1)

| Rule | Purpose |
|------|---------|
| **agent-first-thinking** | Behavioral interrupt - consider agents before manual work |

## Installation

```bash
# Via marketplace
/plugin install developer-toolbox

# Or local development
/plugin install ./skills/developer-toolbox
```

After installation, restart Claude Code to load the agents.

## Usage Examples

### Commit Helper
```
"Help me write a commit message for these staged changes"
```

### Build Verifier
```
"My changes aren't appearing in production, verify the build output"
```

### Code Reviewer
```
"Review this authentication code for security vulnerabilities"
```

### Debugger
```
"I'm getting TypeError: Cannot read property 'map' of undefined"
```

### Test Runner
```
"Use TDD to implement this user validation function"
```

### Orchestrator
```
"Coordinate a refactor of the authentication system across 5 services"
```

### Documentation Expert
```
"Create comprehensive API documentation for this REST endpoint"
```

## Agent Design Philosophy

All ag