Orchestration guide: hand off when nothing needs to come back (#36833)

This commit is contained in:
Jinwoo Hong
2026-10-31 21:17:27 -04:00
committed by GitHub
parent f9fe915843
commit 5fd6815de1
2 changed files with 8 additions and 6 deletions
+4 -3
View File
@@ -38,9 +38,10 @@ ORCA orchestration worker-start --spec "<task>" --worktree current --agent codex
- `--worktree current` uses your workspace. Use a new one only when the user
asks or sharing would conflict:
`--worktree new-top-level --repo id:<repoId> --name <short-name>`
(`ORCA repo list --json` gives the id). A worker in a new workspace stays open
after it reports; if the user won't use that chat, run
`ORCA orchestration worker-release --dispatch <dispatch_id>` once it reports.
(`ORCA repo list --json` gives the id). If nothing needs to come back to you
(the user will work in those chats), don't start workers; per workspace run
`ORCA worktree create --name <name> --no-parent --agent <agent> --prompt "<brief>" --json`
and end your turn.
- Add `--model` only if the user named one.
- If `worker-start` fails, do not rerun it; read `failedStage` and load
`references/recovery-and-cleanup.md`.
+4 -3
View File
@@ -2516,9 +2516,10 @@ const ORCHESTRATION_MARKDOWN = [
"- `--worktree current` uses your workspace. Use a new one only when the user",
" asks or sharing would conflict:",
" `--worktree new-top-level --repo id:<repoId> --name <short-name>`",
" (`ORCA repo list --json` gives the id). A worker in a new workspace stays open",
" after it reports; if the user won't use that chat, run",
" `ORCA orchestration worker-release --dispatch <dispatch_id>` once it reports.",
" (`ORCA repo list --json` gives the id). If nothing needs to come back to you",
" (the user will work in those chats), don't start workers; per workspace run",
" `ORCA worktree create --name <name> --no-parent --agent <agent> --prompt \"<brief>\" --json`",
" and end your turn.",
"- Add `--model` only if the user named one.",
"- If `worker-start` fails, do not rerun it; read `failedStage` and load",
" `references/recovery-and-cleanup.md`.",