handoff-orchestrator git:20260911.fca2e0eA

Immutable. This exact content never changes and is served at /api/v1/blob/125801c68256f576.

---
name: handoff-orchestrator
description: Use when an approved work scope moves to a new orchestrator in its own Herdr tab.
---

# Hand off one orchestrator scope

## 1. Get approval

A handoff creates another user-facing window, so the current main agent first presents one approval decision, naming the scope that moves and any work this orchestrator retains.
A new tab is created only after the user approves.

## 2. Carry continuity

Pass only goal and scope, confirmed decisions and user terms, current state and evidence, next action, and exclusions.
Omit empty fields and conversation text.

## 3. Launch and transfer

Run `handoff-orchestrator.py` with `--user-approved`, this pane, cwd, provider, and the continuity fields.
The script creates and labels an independent tab, starts the receiving orchestrator, prompts it to invoke `boss-say` and then accept, and verifies the handshake after that route is established.
It retries once; final failure closes the new tab and leaves ownership here.

## 4. Leave the scope

On acceptance, status events, investigation, scheduling, reporting, and cleanup all belong to the receiver.
Report the new tab and transferred scope compactly.
Continue only the scope passed through `--retains`.
When none is retained, let the launcher close this pane after it emits the accepted result.

**Complete when:** the receiver accepted and this orchestrator left the scope, or the failed new tab is closed and ownership remains here.