# CLI Brain - OpenCode Agency Agents

A comprehensive collection of 150+ specialized agents for building software, tools, apps, and websites.

## Quick Start

```bash
# Route a task (automatic agent selection)
opencode "build a landing page"

# Use a specific agent
opencode @frontend-developer "create a button component"

# Run a workflow
opencode run saas-mvp --name "MyApp"

# Find the right agent
opencode find "react performance"
```

## Agent Directory

### Core Orchestration
| Agent | Description | Triggers |
|-------|-------------|----------|
| `@orchestrator` | Routes tasks, asks clarifications, learns preferences | Any prompt |
| `@api-architect` | REST/GraphQL/gRPC API design | api, endpoint, rest |
| `@fullstack-developer` | Next.js/Nuxt/SvelteKit apps | fullstack, app, nextjs |
| `@design-system-consultant` | UI/UX, colors, typography, shadcn | design, color, style |

### Engineering (58 agents)
| Agent | Description |
|-------|-------------|
| `@frontend-developer` | React, Vue, Angular, Svelte |
| `@backend-architect` | Databases, APIs, microservices |
| `@devops-automator` | CI/CD, Docker, Kubernetes |
| `@security-engineer` | Auth, encryption, pentesting |
| `@code-reviewer` | Code review, refactoring |
| `@database-optimizer` | Query optimization, indexing |
| `@ai-engineer` | ML/AI integration |
| `@sre` | Site reliability, monitoring |
| `@git-workflow-master` | Git strategies |
| `@rapid-prototyper` | Fast MVPs |
| `@technical-writer` | Documentation |
| `@cms-developer` | Headless CMS |
| `@mobile-app-builder` | iOS/Android/React Native |
| `@solidity-smart-contract-engineer` | Blockchain |
| `@data-engineer` | ETL, pipelines |
| ...and 43 more | See agents/engineering/ |

### Design (8+ agents)
| Agent | Description |
|-------|-------------|
| `@design-system-consultant` | Design systems, tokens |
| `@design-visual-storyteller` | Visual narratives |
| `@design-whimsy-injector` | Micro-interactions |

### Testing (8 agents)
| Agent | Description |
|-------|-------------|
| `@testing-reality-checker` | Reality checks |
| `@testing-api-tester` | API testing |
| `@testing-performance-benchmarker` | Load testing |
| `@testing-accessibility-auditor` | WCAG compliance |

### Product (5 agents)
| Agent | Description |
|-------|-------------|
| `@product-manager` | Requirements, roadmaps |
| `@product-trend-researcher` | Market research |
| `@product-sprint-prioritizer` | Sprint planning |

### Project Management (6 agents)
| Agent | Description |
|-------|-------------|
| `@project-manager-senior` | Senior PM |
| `@project-management-jira-workflow-steward` | Jira workflows |

### Marketing (30 agents)
| Agent | Description |
|-------|-------------|
| `@marketing-seo-specialist` | SEO optimization |
| `@marketing-content-strategist` | Content strategy |
| `@marketing-social-media-manager` | Social media |

### Paid Media (7 agents)
| Agent | Description |
|-------|-------------|
| `@paid-media-ppc-strategist` | PPC campaigns |
| `@paid-media-paid-social-strategist` | Paid social |

### Finance (5 agents)
| Agent | Description |
|-------|-------------|
| `@finance-tax-strategist` | Tax strategy |
| `@finance-investment-researcher` | Investment research |

### Sales (8 agents)
| Agent | Description |
|-------|-------------|
| `@sales-crm-specialist` | CRM management |
| `@sales-lead-generation-specialist` | Lead gen |

### Support (6 agents)
| Agent | Description |
|-------|-------------|
| `@support-support-responder` | Support tickets |
| `@support-infrastructure-maintainer` | Infrastructure |

### Academic (5 agents)
| Agent | Description |
|-------|-------------|
| `@academic-research-assistant` | Research |
| `@academic-paper-writer` | Academic writing |

### Specialized (41 agents)
| Agent | Description |
|-------|-------------|
| `@specialized-legal-compliance-expert` | Legal compliance |
| `@specialized-hr-onboarding-specialist` | HR onboarding |
| `@specialized-data-privacy-officer` | Data privacy |

### Spatial Computing (6 agents)
| Agent | Description |
|-------|-------------|
| `@spatial-computing-ar-developer` | AR development |
| `@spatial-computing-vr-developer` | VR development |

### Game Development (30+ agents)
| Agent | Description |
|-------|-------------|
| `@game-development-unity-developer` | Unity |
| `@game-development-unreal-engine-developer` | Unreal Engine |
| `@game-development-godot-developer` | Godot |
| `@game-development-roblox-studio-developer` | Roblox |
| `@game-development-blender-3d-artist` | 3D modeling |

### Strategy (3+ agents)
| Agent | Description |
|-------|-------------|
| `@strategy-nexus-strategist` | Strategic planning |

### Agency Swarm (6 agents)
| Agent | Description |
|-------|-------------|
| `@as-agent-creator` | Create agents |
| `@as-api-researcher` | Research APIs |
| `@as-instructions-writer` | Write instructions |
| `@as-prd-creator` | Create PRDs |
| `@as-qa-tester` | QA testing |
| `@as-tools-creator` | Create tools |

## Workflows

| Workflow | Agents Chain | Use Case |
|----------|--------------|----------|
| `landing-page` | Design → Frontend | Marketing pages |
| `saas-mvp` | Product → API → Backend → Frontend → Testing | Complete SaaS |
| `api-service` | API → Backend → Testing | API development |
| `fullstack-app` | FullStack → Design → FullStack → Testing | Full-stack apps |
| `auth-system` | Security → FullStack → Security | Authentication |

## UI/UX Pro Max Integration

The `@design-system-consultant` agent integrates with UI/UX Pro Max data:

- **161 color palettes** - Searchable by product type
- **57 font pairings** - With Google Fonts imports
- **50+ UI styles** - Glassmorphism, minimalism, brutalism, etc.
- **99 UX guidelines** - Accessibility, performance, interaction
- **25 chart types** - Data visualization patterns

```bash
# Use design system features
opencode @design-system-consultant "suggest color palette for fintech app"
opencode @design-system-consultant "glassmorphism card component"
```

## Configuration

User preferences stored in `~/.opencode-agency/`:
- `preferences.json` - Routing history, preferred agents
- Survives CLI updates

## Adding Custom Agents

1. Create `.md` file in `agents/<department>/`
2. Include frontmatter with name, description, color (hex)
3. Add keywords to `router/keywords.json`

## Environment Variables

```bash
OPENCODE_AGENCY_DIR    # Custom config directory
OPENCODE_CONFIDENCE    # Default threshold (70)
```

## Total Agents: 150+

- Engineering: 58
- Marketing: 30
- Specialized: 41
- Game Dev: 30
- Design: 8+
- Testing: 8
- Product: 5
- Project Management: 6
- Sales: 8
- Support: 6
- Finance: 5
- Academic: 5
- Paid Media: 7
- Spatial Computing: 6
- Strategy: 3
- Agency Swarm: 6
- Core: 4
