| name | parallel-agents |
| description | Multi-agent orchestration patterns. Use when multiple independent tasks can run w/ different domain expertise or when comprehensive analysis requires multiple perspectives. |
| allowed-tools | Read, Glob, Grep |
Native Parallel Agents
Orchestration via Claude Code's built-in Agent Tool
Overview
Coordinate multiple specialized agents through Claude Code's native agent system. Keeps all orchestration within Claude's control (no external scripts).
When to Use
Good for:
- Tasks requiring multiple expertise domains
- Code analysis from security, performance & quality perspectives
- Comprehensive reviews (architecture + security + testing)
- Feature impl needing backend + frontend + db work
Not for:
- Single-domain tasks
- Quick fixes | small changes
- Tasks where one agent suffices
Native Agent Invocation
Single Agent
Use the security-auditor agent to review authentication
Sequential Chain
First, use the explorer-agent to discover project structure.
Then, use the backend-specialist to review API endpoints.
Finally, use the test-engineer to identify test gaps.
W/ Context Passing
Use the frontend-specialist to analyze React components.
Based on findings, have the test-engineer generate component tests.
Resume Previous Work
Resume agent [agentId] and continue with additional requirements.
Orchestration Patterns
Pattern 1: Comprehensive Analysis
Agents: explorer-agent -> [domain-agents] -> synthesis
1. explorer-agent: Map codebase structure
2. security-auditor: Security posture
3. backend-specialist: API quality
4. frontend-specialist: UI/UX patterns
5. test-engineer: Test coverage
6. Synthesize all findings
Pattern 2: Feature Review
Agents: affected-domain-agents -> test-engineer
1. Identify affected domains (backend? frontend? both?)
2. Invoke relevant domain agents
3. test-engineer verifies changes
4. Synthesize recommendations
Pattern 3: Security Audit
Agents: security-auditor -> penetration-tester -> synthesis
1. security-auditor: Config & code review
2. penetration-tester: Active vulnerability testing
3. Synthesize w/ prioritized remediation
Available Agents
| Agent | Expertise | Triggers |
|---|
orchestrator | Coordination | "comprehensive", "multi-perspective" |
security-auditor | Security | "security", "auth", "vulnerabilities" |
penetration-tester | Security Testing | "pentest", "red team", "exploit" |
backend-specialist | Backend | "API", "server", "Node.js", "Express" |
frontend-specialist | Frontend | "React", "UI", "components", "Next.js" |
test-engineer | Testing | "tests", "coverage", "TDD" |
devops-engineer | DevOps | "deploy", "CI/CD", "infrastructure" |
database-architect | DB | "schema", "Prisma", "migrations" |
mobile-developer | Mobile | "React Native", "Flutter", "mobile" |
api-designer | API Design | "REST", "GraphQL", "OpenAPI" |
debugger | Debugging | "bug", "error", "not working" |
explorer-agent | Discovery | "explore", "map", "structure" |
documentation-writer | Docs | "write docs", "create README", "generate API docs" |
performance-optimizer | Performance | "slow", "optimize", "profiling" |
project-planner | Planning | "plan", "roadmap", "milestones" |
seo-specialist | SEO | "SEO", "meta tags", "search ranking" |
game-developer | Game Dev | "game", "Unity", "Godot", "Phaser" |
Claude Code Built-in Agents
| Agent | Model | Purpose |
|---|
| Explore | Haiku | Fast read-only codebase search |
| Plan | Sonnet | Research during plan mode |
| General-purpose | Sonnet | Multi-step modifications |
Use Explore for quick searches, custom agents for domain expertise.
Synthesis Protocol
After all agents complete:
## Orchestration Synthesis
### Task Summary
[What was accomplished]
### Agent Contributions
| Agent | Finding |
|-------|---------|
| security-auditor | Found X |
| backend-specialist | Identified Y |
### Consolidated Recommendations
1. **Critical**: [Issue from Agent A]
2. **Important**: [Issue from Agent B]
3. **Nice-to-have**: [Enhancement from Agent C]
### Action Items
- [ ] Fix critical security issue
- [ ] Refactor API endpoint
- [ ] Add missing tests
Best Practices
- 17 specialized agents available for orchestration
- Logical order - Discovery -> Analysis -> Impl -> Testing
- Share context - Pass findings to subsequent agents
- Single synthesis - One unified report, not separate outputs
- Verify changes - Always include test-engineer for code mods
Key Benefits
- Single session - All agents share context
- AI-controlled - Claude orchestrates autonomously
- Native integration - Works w/ built-in Explore, Plan agents
- Resume support - Can continue previous agent work
- Context passing - Findings flow between agents
