---
name: solo-swarm
description: Use when "swarm research", "parallel research", "investigate fast", "3 agents", "team research", or want faster multi-angle alternative to /research. Do NOT use for solo research (/research) or idea scoring (/validate).
license: MIT
metadata:
  author: fortunto2
  version: "1.6.0"
  openclaw:
    emoji: "🐝"
allowed-tools: Read, Grep, Glob, Bash, WebSearch, WebFetch, Write, mcp__searxng__web_search, mcp__searxng__web_extract, mcp__solograph__kb_search, mcp__solograph__project_info, mcp__solograph__codegraph_query, mcp__solograph__codegraph_explain, mcp__solograph__project_code_search, mcp__solograph__session_search
argument-hint: "[idea name or description]"
---

# /swarm

Create an agent team to research "$ARGUMENTS" from multiple perspectives in parallel.

## Team Structure

Spawn 3 teammates, each with a distinct research focus:

### 1. Market Researcher
Focus: competitors, market size, pricing models, business models.
- Search for direct and indirect competitors
- Find market reports with TAM/SAM/SOM figures
- Analyze pricing strategies and monetization
- Identify market gaps and opportunities
- Check Product Hunt, G2, Capterra for existing products

### 2. User Researcher
Focus: pain points, user sentiment, feature requests.
- Search Reddit for user discussions (`site:reddit.com <query>` via WebSearch, or MCP `web_search` if available)
- Search Hacker News for tech community opinions (`site:news.ycombinator.com`)
- If MCP `session_search` available: check if this idea was researched before in past sessions
- Find app reviews and ratings
- Extract direct user quotes about frustrations
- Identify unmet needs and feature requests

### 3. Technical Analyst
Focus: feasibility, tech stack, existing solutions, implementation complexity.
- Search GitHub for open-source alternatives (`site:github.com <query>`)
- Evaluate tech stack options
- If MCP `project_info` available: check existing projects for reusable code
- If MCP `codegraph_explain` available: get architecture overview of similar existing projects
- If MCP `codegraph_query` available: find shared packages across projects
- If MCP `project_code_search` available: search for reusable patterns, services, infrastructure across existing projects
- Assess implementation complexity and timeline

## Search Backends

Teammates should use available search tools:
- **WebSearch** (built-in) — broad discovery, market reports, always available
- **WebFetch** — scrape specific URLs for details, always available
- **MCP `web_search`** (if available) — additional search with engine routing
- **MCP `web_extract`** (if available) — read a single page as clean markdown
- **MCP `kb_search`** (if available) — search local knowledge base for related research

**Domain filtering:** use `site:github.com`, `site:reddit.com` etc. for targeted results.

## Coordination

- Each teammate writes findings to a shared task list
- Require plan approval before teammates start deep research
- After all complete, synthesize findings into `research.md`
- Use the research.md format from `/research` skill

## Output

After team completes, the lead should:
1. Synthesize findings from all 3 teammates
2. Write `research.md` to `docs/` in the current project directory
3. Provide GO / NO-GO / PIVOT recommendation
4. Suggest next step: `/validate <idea>`

## Common Issues

### Agent team not available
**Cause:** `CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS` env var not set.
**Fix:** Ensure `.claude/settings.json` has `"env": {"CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS": "1"}`.

### Teammates produce overlapping findings
**Cause:** Research areas not clearly separated.
**Fix:** Each teammate has a distinct focus (market/users/tech). The lead synthesizes and deduplicates findings.

### Web search returns limited results
**Cause:** No additional search backends configured.
**Fix:** Teammates fall back to WebSearch (built-in) which is always available. For richer results with engine routing (Reddit, GitHub, YouTube), set up [SearXNG](https://github.com/fortunto2/searxng-docker-tavily-adapter) (private, self-hosted, free) and configure solograph MCP.