Team Agent Orchestration
Use this skill when agents are being managed like a team rather than a single assistant. The purpose is to make team-based orchestration reliable: clear work items, explicit ownership, agent Kanban state, branch isolation, control pane visibility, and merge gates.
When To Activate
- The task spans multiple agents, tools, harnesses, branches, or worktrees.
- The user mentions team orchestration, agent Kanban, squad, conductor, control pane, manager, desktop app, Zellij, tmux, Hermes, Devin, Codex, Claude Code, or multi-agent work.
- A project needs shared workflow state across people and agents.
- Existing agent fan-out is producing output but not mergeable product.
Operating Model
Treat every agent as a teammate with a narrow contract:
- Owner: the person or agent accountable for the work item.
- Scope: files, branch, tool surface, and forbidden areas.
- State: backlog, ready, running, review, blocked, merged, or archived.
- Evidence: tests, screenshots, logs, review notes, or eval reports.
- Merge gate: the exact condition that allows integration.
Agent Kanban
Use agent Kanban when work must be visible across sessions.
| Column |
Meaning |
Exit Criteria |
| Backlog |
Candidate work item, not yet shaped |
Acceptance criteria written |
| Ready |
Shaped and assignable |
Owner and branch/worktree assigned |
| Running |
Agent is actively working |
Handoff artifact and changed files exist |
| Review |
Work is complete but not merged |
Tests, diff review, and risk check pass |
| Blocked |
Needs external input or failed gate |
Blocker has owner and next action |
| Merged |
Integrated into mainline |
PR merged or local main updated |
| Archived |
No longer relevant |
Reason recorded |
Each card should fit this schema:
{
"id": "agent-card-001",
"title": "Build dynamic workflow skill",
"owner": "codex",
"state": "running",
"branch": "product/dynamic-workflow-team-orchestration",
"worktree": ".",
"acceptance": [
"Skill exists",
"Tests cover required concepts",
"Content artifact contains video and article angles"
],
"merge_gate": "lint, focused tests, and catalog check pass",
"handoff": "path/to/handoff.md"
}
Team-Based Orchestration Flow
- Shape the board: convert fuzzy ambition into work items with owners and merge gates.
- Pick execution mode: single-agent, dynamic workflow mode, dmux/tmux, worktree fan-out, or external desktop orchestrator.
- Assign boundaries: one owner per card, clear file scope, and no overlapping writes without an integrator.
- Run agents: each agent writes evidence and handoff notes, not just code.
- Review in sequence: tests first, then diff review, then security/risk checks, then content/product polish.
- Merge deliberately: one integrator resolves conflicts and updates the control pane or status artifact.
- Extract reusable skill: if the card pattern repeats, promote it into
skills/.
Control Pane Requirements
A useful control pane for team orchestration should show:
- Active work items and their agent Kanban state.
- Owner, harness, branch, worktree, and last heartbeat.
- Links to handoff artifacts, tests, screenshots, and PRs.
- Blockers grouped by owner and unblock action.
- Merge readiness by gate, not vibes.
- Reusable workflow candidates that should become shared skills.
Do not add more automation until the operator can answer: who owns this, what changed, what gate failed, and what can safely merge?
Dynamic Workflow Compatibility
When a card needs dynamic workflow mode:
- Put the task-local harness under the card owner.
- Store inputs and outputs on the card.
- Require an eval before moving from Running to Review.
- Promote the harness to a shared skill only after repeat use.
Failure Modes To Watch
- Agent soup: many agents running, no owner or merge gate.
- Invisible work: useful output exists only in a chat transcript.
- Board theater: a Kanban board exists but cards have no acceptance criteria.
- Overlapping writes: parallel agents edit the same files without worktrees.
- No product artifact: the process produces docs but no runnable or publishable surface.
Output Standard
Finish each orchestration pass with:
- Board/card changes.
- Merged or pending branches.
- Tests and eval evidence.
- Blockers with owner and next action.
- New shared skill candidates.
1---
2name: team-agent-orchestration
3description: Run team-based orchestration for agent squads using work items, ownership, agent Kanban, merge gates, and control pane handoffs.
4metadata:
5 source: https://skillmd.com/skills/rajanthar/team-agent-orchestration
6---
7
8# Team Agent Orchestration
9
10Use this skill when agents are being managed like a team rather than a single assistant. The purpose is to make team-based orchestration reliable: clear work items, explicit ownership, agent Kanban state, branch isolation, control pane visibility, and merge gates.
11
12## When To Activate
13
14- The task spans multiple agents, tools, harnesses, branches, or worktrees.
15- The user mentions team orchestration, agent Kanban, squad, conductor, control pane, manager, desktop app, Zellij, tmux, Hermes, Devin, Codex, Claude Code, or multi-agent work.
16- A project needs shared workflow state across people and agents.
17- Existing agent fan-out is producing output but not mergeable product.
18
19## Operating Model
20
21Treat every agent as a teammate with a narrow contract:
22
23- **Owner**: the person or agent accountable for the work item.
24- **Scope**: files, branch, tool surface, and forbidden areas.
25- **State**: backlog, ready, running, review, blocked, merged, or archived.
26- **Evidence**: tests, screenshots, logs, review notes, or eval reports.
27- **Merge gate**: the exact condition that allows integration.
28
29## Agent Kanban
30
31Use agent Kanban when work must be visible across sessions.
32
33| Column | Meaning | Exit Criteria |
34| --- | --- | --- |
35| Backlog | Candidate work item, not yet shaped | Acceptance criteria written |
36| Ready | Shaped and assignable | Owner and branch/worktree assigned |
37| Running | Agent is actively working | Handoff artifact and changed files exist |
38| Review | Work is complete but not merged | Tests, diff review, and risk check pass |
39| Blocked | Needs external input or failed gate | Blocker has owner and next action |
40| Merged | Integrated into mainline | PR merged or local main updated |
41| Archived | No longer relevant | Reason recorded |
42
43Each card should fit this schema:
44
45```json
46{
47 "id": "agent-card-001",
48 "title": "Build dynamic workflow skill",
49 "owner": "codex",
50 "state": "running",
51 "branch": "product/dynamic-workflow-team-orchestration",
52 "worktree": ".",
53 "acceptance": [
54 "Skill exists",
55 "Tests cover required concepts",
56 "Content artifact contains video and article angles"
57 ],
58 "merge_gate": "lint, focused tests, and catalog check pass",
59 "handoff": "path/to/handoff.md"
60}
61```
62
63## Team-Based Orchestration Flow
64
651. **Shape the board**: convert fuzzy ambition into work items with owners and merge gates.
662. **Pick execution mode**: single-agent, dynamic workflow mode, dmux/tmux, worktree fan-out, or external desktop orchestrator.
673. **Assign boundaries**: one owner per card, clear file scope, and no overlapping writes without an integrator.
684. **Run agents**: each agent writes evidence and handoff notes, not just code.
695. **Review in sequence**: tests first, then diff review, then security/risk checks, then content/product polish.
706. **Merge deliberately**: one integrator resolves conflicts and updates the control pane or status artifact.
717. **Extract reusable skill**: if the card pattern repeats, promote it into `skills/`.
72
73## Control Pane Requirements
74
75A useful control pane for team orchestration should show:
76
77- Active work items and their agent Kanban state.
78- Owner, harness, branch, worktree, and last heartbeat.
79- Links to handoff artifacts, tests, screenshots, and PRs.
80- Blockers grouped by owner and unblock action.
81- Merge readiness by gate, not vibes.
82- Reusable workflow candidates that should become shared skills.
83
84Do not add more automation until the operator can answer: who owns this, what changed, what gate failed, and what can safely merge?
85
86## Dynamic Workflow Compatibility
87
88When a card needs dynamic workflow mode:
89
90- Put the task-local harness under the card owner.
91- Store inputs and outputs on the card.
92- Require an eval before moving from Running to Review.
93- Promote the harness to a shared skill only after repeat use.
94
95## Failure Modes To Watch
96
97- **Agent soup**: many agents running, no owner or merge gate.
98- **Invisible work**: useful output exists only in a chat transcript.
99- **Board theater**: a Kanban board exists but cards have no acceptance criteria.
100- **Overlapping writes**: parallel agents edit the same files without worktrees.
101- **No product artifact**: the process produces docs but no runnable or publishable surface.
102
103## Output Standard
104
105Finish each orchestration pass with:
106
107- Board/card changes.
108- Merged or pending branches.
109- Tests and eval evidence.
110- Blockers with owner and next action.
111- New shared skill candidates.