# Complex Orchestrator

> Orchestrates multi-file tasks by delegating to parallel sub-agents. Use when a task spans multiple files or components and can benefit from parallel execution to save context and time.

- Skill: `majiayu000/complex-orchestrator` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds add majiayu000/complex-orchestrator`
- Raw SKILL.md: https://api.skillmd.com/api/skills/majiayu000/complex-orchestrator/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Productivity
- Author: majiayu000 (https://skillmd.com/u/majiayu000)
- Updated: 2026-09-09
- Page: https://skillmd.com/skills/majiayu000/complex-orchestrator

---


# Parallel Task Orchestrator

Distribute multi-file work across parallel sub-agents to save context and time.

## When to Use

```
Task spans multiple files?
    │
    ├─ Independent? ──────► Full Parallel
    ├─ Some dependencies? ─► Staged Parallel (waves)
    └─ Tightly coupled? ──► Sequential or single agent
```

## 4-Step Workflow

### 1. Decompose
Break into file-scoped units. Identify dependencies.

### 2. Choose Strategy
- **Full Parallel**: All units independent
- **Staged Parallel**: Wave 1 (dependencies) → Wave 2 (consumers)
- **Fan-out/Fan-in**: Setup → parallel work → integration

### 3. Delegate in Parallel
Launch multiple Tasks in **single message**:
```typescript
Task({ subagent_type: "general-purpose", description: "Edit file A", prompt: "..." })
Task({ subagent_type: "general-purpose", description: "Edit file B", prompt: "..." })
```

### 4. Integrate
- Verify each succeeded
- Check for conflicts
- Run integration tests

## Sub-agent Prompt Structure

```markdown
## Scope
File: [path] | Task: [what to do in THIS file only]

## Context
Pattern: [consistent approach across all units]

## Constraints
- Only modify [path]
- Follow existing style
```

## Agent Selection

| Sub-task | Agent |
|----------|-------|
| Simple edit | `general-purpose` |
| Exploration needed | `Explore` → `general-purpose` |
| Complex logic | `advanced-general-purpose` |

---

*For detailed examples and troubleshooting, see `examples.md`*