mcpField
P
parallel-agents

parallel-agents

github.com/davila7Agent workflows33.0k450 installsUpdated today
Repository

About parallel-agents

Native Parallel Agents is a skill for coordinating specialized agents through Claude Code's built-in Agent Tool. It supports staged analysis, context handoffs, and synthesis for complex work spanning multiple domains.

Key features

  1. 01Coordinate specialized agents in Claude Code
  2. 02Run agents sequentially with context passing
  3. 03Resume prior agent work
  4. 04Synthesize findings into one report
  5. 05Use built-in and custom agent roles

Use cases

  1. 01Review code from security and quality perspectives
  2. 02Map a codebase before domain-specific analysis
  3. 03Coordinate feature work across backend and frontend
  4. 04Combine audit findings into prioritized recommendations

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/davila7/claude-code-templates --skill parallel-agents

After installing, type/parallel-agentsin Claude Code to confirm it loaded.

Details

From the project README

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

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: Configuration and code review
2. penetration-tester: Active vulnerability testing
3. Synthesize with prioritized remediation

Available Agents

AgentExpertiseTrigger Phrases
orchestratorCoordination"comprehensive", "multi-perspective"
security-auditorSecurity"security", "auth", "vulnerabilities"
penetration-testerSecurity Testing"pentest", "red team", "exploit"
backend-specialistBackend"API", "server", "Node.js", "Express"
frontend-specialistFrontend"React", "UI", "components", "Next.js"
test-engineerTesting"tests", "coverage", "TDD"
devops-engineerDevOps"deploy", "CI/CD", "infrastructure"
database-architectDatabase"schema", "Prisma", "migrations"
mobile-developerMobile"React Native", "Flutter", "mobile"
api-designerAPI Design"REST", "GraphQL", "OpenAPI"
debuggerDebugging"bug", "error", "not working"
explorer-agentDiscovery"explore", "map", "structure"
documentation-writerDocumentation"write docs", "create README", "generate API docs"
performance-optimizerPerformance"slow", "optimize", "profiling"
project-plannerPlanning"plan", "roadmap", "milestones"
seo-specialistSEO"SEO", "meta tags", "search ranking"
game-developerGame Development"game", "Unity", "Godot", "Phaser"

Claude Code Built-in Agents

These work alongside custom agents:

AgentModelPurpose
ExploreHaikuFast read-only codebase search
PlanSonnetResearch during plan mode
General-purposeSonnetComplex 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
| 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

  1. Available agents - 17 specialized agents can be orchestrated
  2. Logical order - Discovery → Analysis → Implementation → Testing
  3. Share context - Pass relevant findings to subsequent agents
  4. Single synthesis - One unified report, not separate outputs
  5. 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

Comments

Markdown supported