parallel-agents - Agent Skills

Native Parallel Agents

> Orchestration through Claude Code's built-in Agent Tool

Overview

This skill enables coordinating multiple specialized agents through Claude Code's native agent system. Unlike external scripts, this approach keeps all orchestration within Claude's control.

When to Use Orchestration

✅ Good for:

Complex tasks requiring multiple expertise domains

Code analysis from security, performance, and quality perspectives

Comprehensive reviews (architecture + security + testing)

Feature implementation needing backend + frontend + database work

❌ Not for:

Simple, single-domain tasks

Quick fixes or 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.

With Context Passing

Use the frontend-specialist to analyze React components.
Based on those 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
explorer-agent: Map codebase structure

security-auditor: Security posture

backend-specialist: API quality

frontend-specialist: UI/UX patterns

test-engineer: Test coverage

Synthesize all findings

Pattern 2: Feature Review

Agents: affected-domain-agents → test-engineer
Identify affected domains (backend? frontend? both?)

Invoke relevant domain agents

test-engineer verifies changes

Synthesize recommendations

Pattern 3: Security Audit

Agents: security-auditor → penetration-tester → synthesis
security-auditor: Configuration and code review

penetration-tester: Active vulnerability testing

Synthesize with prioritized remediation

Available Agents

Agent	Expertise	Trigger Phrases
`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`	Database	"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`	Documentation	"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 Development	"game", "Unity", "Godot", "Phaser"

Claude Code Built-in Agents

These work alongside custom agents:

Agent	Model	Purpose
Explore	Haiku	Fast read-only codebase search
Plan	Sonnet	Research during plan mode
General-purpose	Sonnet	Complex multi-step modifications

Use Explore for quick searches, custom agents for domain expertise.

Synthesis Protocol

After all agents complete, synthesize:

## Orchestration Synthesis
Task Summary

[What was accomplished]
Agent Contributions

<div class="overflow-x-auto my-6"><table class="min-w-full divide-y divide-border border border-border"><thead><tr><th class="px-4 py-2 text-left text-sm font-semibold text-foreground bg-muted/50">Agent</th><th class="px-4 py-2 text-left text-sm font-semibold text-foreground bg-muted/50">Finding</th></tr></thead><tbody class="divide-y divide-border"><tr><td class="px-4 py-2 text-sm text-foreground">security-auditor</td><td class="px-4 py-2 text-sm text-foreground">Found X</td></tr><tr><td class="px-4 py-2 text-sm text-foreground">backend-specialist</td><td class="px-4 py-2 text-sm text-foreground">Identified Y</td></tr></tbody></table></div>
Consolidated Recommendations

Critical: [Issue from Agent A]

Important: [Issue from Agent B]

Nice-to-have: [Enhancement from Agent C]
Action Items

[ ] Fix critical security issue

[ ] Refactor API endpoint

[ ] Add missing tests

Best Practices

Available agents - 17 specialized agents can be orchestrated

Logical order - Discovery → Analysis → Implementation → Testing

Share context - Pass relevant findings to subsequent agents

Single synthesis - One unified report, not separate outputs

Verify changes - Always include test-engineer for code modifications

Key Benefits

✅ Single session - All agents share context

✅ AI-controlled - Claude orchestrates autonomously

✅ Native integration - Works with built-in Explore, Plan agents

✅ Resume support - Can continue previous agent work

✅ Context passing - Findings flow between agents