parallel-dispatch
Generic parallel agent orchestration utility for launching multiple agents concurrently. Use when relevant to the task.
When & Why to Use This Skill
This Claude skill provides a robust framework for parallel agent orchestration, allowing users to launch and manage multiple specialized agents simultaneously. It streamlines complex workflows by automating prompt preparation, concurrent execution, and result consolidation, significantly reducing processing time for multi-faceted tasks like comprehensive reviews and cross-domain analysis.
Use Cases
- Comprehensive Technical Reviews: Concurrently dispatch security, testing, and requirements agents to analyze software architecture documents from multiple perspectives in a single pass.
- Multi-Stakeholder Content Approval: Simultaneously run brand compliance, legal, and quality control agents to vet marketing materials or documentation before publication.
- Cross-Domain Data Analysis: Launch specialized agents to perform parallel analysis on large datasets, combining insights from market research, financial forecasting, and risk assessment.
- Automated SDLC Gate Evaluation: Act as a foundational layer for software development life cycle gates where multiple criteria (performance, security, and style) must be evaluated concurrently before code promotion.
| name | parallel-dispatch |
|---|---|
| description | Generic parallel agent orchestration utility for launching multiple agents concurrently. Use when relevant to the task. |
parallel-dispatch
Generic parallel agent orchestration utility for launching multiple agents concurrently.
Triggers
- "launch parallel [agents]"
- "concurrent review by [agents]"
- "multi-agent [task]"
- "parallel analysis"
- "dispatch agents"
Purpose
This skill provides the foundational infrastructure for launching multiple agents in parallel, collecting their results, and handling timeouts. It is used by higher-level skills like artifact-orchestration, review-synthesis, and gate-evaluation.
Behavior
When triggered, this skill:
Parses agent configuration:
- Agent names (from built-in or custom)
- Prompt templates for each agent
- Shared context/artifact reference
- Timeout settings
Prepares agent-specific prompts:
- Loads prompt template per agent
- Injects shared context (artifact path, requirements)
- Adds output format requirements
Launches agents in parallel:
- Uses single message with multiple Task tool calls
- Each agent runs independently
- No inter-agent communication during execution
Collects results:
- Waits for all agents or timeout
- Captures success/failure per agent
- Structures results for downstream processing
Returns consolidated results:
- Per-agent output
- Execution metadata (duration, status)
- Aggregated insights (if configured)
Configuration Format
dispatch:
name: "artifact-review"
timeout: 300 # seconds
agents:
- name: security-architect
prompt: |
Review the artifact at {artifact_path} for security concerns.
Focus on: authentication, authorization, data protection, input validation.
Output format: structured findings with severity ratings.
- name: test-architect
prompt: |
Review the artifact at {artifact_path} for testability.
Focus on: test coverage gaps, edge cases, integration points.
Output format: test recommendations with priority.
- name: requirements-analyst
prompt: |
Review the artifact at {artifact_path} for requirements traceability.
Focus on: requirement coverage, gaps, conflicts.
Output format: traceability assessment.
context:
artifact_path: ".aiwg/architecture/sad.md"
requirements_path: ".aiwg/requirements/"
result_format: structured # or 'raw'
aggregate: true # combine findings
Usage Examples
Basic Parallel Review
User: "Launch parallel review of the SAD by security-architect, test-architect, and requirements-analyst"
Skill executes:
1. Loads SAD from .aiwg/architecture/
2. Prepares review prompts for each agent
3. Dispatches all three agents in single message
4. Collects reviews (timeout: 5 min)
5. Returns structured results
Custom Agent Configuration
User: "Dispatch agents with config from .aiwg/config/review-config.yaml"
Skill executes:
1. Loads configuration file
2. Validates agent names exist
3. Prepares prompts from templates
4. Dispatches with configured timeout
5. Returns results in configured format
Result Format
Structured Results
{
"dispatch_id": "review-20251208-143022",
"status": "completed",
"duration_seconds": 127,
"agents": {
"security-architect": {
"status": "success",
"duration": 45,
"output": {
"findings": [...],
"severity_summary": {...},
"recommendations": [...]
}
},
"test-architect": {
"status": "success",
"duration": 52,
"output": {
"coverage_gaps": [...],
"test_recommendations": [...],
"priority_order": [...]
}
},
"requirements-analyst": {
"status": "success",
"duration": 38,
"output": {
"traced_requirements": [...],
"gaps": [...],
"conflicts": [...]
}
}
},
"aggregate": {
"total_findings": 12,
"critical_issues": 2,
"recommendations": 8
}
}
Raw Results
{
"dispatch_id": "review-20251208-143022",
"agents": {
"security-architect": "Full text output from agent...",
"test-architect": "Full text output from agent...",
"requirements-analyst": "Full text output from agent..."
}
}
Error Handling
Timeout Handling
timeout_behavior:
action: "partial" # or "fail"
# partial: return results from completed agents
# fail: return error if any agent times out
Agent Failure
failure_behavior:
action: "continue" # or "abort"
# continue: proceed with other agents
# abort: stop all if one fails
retry: 1 # retry failed agents once
Built-in Agent Groups
For convenience, common agent combinations are pre-defined:
Architecture Review Group
group: architecture-review
agents:
- security-architect
- test-architect
- requirements-analyst
- technical-writer
Security Review Group
group: security-review
agents:
- security-architect
- security-auditor
- privacy-officer
Documentation Review Group
group: documentation-review
agents:
- technical-writer
- requirements-analyst
- domain-expert
Marketing Review Group
group: marketing-review
agents:
- brand-guardian
- legal-reviewer
- quality-controller
- accessibility-checker
Integration
This skill is the foundation for:
artifact-orchestration(SDLC)gate-evaluation(SDLC)review-synthesis(MMK)brand-compliance(MMK)
CLI Usage
# Using Python script
python parallel_dispatcher.py --config review-config.yaml
# With inline agents
python parallel_dispatcher.py \
--agents "security-architect,test-architect" \
--artifact ".aiwg/architecture/sad.md" \
--timeout 300
# List available groups
python parallel_dispatcher.py --list-groups
# Validate configuration
python parallel_dispatcher.py --config review-config.yaml --validate
Performance Considerations
- Optimal parallelism: 3-5 agents per dispatch
- Timeout guidance: 2-5 minutes for document review
- Memory: Each agent has isolated context
- Cost: Parallel execution uses more tokens but reduces wall-clock time
References
- Agent definitions: Framework
agents/directories - Configuration schema:
schemas/dispatch-config.schema.json - Result schema:
schemas/dispatch-result.schema.json