# Subagent Team Registry

## Simple Team (Option A) - Active

### Team Members

| Name | Role | Folder | Status | Model |
|------|------|--------|--------|-------|
| **Alice-Researcher** | Research & Analysis | `agents/alice-researcher/` | ✅ Ready | default |
| **Bob-Implementer** | Code Implementation | `agents/bob-implementer/` | ✅ Ready | default |
| **Charlie-Tester** | Testing & QA | `agents/charlie-tester/` | ✅ Ready | default |
| **Heartbeat-Monitor** | System Checks | `agents/heartbeat-monitor/` | ✅ Ready | ollama/qwen3:14b |

### Heartbeat-Monitor Details

**Schedule:** Every ~20 minutes via cron

**Checks:** Mission Control, Email, Calendar, Git Status, Memory Maintenance

**Spawn Command:**
```javascript
sessions_spawn({
  task: "Run heartbeat checks - check state file, rotate through tasks, keep under 30s each",
  label: "Heartbeat-Monitor",
  agentId: "main",
  model: "ollama/qwen3:14b"
})
```

## Workflow

### Standard Flow (Most Tasks)
```
Request → Alice (Research) → Bob (Implement) → Charlie (Test) → Done
  15 min      30 min           10 min
```

### Quick Flow (Simple/Obvious Tasks)
```
Request → Bob (Implement) → Charlie (Test) → Done
          20 min           10 min
```

### Research-Only Flow
```
Request → Alice (Research) → Report to User
          15 min
```

## How to Spawn

### Alice (Research)
```javascript
sessions_spawn({
  task: `Research: [question]\n\nContext: [background]\n\nConstraints: [budget/timeline/platform]\n\nRead your SOUL.md at: /Users/mattbruce/.openclaw/workspace/agents/alice-researcher/SOUL.md`,
  label: "Alice-Researcher",
  agentId: "main",
  model: "default"
})
```

### Bob (Implement)
```javascript
sessions_spawn({
  task: `Implement: [feature]\n\nBased on: [Alice's research / spec]\n\nRequirements:\n- [ ] Req 1\n- [ ] Req 2\n\nTech stack: [iOS/Next.js/etc]\n\nRead your SOUL.md at: /Users/mattbruce/.openclaw/workspace/agents/bob-implementer/SOUL.md`,
  label: "Bob-Implementer",
  agentId: "main",
  model: "default"
})
```

### Charlie (Test)
```javascript
sessions_spawn({
  task: `Test: [feature]\n\nCode to test: [files/code]\n\nRequirements: [what it should do]\n\nFocus areas: [tricky parts]\n\nRead your SOUL.md at: /Users/mattbruce/.openclaw/workspace/agents/charlie-tester/SOUL.md`,
  label: "Charlie-Tester",
  agentId: "main",
  model: "ollama/minimax-m2.5:cloud"
})
```

## When to Use Each

### Use Alice When:
- Technology choice is unclear
- Multiple valid approaches exist
- Need to evaluate libraries/frameworks
- Researching competitors or best practices
- Risk assessment needed

### Use Bob When:
- Requirements are clear
- Technology is chosen (by Alice or you)
- Ready to write code
- Building features, APIs, UI

### Use Charlie When:
- Bob has finished implementation
- Need comprehensive testing
- Code review required
- Quality gate before deployment

## Communication Format

Each agent announces completion:
- **Alice:** "Alice-Researcher ✅ 5 options evaluated – Recommended: X – Ready for Bob"
- **Bob:** "Bob-Implementer ✅ [feature] implemented – 3 files changed – Ready for Charlie"
- **Charlie:** "Charlie-Tester ✅ 12 tests passed – 2 bugs found – Needs fixes before deploy"

## File Structure

```
agents/
├── alice-researcher/
│   ├── SOUL.md          # Personality & rules
│   └── AGENTS.md        # Role definition
├── bob-implementer/
│   ├── SOUL.md
│   └── AGENTS.md
├── charlie-tester/
│   ├── SOUL.md
│   └── AGENTS.md
└── TEAM-REGISTRY.md     # This file
```

## Future Expansion (Option B/C)

If you need more specialized agents later, add them here:
- Dana-Architect (system design)
- Eve-Designer (UI/UX)
- Hank-DevOps (deployment)

For now, Alice/Bob/Charlie cover 90% of needs.
