docs(orchestration): never pick a worker model the user did not name

The sonnet examples were added for a test cohort. Orchestration must not
choose a model on the user's behalf: pass --model only when the user named
one, otherwise inherit the configured agent default.
This commit is contained in:
Jinwoo-H
2026-09-06 14:49:09 -04:00
parent ebaa01e42c
commit 5ac65cbf0e
3 changed files with 7 additions and 8 deletions
+1 -1
View File
@@ -104,7 +104,7 @@ waiting. `worker-start --spec` creates the Task and its attempt in one call:
ORCA status --json
ORCA orchestration run-create --objective "<objective>" --json
ORCA orchestration worker-start --spec "<worker A task>" --worktree current --agent codex --json
ORCA orchestration worker-start --spec "<worker B task>" --worktree current --agent claude --model sonnet --json
ORCA orchestration worker-start --spec "<worker B task>" --worktree current --agent claude --json
ORCA orchestration check --wait --types "worker_done,escalation,question" --timeout-ms 900000 --json
```
@@ -22,12 +22,11 @@ when an older CLI rejects the flag. A nested worker must respect
## Launch preferences
For a fresh Claude, Codex, or Cursor terminal, `--model` accepts an opaque
provider model ID. Pick the cheapest model that fits the Task (`sonnet` for
routine work); an omitted model inherits the launcher's default, often the most
expensive. Add `--effort` only when that model supports it:
provider model ID. Pass it only when the user named a model; otherwise omit it
so the worker inherits the user's configured agent default. Add `--effort` only
when that model supports it:
```text
ORCA orchestration worker-start --task <task_id> --worktree current --agent claude --model sonnet --json
ORCA orchestration worker-start --task <task_id> --worktree current --agent claude --model opus --effort high --json
```
File diff suppressed because one or more lines are too long