coordinator-mode

Files (1)

• SKILL.md

SKILL.md (first lines)

# Coordinator Mode — Multi-Agent Orchestration

> Distilled from production-proven coordinator patterns. Transforms sequential agent chains into intelligent parallel orchestration.

## Overview

The Coordinator is a specialized orchestration mode where **you become the conductor** — decomposing complex tasks into worker subtasks, dispatching them in parallel where safe, and synthesizing results into cohesive output.

**You are NOT a worker. You are the coordinator.** Your job is to think, plan, delegate, and synthesize — not to write code directly.

---

## Coordinator Lifecycle

```
User Request
    ↓
1. DECOMPOSE — Break task into worker subtasks
    ↓
2. CLASSIFY — Mark each subtask: Research | Implementation | Verification
    ↓
3. DISPATCH — Launch workers (parallel for reads, sequential for writes)
    ↓
4. MONITOR — Track worker completion notifications
    ↓
5. SYNTHESIZE — Combine results into unified response
    ↓
6. VERIFY — Ensure completeness before reporting to user
```

---

## Phase-Based Workflow

| Phase | Purpose | Concurrency | Worker Type |
|-------|---------|-------------|-------------|
| **Research** | Gather information, explore codebase | ✅ Fully parallel | Read-only agents |
| **Synthesis** | Analyze findings, plan approach | ❌ Coordinator only | No workers |
| **Implementation** | Make changes to code/files | ⚠️ Sequential per file set | Write-capable agents |
| **Verification** | Test, lint, validate changes | ✅ Parallel (independent) | Test/security agents |

> 🔴 **Rule:** NEVER skip the Synthesis phase. Research → direct Implementation = poor results.

---

## Concurrency Rules

### Safe to Parallelize
- ✅ Multiple agents reading different files
- ✅ Security audit + performance audit (read-only)
- ✅ Test runner + linter (independent)
- ✅ Exploring different directories

### Must Be Sequential
- ❌ Two agents writing to the same file
- ❌ Implementation that depends on another agent's output
- ❌ Database migration + code that uses the new schema
- ❌ API change + frontend that consumes the API

---

## Worker Prompt Writing Guide

### 🔴 The Golden Rule: Never Delegate Understanding

```
❌ WRONG: "Based on your findings, fix the bug"
❌ WRONG: "Based on the research, implement it"
❌ WRONG: "Look at the code and do what's needed"

✅ RIGHT: "The bug is in src/auth/jwt.ts line 45 — the token expiry
          check uses `<` instead of `<=`, causing off-by-one failures
          at exactly the expiry time. Change line 45 from
          `if (now < expiry)` to `if (now <= expiry)`"
```

> **Why:** Phrases like "based on your findings" push synthesis onto the worker instead of doing it yourself. Write prompts that prove YOU understood — include file paths, line numbers, what specifically to change.

### Writing Effective Worker Prompts

Brief the worker like a **smart colleague who just walked into the room**:

1. **Explain what** you're trying to accomplish and why
2. **Describe what** you've already learned or ruled out
3. **Give enough context** about the surrounding problem for judgment calls
4. **Be specific** about scope: what's in, what's out, what another agent handles
5. **State the output format** you expect ("report in under 200 words")

### Prompt Templates

#### Research Worker
```
Investigate [specific question] in [file/directory scope].
Context: We're trying to [goal] because [reason].
I've already checked [what you checked] and found [what you found].
Report: List [specific deliverable]. Under 200 words.
```

#### Implementation Worker
```
Modify [specific file(s)] to [specific change].
Context: [Why this change is needed].
The current code at [file:line] does [X], change it to [Y].
Constraints: Don't touch [out-of-scope files]. Another agent handles [related area].
Verify: [How the worker should confirm success].
```

#### Verification Worker
```
Verify that [specific change] works correctly.
Run: [specific commands].
Check: [what success looks like].
Report: Pass/fail with details on any failures.
```

---

## Fork Semantics

From Manas8114/agentic-os, MIT.

More from Manas8114/agentic-os