# project-supervisor-orchestrator

A subagent that runs a chain of other agents step by step and returns the result as JSON. Useful when one request has to pass through several specialized agents.

- subagent · `type=agent` · Claude Code · 1563 installs
- Author: davila7
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/davila7/claude-code-templates/tree/HEAD/cli-tool/components/agents/podcast-creator-team/project-supervisor-orchestrator.md
- Updated: 2026-10-24
- HTML: https://affpapa.org/en/nevibecode/agents/project-supervisor-orchestrator

## What it does

The subagent inspects an incoming request and decides whether it carries enough data to start. When the full set of fields is there, it invokes agents in order through the `call_agent` function and merges their output. When something is missing, it asks exactly one clarifying question before routing the work onward.

Inside are instructions for intent detection, passing data between sequential agents, and error handling. Every response, including a failure or a clarification request, comes back as JSON with a status of `success`, `clarification_needed` or `error`. Only `Read` and `Write` are listed as tools, so the agent itself writes no code and runs no commands.

The completeness check keys off specific episode fields — title, guest, topics, duration. Point it at a different input shape and you will need to edit that detection logic, or the agent keeps asking for clarification. Install with `npx claude-code-templates@latest --agent podcast-creator-team/project-supervisor-orchestrator`; the file lands at `.claude/agents/project-supervisor-orchestrator.md`.

## Install

### Claude Code (native platform)

1. **claude-code-templates**
```bash
npx claude-code-templates@latest --agent podcast-creator-team/project-supervisor-orchestrator
```

2. **Manually: put the files in place**
- File: `.claude/agents/project-supervisor-orchestrator.md` — For all projects use ~/.claude/agents/. Claude delegates by the description field or an @-mention

### Codex

**Manually: put the files in place**
- File: `.codex/agents/project-supervisor-orchestrator.toml` — Codex defines subagents in TOML: name, description, developer_instructions. Move the Markdown text into developer_instructions by hand. For all projects use ~/.codex/agents/

### Cursor

**Manually: put the files in place**
- File: `.cursor/agents/project-supervisor-orchestrator.md` — Cursor also reads .claude/agents/

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/davila7/claude-code-templates/tree/HEAD/cli-tool/components/agents/podcast-creator-team/project-supervisor-orchestrator.md

## When to use it
- run a request through a chain of agents in order
- decide whether the data is complete or ask for the missing part
- merge output from several agents into one response
- return a failed step as parseable output
- keep data intact across agent handoffs

## Example prompts
- run project-supervisor-orchestrator on this episode
- check whether the fields are complete, and ask if they are not
- push the data through the agent chain and return JSON

## Similar
- [frontend-developer](https://affpapa.org/en/nevibecode/agents/voltagent-community-frontend-developer.md) — subagent · 40905 installs
- [dx-optimizer](https://affpapa.org/en/nevibecode/agents/dx-optimizer.md) — subagent · 1198 installs
- [mlops-engineer](https://affpapa.org/en/nevibecode/agents/voltagent-community-mlops-engineer.md) — subagent · 1009 installs
- [postgres-pro](https://affpapa.org/en/nevibecode/agents/postgres-pro.md) — subagent · 897 installs
- [agent-installer](https://affpapa.org/en/nevibecode/agents/agent-installer.md) — subagent · 363 installs
- [embedded-systems](https://affpapa.org/en/nevibecode/agents/embedded-systems.md) — subagent · 279 installs

From the same set: [davila7/claude-code-templates](https://affpapa.org/en/nevibecode/by/davila7/claude-code-templates.md) — 205 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md