diff --git a/docs/tools/subagent.md b/docs/tools/subagent.md index 678d7d72..3c1ae1db 100644 --- a/docs/tools/subagent.md +++ b/docs/tools/subagent.md @@ -90,7 +90,7 @@ daemon only ever spawns on that agent's behalf. role.** A task baked into the system prompt re-asserts itself as an instruction on every later turn of the session (`continue`, `goal`), not just the one the caller wrote it for — the system prompt is the -subagent's standing identity, not a one-shot channel. So the daemon always +subagent's standing identity, not a one-shot channel, so the daemon always reads the task instructions (`prompt_file`) and folds them ahead of the turn's own prompt instead, whether or not the session has a role. The caller's own task file stays untouched either way. @@ -98,8 +98,9 @@ caller's own task file stays untouched either way. A role additionally names a standing identity: its text, alone, becomes a per-session file under the harness directory, and `--append-system-prompt-file` points at that — nothing about the task ever reaches it. Without a role -there is no such identity to hold a file open for, so `--append-system-prompt-file` -is omitted altogether rather than pointed at anything task-shaped. +there is no such identity to hold a file open for, so the daemon omits +`--append-system-prompt-file` altogether rather than pointing it at +anything task-shaped. ⚠️ This applies to every dispatch, not just role-bearing ones — no agent ships roles yet, so today it's the only path in real use. Before this fix