# 🤖 CLI Brain - OpenCode Agency System

**181 specialized agents** for building software, tools, apps, and websites.

## 📦 What's Included

- ✅ **181 Agents** across 16 departments
- ✅ **UI/UX Pro Max** integration (161 color palettes, 57 fonts, 50+ styles)
- ✅ **Smart Orchestrator** with confidence-based routing
- ✅ **Workflow Engine** for multi-agent chains
- ✅ **Persistent Learning** (survives CLI updates)
- ✅ **OpenCode Compatible** (`.opencode/agents/` format)

## 🚀 Quick Start

### 1. Copy to Your Project

```bash
# Copy to any project
cp -r /path/to/cli-brain/agents ./.opencode/
```

### 2. Use Agents

```bash
# Automatic routing (orchestrator picks best agent)
opencode "build a landing page"
opencode "create a REST API"

# Direct agent invocation
opencode @frontend-developer "create React button"
opencode @api-architect "design auth endpoints"

# Run workflows
opencode run saas-mvp
opencode run landing-page --style glassmorphism

# Find agents
opencode find "react"
opencode list agents
```

## 📊 Agent Breakdown (181 Total)

| Department | Count | Key Agents |
|------------|-------|------------|
| **Engineering** | 31 | frontend, backend, fullstack, api-architect, security, devops |
| **Marketing** | 30 | seo, content, social media, email |
| **Specialized** | 41 | legal, hr, compliance, data privacy |
| **Design** | 9 | design-system, visual-storyteller, whimsy-injector |
| **Testing** | 8 | reality-checker, api-tester, accessibility-auditor |
| **Game Dev** | 5 | Unity, Unreal, Godot, Roblox |
| **Sales** | 8 | crm, lead-gen, sales strategist |
| **Project Mgmt** | 6 | jira, scrum, agile |
| **Product** | 5 | product-manager, trend-researcher |
| **Paid Media** | 7 | ppc, paid-social, programmatic |
| **Spatial Computing** | 6 | AR, VR, 3D |
| **Agency Swarm** | 6 | agent-creator, api-researcher, qa-tester |
| **Support** | 6 | support, infrastructure, finance |
| **Finance** | 5 | tax, investment, fpa |
| **Academic** | 5 | research, paper-writing |
| **Strategy** | 3 | nexus-strategist |

## 🧠 Core Agents

### `@orchestrator` - The CLI Brain
Routes any prompt to the best agent:
- **≥90% confidence**: Route immediately
- **70-89%**: Quick confirmation
- **50-69%**: Ask 1 question
- **<50%**: Full clarification

### `@design-system-consultant` - UI/UX Intelligence
Integrated with UI/UX Pro Max:
- 161 color palettes
- 57 font pairings
- 50+ UI styles (glassmorphism, minimalism, etc.)
- 99 UX guidelines
- shadcn/ui compatible

### `@api-architect` - API Design
- REST/GraphQL/gRPC
- OpenAPI/Swagger
- Rate limiting, auth
- Versioning strategies

### `@fullstack-developer` - Full-Stack Apps
- Next.js, Nuxt, SvelteKit
- Authentication flows
- Database integration
- Deployment

## 🔄 Predefined Workflows

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

## 💾 Persistence

User data stored in `~/.opencode-agency/`:
- ✅ Survives CLI updates
- ✅ Learns your preferences
- ✅ Remembers routing choices
- ✅ Tracks tech stack history

## 📁 Directory Structure

```
cli-brain/
├── agents/
│   ├── orchestrator.md              # 🧠 Main router
│   ├── engineering/                 # 31 agents
│   ├── design/                      # 9 agents
│   ├── product/                     # 5 agents
│   ├── testing/                     # 8 agents
│   ├── marketing/                   # 30 agents
│   ├── sales/                       # 8 agents
│   ├── support/                     # 6 agents
│   ├── finance/                     # 5 agents
│   ├── academic/                    # 5 agents
│   ├── paid-media/                  # 7 agents
│   ├── project-management/          # 6 agents
│   ├── game-development/            # 5 agents
│   ├── spatial-computing/           # 6 agents
│   ├── specialized/                 # 41 agents
│   ├── strategy/                    # 3 agents
│   └── agency-swarm/                # 6 agents
├── router/
│   ├── intent-router.ts             # 🧠 Routing logic
│   └── keywords.json                # 🎯 150+ keyword mappings
├── workflows/
│   └── workflow-engine.ts           # ⚙️ Multi-agent orchestration
├── data/                            # UI/UX Pro Max data
│   ├── colors.csv
│   ├── fonts.csv
│   └── ...
├── AGENTS.md                        # 📚 Full catalog
└── README.md                        # 📖 This file
```

## 🔧 Customization

### Add Your Own Agent

1. Create `agents/<department>/my-agent.md`:
```yaml
---
name: My Agent
description: What this agent does
color: "#3B82F6"
emoji: 🚀
vibe: Brief personality description
---

# Agent content here...
```

2. Add keywords to `router/keywords.json`:
```json
{
  "@my-agent": {
    "keywords": ["my-keyword"],
    "triggers": ["my trigger"],
    "weight": 1.0
  }
}
```

## 🎨 UI/UX Pro Max Features

Access via `@design-system-consultant`:

```bash
# Get color palette
opencode @design-system-consultant "color palette for fintech"

# Get font pairing
opencode @design-system-consultant "font pairing for luxury brand"

# Get UI style
opencode @design-system-consultant "glassmorphism card component"

# Get UX guidelines
opencode @design-system-consultant "accessibility checklist"
```

## 📚 Available Data

- **161 color palettes** by industry
- **57 font pairings** with Google Fonts
- **50+ UI styles** (glassmorphism, neumorphism, minimalism, etc.)
- **99 UX guidelines** (accessibility, performance, interaction)
- **25 chart types** for data viz
- **10 tech stacks** (React, Next.js, Vue, Svelte, etc.)

## 🛠️ Advanced Usage

### Context Detection
The orchestrator automatically detects:
- Project type (React, Next.js, Python, etc.)
- File structure
- Recent modifications
- Tech stack

### Learning
- Remembers your preferred agents
- Learns from overrides
- Suggests based on history

### Confidence Scoring
```
Score = Keywords(40%) + Context(25%) + History(20%) - Ambiguity(penalty)
```

## 📄 License

MIT - Use in any project.

## 🤝 Credits

- Agency Agents: Original multi-agent system
- Agency Swarm: Python multi-agent framework
- UI/UX Pro Max: Design intelligence database
- Merged & enhanced for OpenCode CLI

---

**Ready to build?** Copy `agents/` to your project and start with `opencode "your task here"`
