---
name: Agent Orchestration
slug: agent-orchestration-3
category: AI Engineering
description: Agent Orchestration tells Claude Code when to delegate implementation work to a helper agent to preserve main-context tokens. Use it for multi-file features, plan-following tasks, and tests.
github: "https://github.com/vibeeval/vibecosystem/tree/main/skills/agent-orchestration"
language: "C#"
stars: 528
forks: 44
install: "npx degit https://github.com/vibeeval/vibecosystem/tree/main/skills/agent-orchestration ~/.claude/skills/agent-orchestration"
installs_to: ~/.claude/skills/agent-orchestration
source_path: skills/agent-orchestration/SKILL.md
collection_size: 25
category_size: 2451
collection_url: "https://dirskills.com/collections/vibeeval/vibecosystem"
added: 2026-08-26T05:11:55.801Z
last_synced: 2026-08-26T05:11:55.801Z
canonical_url: "https://dirskills.com/skills/agent-orchestration-3"
---

# Agent Orchestration

Agent Orchestration tells Claude Code when to delegate implementation work to a helper agent to preserve main-context tokens. Use it for multi-file features, plan-following tasks, and tests.

**Install:**

```bash
npx degit https://github.com/vibeeval/vibecosystem/tree/main/skills/agent-orchestration ~/.claude/skills/agent-orchestration
```

## README

# Agent Orchestration Rules

When the user asks to implement something, use implementation agents to preserve main context.

## The Pattern

**Wrong - burns context:**
```
Main: Read files → Understand → Make edits → Report
      (2000+ tokens consumed in main context)
```

**Right - preserves context:**
```
Main: Spawn agent("implement X per plan")
      ↓
Agent: Reads files → Understands → Edits → Tests
      ↓
Main: Gets summary (~200 tokens)
```

## When to Use Agents

| Task Type | Use Agent? | Reason |
|-----------|------------|--------|
| Multi-file implementation | Yes | Agent handles complexity internally |
| Following a plan phase | Yes | Agent reads plan, implements |
| New feature with tests | Yes | Agent can run tests |
| Single-line fix | No | Faster to do directly |
| Quick config change | No | Overhead not worth it |

## Key Insight

Agents read their own context. Don't read files in main chat just to understand what to pass to an agent - give them the task and they figure it out.

## Example Prompt

```
Implement Phase 4: Outcome Marking Hook from the Artifact Index plan.

**Plan location:** thoughts/shared/plans/2025-12-24-artifact-index.md (search for "Phase 4")

**What to create:**
1. TypeScript hook
2. Shell wrapper
3. Python script
4. Register in settings.json

When done, provide a summary of files created and any issues.
```

## Trigger Words

When user says these, consider using an agent:
- "implement", "build", "create feature"
- "follow the plan", "do phase X"
- "use implementation agents"