diff --git a/.changeset/clear-background-task-waiting.md b/.changeset/clear-background-task-waiting.md new file mode 100644 index 00000000000..5274ab6946d --- /dev/null +++ b/.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. diff --git a/packages/opencode/src/tool/task.ts b/packages/opencode/src/tool/task.ts index 5ac1aef14e6..ee9f4d1b3fe 100644 --- a/packages/opencode/src/tool/task.ts +++ b/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 = [