134 lines
3.7 KiB
Markdown
134 lines
3.7 KiB
Markdown
# 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.
|