From 9f7b4e49815a0a4a5c534b085021997d1523a429 Mon Sep 17 00:00:00 2001 From: marius-kilocode Date: Mon, 24 Aug 2026 13:45:04 +0200 Subject: [PATCH] fix(cli): clarify background task orchestration --- .changeset/clear-background-task-waiting.md | 5 +++++ packages/opencode/src/tool/task.ts | 3 +-- 2 files changed, 6 insertions(+), 2 deletions(-) create mode 100644 .changeset/clear-background-task-waiting.md 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 = [