--- description: "A lead hands one of its members a work order: the member does the work (build, write, fix, commit) in its own Herdr pane under its own autonomy, asks the lead its questions, and hands back for review. Use /agents:delegate \"\" from inside the lead's session. Requires Herdr (HERDR_ENV=1) and lead: in the member's context.md." allowed-tools: Read, Write, Edit, Glob, Grep, Bash(date), Bash(echo:*), Bash(pwd), Bash(mkdir:*), Bash(herdr agent list:*), Bash(herdr agent start:*), Bash(herdr agent prompt:*), Bash(herdr agent read:*), Bash(herdr agent get:*), Bash(herdr agent wait:*), Bash(herdr pane split:*), Bash(herdr pane rename:*), Bash(herdr pane layout:*), Bash(herdr pane close:*) argument-hint: "" --- # /agents:delegate — Delegated Task You are a **lead**. You hand one of your members a work order for an outcome the principal approved; the member does the work in its own pane, under its own autonomy. The full protocol is `${CLAUDE_PLUGIN_ROOT}/template/agents/reference/task.md` (if the variable is empty: `$AGENT_FRAMEWORK_ROOT/template/agents/reference/task.md`, or the framework root a wrapper skill named; else glob `~/.claude/plugins/cache/*/agents/*/template/agents/reference/task.md`, highest version). Read it once, then follow it. For a question or a review without work, use `/agents:ask` instead. ## Preconditions (refuse with one line if any fails) Run **all** of them before writing any file or opening any pane. A refused delegation leaves nothing behind. 1. Run `echo "$HERDR_ENV $HERDR_PANE_ID"`. `HERDR_ENV` must be `1` and `HERDR_PANE_ID` set. Otherwise: `Not inside Herdr — /agents:delegate needs a Herdr pane.` 2. Workspace root = current working directory; it must contain `agents/`. Caller = the agent active in this session. No agent active → `Only a lead can delegate; start one with /agents:start .` 3. Target: glob `agents//context.md` or `agents/*//context.md` (case-insensitive). Missing or `status: retired` → say so. Its frontmatter `lead:` must equal the caller (case-insensitive) → otherwise ` does not report to (no lead: in its context.md).` Never look outside this root. 4. Run `herdr agent list` now and check `.result.agents[]`: if any entry whose `cwd` is under this root has `name` ``, `-peer` or `-task` (lowercase), refuse: ` is live in pane ; one session per agent. Ask the principal to wrap it, then delegate again.` Do not offer to issue it anyway and never close that pane yourself: only the principal ends another session. Re-run this check when you delegate again. 5. Count work orders in flight: files `agents/*/peer/*.md` (and `agents/*/*/peer/*.md`) with `type: task`, `from: `, and status `open`, `working`, `question` or `review`. Limit = `task-limit:` in `agents/CONVENTIONS.md` frontmatter, default 3. At the limit → ` has tasks in flight (limit ); finish or stop one first.` 6. Outcome: the approved outcome this work serves has an outcome file (`agents//outcomes/.md`, task.md § 2). If the principal approved it in this session and there is no file yet, write it first. If nothing was approved, ask the principal and stop. 7. Size: the work order fits one of the member's sessions with room to wrap (task.md § 4). If it does not, split it and delegate the first part. 8. Harness and model for the target, exactly as `/agents:ask` precondition 4: `harness:` from the target's `context.md`, else `agents/CONVENTIONS.md`, else `claude`; `model:` the same way. Start command: `claude`/`gemini` → `/agents:start`; `codex` → `$agents-start`; `opencode`/`pi`/`cursor` → `/agents-start`. ## Steps 1. `date` → stamp `YYYY-MM-DD-HHMM`. `mkdir -p agents//peer`. Write `agents//peer/-task-from-.md` with the frontmatter from task.md § 4 (`type: task`, `status: open`, `outcome:` (the outcome file path and one line), `lead_pane: $HERDR_PANE_ID`, `rounds: 0`, `timebox:` from `task-timebox:` in `agents/CONVENTIONS.md` frontmatter (default `4h`; longer only if the principal set it in the outcome), and `due:` = now + timebox as `YYYY-MM-DD HH:MM`) and a self-contained `## Work order`: deliverable, acceptance criteria, every path/ticket/branch/ID, out of scope, who else is involved. End with an empty `## Log`. 2. `herdr pane layout --pane "$HERDR_PANE_ID"` → wide → `right`, tall → `down`. `herdr pane split --current --direction --cwd "$PWD" --no-focus` → read `.result.pane.pane_id`. Write it into `task_pane:`. 3. `herdr pane rename " - Task"`. 4. `herdr agent start -task --kind --pane -- ` (same agent args as `/agents:ask` step 4; leave off ` --` when there are none). On `agent_not_ready`, wait once with `herdr agent get`; still blocked → read the pane, tell the principal, stop. 5. `herdr agent prompt -task " task agents//peer/"` — **no `--wait`**: the task can run for hours. Then `herdr agent wait -task --until working --timeout 60000`: a fresh pane starts idle, so a watch armed before it is working wakes at once. 6. Start watching in the background: `herdr agent wait -task --until idle --until done --until blocked` (Claude Code: Bash with `run_in_background`; other harnesses: check back with `herdr agent get -task` when the principal next speaks). Each time it wakes and the work order is still `working` while the pane is working again, re-arm it. 7. Add the work order to the outcome file's Plan. Tell the principal in two lines: what was delegated to whom, and the work order path. When the wait returns, run `date`, and follow task.md § 6 (Watching, Answering, Stopping): past `due:` means stop and bring it to the principal; 5 `rounds` (answers plus rejected hand-backs) means stop answering and bring it to the principal. ## Rules - One work order per call; one task per member at a time. - Never edit the member's files, worktree or tracker. Direct through the work order. - Never answer a task pane's permission prompt; tell the principal. - Do not commit here. The work orders you wrote or answered are staged at your session end (task.md § 6).