test-repo/SPECIALIZED_AGENTS.md
Matt Bruce 8f4f979c85 Add specialized agent profiles and documentation
New specialized agents:
- ios-dev: iOS/Swift/SwiftUI development
- web-dev: Next.js/React/web development
- research: Research and analysis tasks

Each agent has:
- Own agent.json config with specialized system prompt
- Auto-loaded relevant skills
- Domain-specific best practices and rules
- Proper model configuration

Also added:
- SPECIALIZED_AGENTS.md documentation
- CLI_README_TEMPLATE.md for reference
2026-02-21 19:31:38 -06:00

202 lines
4.2 KiB
Markdown

# Specialized Agent Profiles
Created: February 22, 2026
## Overview
Three specialized agent profiles have been configured for different types of tasks. Each agent has its own skills, system prompt, and best practices built-in.
## Available Agents
| Agent ID | Name | Emoji | Purpose |
|----------|------|-------|---------|
| `ios-dev` | iOS Developer | 📱 | iOS/Swift/SwiftUI development |
| `web-dev` | Web Developer | 🌐 | Next.js/React/TypeScript development |
| `research` | Research Assistant | 🔍 | Research, analysis, compilation |
---
## iOS Developer (`ios-dev`)
**Best for:** iOS app development, SwiftUI, Swift, Xcode projects
**Auto-loaded Skills:**
- ios-26-role
- swiftui-expert-skill
- swift-clean-architecture
- swift-model-design
- swiftui-mvvm
- ios-project-structure
**Default Patterns:**
- Modern Swift concurrency (async/await)
- SwiftUI preferred over UIKit
- MVVM with @Observable
- iOS 26+ target
- Proper error handling & accessibility
- Unit tests for business logic
**Usage:**
```bash
# Switch to iOS agent
openclaw agents switch ios-dev
# Or spawn subagent for iOS task
# (In code: sessions_spawn with agentId: "ios-dev")
```
---
## Web Developer (`web-dev`)
**Best for:** Next.js, React, TypeScript, web apps
**Auto-loaded Skills:**
- nextjs-expert
- frontend-design
- shadcn-ui
- ui-ux-pro-max
- firebase-basics
**Default Patterns:**
- Next.js App Router
- TypeScript with strict typing
- Tailwind CSS for styling
- Responsive design
- Component composition
- Error boundaries & loading states
- Semantic HTML & accessibility
**Usage:**
```bash
# Switch to web agent
openclaw agents switch web-dev
# Or spawn subagent for web task
# (In code: sessions_spawn with agentId: "web-dev")
```
---
## Research Assistant (`research`)
**Best for:** Research tasks, information gathering, documentation
**Auto-loaded Skills:**
- browser-automation
- session-logs
**Default Patterns:**
- Web search for current info
- Multiple source verification
- Proper citation with URLs
- Well-structured markdown output
- Attribution sections
- Effective summarization
**Usage:**
```bash
# Spawn subagent for research
# (In code: sessions_spawn with agentId: "research")
```
---
## How to Use
### 1. Interactive Mode
Switch which agent you're talking to:
```bash
openclaw agents switch ios-dev
openclaw agents switch web-dev
openclaw agents switch research
openclaw agents switch main # Back to default
```
### 2. Subagent Tasks
When spawning tasks, specify the right agent:
```json
{
"agentId": "ios-dev",
"task": "Build a SwiftUI todo app with..."
}
```
```json
{
"agentId": "web-dev",
"task": "Create a Next.js dashboard with..."
}
```
```json
{
"agentId": "research",
"task": "Research the latest React patterns..."
}
```
### 3. From Main Agent
When I'm (Max) handling your requests, I can spawn the right specialist:
**iOS Task:**
```
User: "Build me a habit tracker app"
→ I spawn ios-dev subagent
→ It follows iOS skills automatically
→ Returns properly architected SwiftUI code
```
**Web Task:**
```
User: "Create a landing page"
→ I spawn web-dev subagent
→ It follows Next.js patterns from skills
→ Returns properly structured React components
```
**Research Task:**
```
User: "Find OpenClaw best practices"
→ I spawn research subagent
→ It searches, compiles, cites sources
→ Returns markdown document with attributions
```
---
## Benefits
1. **Specialized Knowledge** - Each agent loads relevant skills automatically
2. **Consistent Patterns** - iOS agent doesn't use web patterns, and vice versa
3. **Better Results** - Domain-specific expertise in each area
4. **Parallel Work** - Can spawn multiple specialized agents simultaneously
---
## Configuration Files
Agent configs stored at:
- `~/.openclaw/agents/ios-dev/agent/agent.json`
- `~/.openclaw/agents/web-dev/agent/agent.json`
- `~/.openclaw/agents/research/agent/agent.json`
Main config: `~/.openclaw/openclaw.json`
---
## Future Agents
Potential additional agents to create:
- `devops` - Infrastructure, Docker, CI/CD
- `data` - Python, data analysis, ML
- `design` - UI/UX, Figma, design systems
- `docs` - Technical writing, documentation
Just create a new `~/.openclaw/agents/<name>/agent/agent.json` and register in `openclaw.json`.