diff --git a/skill-guides/orchestration.md b/skill-guides/orchestration.md index a6474b11def..5bbd45980a5 100644 --- a/skill-guides/orchestration.md +++ b/skill-guides/orchestration.md @@ -38,9 +38,10 @@ ORCA orchestration worker-start --spec "" --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: --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 ` 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 --no-parent --agent --prompt "" --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`. diff --git a/src/cli/bundled-skill-guides.ts b/src/cli/bundled-skill-guides.ts index d4fd23ab57b..9a7efccd7bb 100644 --- a/src/cli/bundled-skill-guides.ts +++ b/src/cli/bundled-skill-guides.ts @@ -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: --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 ` 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 --no-parent --agent --prompt \"\" --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`.",