lkn
/
ollie
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

prompts: tools-subagent clarify -n vs parallel

This commit is contained in:
Levi Neely 2026-04-20 22:07:06 +02:00
parent b1f723233a
commit 30bc3c8eff
1 changed files with 3 additions and 3 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

6
prompts/tools-subagent.md
View File

@ -2,7 +2,7 @@
Delegate work to one or more specialized agents running concurrently. Each subagent receives the prompt, executes a single job, and returns a result.
**Trigger condition**: a task decomposes into N independent subtasks each requiring multi-step reasoning or multiple tool calls; you are processing N items with the same operation; a subtask is better handled by a different agent (model, backend, or prompt). Use a `{parallel: [...]}` stage in `execute_code` instead when the subtasks are single shell commands — subagents are for agent-level work.
**Trigger condition**: a task decomposes into independent subtasks each requiring multi-step reasoning or multiple tool calls; you are processing N items with the same operation; a subtask is better handled by a different agent (model, backend, or prompt). Use a `{parallel: [...]}` stage in `execute_code` instead when the subtasks have different prompts — subagents are for agent-level work, not single shell commands.
**Calling convention**:
```
@ -11,7 +11,7 @@ execute_code: steps=[{tool: "subagent_spawn", args: ["-n", "N", "-agent", "A", "
| Flag | Default | Description |
|---|---|---|
| `-n N` | 1 | Number of parallel subagents |
| `-n N` | 1 | Number of parallel subagents, all receiving the same prompt (homogeneous fan-out) |
| `-agent A` | server default | Agent config name |
| `-backend B` | server default | Backend override |
| `-model M` | server default | Model override |
@ -31,7 +31,7 @@ Prompt is all remaining arguments after flags.
## Heterogeneous fan-out
To run N subagents with N different prompts, use a `{parallel: [...]}` stage:
To run N subagents with N *different* prompts, use a `{parallel: [...]}` stage. Each entry is an independent `subagent_spawn` call with its own prompt — use this when the subtasks differ:
```
execute_code: steps=[{parallel: [