Merge pull request #13362 from Kilo-Org/fix-wait-background-agents

fix(cli): clarify background Task orchestration

.changeset/clear-background-task-waiting.md

@@ -0,0 +1,5 @@
+---
+"@kilocode/cli": patch
+---
+
+Clarify when to use foreground subagents and wait for required background results before the final answer.

packages/opencode/src/tool/task.ts

@@ -33,8 +33,7 @@ export interface TaskPromptOps {
 const id = "task"
 const BACKGROUND_DESCRIPTION = [
   "Background mode: background=true launches the subagent asynchronously and returns immediately.",
-  "Foreground is the default; use it when you need the result before continuing.",
-  "Use background only for independent work that can run while you continue elsewhere.",
+  "Use foreground when you need the result before proceeding; otherwise use background for non-overlapping work, but do not give the final answer until all required background results have arrived.", // kilocode_change
   "You will be notified automatically when it finishes.",
 ].join(" ")
 const BACKGROUND_STARTED = [