From 2b8228ef0c1459692798afae3f38f806d80f9d7d Mon Sep 17 00:00:00 2001 From: Hannes Rudolph Date: Tue, 22 Jul 2025 15:37:27 -0600 Subject: [PATCH] docs: clarify when to use update_todo_list tool (#5926) * docs: clarify when to use update_todo_list tool Added 'complicated' to the condition for when to use the update_todo_list tool, making it clearer that the tool should be used for tasks that are either complicated OR involve multiple steps. * fix: update vscode mock and snapshots for update_todo_list tool changes - Add missing RelativePattern export to vscode mock - Fix onDidChangeWorkspaceFolders function in workspace mock - Update test snapshots to reflect new "complicated" text in update_todo_list tool documentation - Build tree-sitter WASM files to fix parsing tests Fixes failing CI tests related to PR #5926 documentation changes. * Delete package-lock.json * revert: remove unrelated changes to src/__mocks__/vscode.js --------- Co-authored-by: Roo Code Co-authored-by: Daniel <57051444+daniel-lxs@users.noreply.github.com> --- .../add-custom-instructions/architect-mode-prompt.snap | 2 +- .../__snapshots__/add-custom-instructions/ask-mode-prompt.snap | 2 +- .../add-custom-instructions/mcp-server-creation-disabled.snap | 2 +- .../add-custom-instructions/mcp-server-creation-enabled.snap | 2 +- .../add-custom-instructions/partial-reads-enabled.snap | 2 +- .../__snapshots__/system-prompt/consistent-system-prompt.snap | 2 +- .../__snapshots__/system-prompt/with-computer-use-support.snap | 2 +- .../__snapshots__/system-prompt/with-diff-enabled-false.snap | 2 +- .../__snapshots__/system-prompt/with-diff-enabled-true.snap | 2 +- .../system-prompt/with-diff-enabled-undefined.snap | 2 +- .../system-prompt/with-different-viewport-size.snap | 2 +- .../__snapshots__/system-prompt/with-mcp-hub-provided.snap | 2 +- .../__snapshots__/system-prompt/with-undefined-mcp-hub.snap | 2 +- src/core/prompts/tools/update-todo-list.ts | 2 +- 14 files changed, 14 insertions(+), 14 deletions(-) diff --git a/src/core/prompts/__tests__/__snapshots__/add-custom-instructions/architect-mode-prompt.snap b/src/core/prompts/__tests__/__snapshots__/add-custom-instructions/architect-mode-prompt.snap index 273e43d20b..632273dea0 100644 --- a/src/core/prompts/__tests__/__snapshots__/add-custom-instructions/architect-mode-prompt.snap +++ b/src/core/prompts/__tests__/__snapshots__/add-custom-instructions/architect-mode-prompt.snap @@ -420,7 +420,7 @@ Replace the entire TODO list with an updated checklist reflecting the current st **When to Use:** -- The task involves multiple steps or requires ongoing tracking. +- The task is complicated or involves multiple steps or requires ongoing tracking. - You need to update the status of several todos at once. - New actionable items are discovered during task execution. - The user requests a todo list or provides multiple tasks. diff --git a/src/core/prompts/__tests__/__snapshots__/add-custom-instructions/ask-mode-prompt.snap b/src/core/prompts/__tests__/__snapshots__/add-custom-instructions/ask-mode-prompt.snap index a169a1f3af..09b6b04348 100644 --- a/src/core/prompts/__tests__/__snapshots__/add-custom-instructions/ask-mode-prompt.snap +++ b/src/core/prompts/__tests__/__snapshots__/add-custom-instructions/ask-mode-prompt.snap @@ -317,7 +317,7 @@ Replace the entire TODO list with an updated checklist reflecting the current st **When to Use:** -- The task involves multiple steps or requires ongoing tracking. +- The task is complicated or involves multiple steps or requires ongoing tracking. - You need to update the status of several todos at once. - New actionable items are discovered during task execution. - The user requests a todo list or provides multiple tasks. diff --git a/src/core/prompts/__tests__/__snapshots__/add-custom-instructions/mcp-server-creation-disabled.snap b/src/core/prompts/__tests__/__snapshots__/add-custom-instructions/mcp-server-creation-disabled.snap index 273e43d20b..632273dea0 100644 --- a/src/core/prompts/__tests__/__snapshots__/add-custom-instructions/mcp-server-creation-disabled.snap +++ b/src/core/prompts/__tests__/__snapshots__/add-custom-instructions/mcp-server-creation-disabled.snap @@ -420,7 +420,7 @@ Replace the entire TODO list with an updated checklist reflecting the current st **When to Use:** -- The task involves multiple steps or requires ongoing tracking. +- The task is complicated or involves multiple steps or requires ongoing tracking. - You need to update the status of several todos at once. - New actionable items are discovered during task execution. - The user requests a todo list or provides multiple tasks. diff --git a/src/core/prompts/__tests__/__snapshots__/add-custom-instructions/mcp-server-creation-enabled.snap b/src/core/prompts/__tests__/__snapshots__/add-custom-instructions/mcp-server-creation-enabled.snap index 8e1b90a1cf..7ca32b80a1 100644 --- a/src/core/prompts/__tests__/__snapshots__/add-custom-instructions/mcp-server-creation-enabled.snap +++ b/src/core/prompts/__tests__/__snapshots__/add-custom-instructions/mcp-server-creation-enabled.snap @@ -469,7 +469,7 @@ Replace the entire TODO list with an updated checklist reflecting the current st **When to Use:** -- The task involves multiple steps or requires ongoing tracking. +- The task is complicated or involves multiple steps or requires ongoing tracking. - You need to update the status of several todos at once. - New actionable items are discovered during task execution. - The user requests a todo list or provides multiple tasks. diff --git a/src/core/prompts/__tests__/__snapshots__/add-custom-instructions/partial-reads-enabled.snap b/src/core/prompts/__tests__/__snapshots__/add-custom-instructions/partial-reads-enabled.snap index 7ee1ab207f..7dce6219f3 100644 --- a/src/core/prompts/__tests__/__snapshots__/add-custom-instructions/partial-reads-enabled.snap +++ b/src/core/prompts/__tests__/__snapshots__/add-custom-instructions/partial-reads-enabled.snap @@ -425,7 +425,7 @@ Replace the entire TODO list with an updated checklist reflecting the current st **When to Use:** -- The task involves multiple steps or requires ongoing tracking. +- The task is complicated or involves multiple steps or requires ongoing tracking. - You need to update the status of several todos at once. - New actionable items are discovered during task execution. - The user requests a todo list or provides multiple tasks. diff --git a/src/core/prompts/__tests__/__snapshots__/system-prompt/consistent-system-prompt.snap b/src/core/prompts/__tests__/__snapshots__/system-prompt/consistent-system-prompt.snap index 273e43d20b..632273dea0 100644 --- a/src/core/prompts/__tests__/__snapshots__/system-prompt/consistent-system-prompt.snap +++ b/src/core/prompts/__tests__/__snapshots__/system-prompt/consistent-system-prompt.snap @@ -420,7 +420,7 @@ Replace the entire TODO list with an updated checklist reflecting the current st **When to Use:** -- The task involves multiple steps or requires ongoing tracking. +- The task is complicated or involves multiple steps or requires ongoing tracking. - You need to update the status of several todos at once. - New actionable items are discovered during task execution. - The user requests a todo list or provides multiple tasks. diff --git a/src/core/prompts/__tests__/__snapshots__/system-prompt/with-computer-use-support.snap b/src/core/prompts/__tests__/__snapshots__/system-prompt/with-computer-use-support.snap index e23dc220b4..419049609e 100644 --- a/src/core/prompts/__tests__/__snapshots__/system-prompt/with-computer-use-support.snap +++ b/src/core/prompts/__tests__/__snapshots__/system-prompt/with-computer-use-support.snap @@ -473,7 +473,7 @@ Replace the entire TODO list with an updated checklist reflecting the current st **When to Use:** -- The task involves multiple steps or requires ongoing tracking. +- The task is complicated or involves multiple steps or requires ongoing tracking. - You need to update the status of several todos at once. - New actionable items are discovered during task execution. - The user requests a todo list or provides multiple tasks. diff --git a/src/core/prompts/__tests__/__snapshots__/system-prompt/with-diff-enabled-false.snap b/src/core/prompts/__tests__/__snapshots__/system-prompt/with-diff-enabled-false.snap index 273e43d20b..632273dea0 100644 --- a/src/core/prompts/__tests__/__snapshots__/system-prompt/with-diff-enabled-false.snap +++ b/src/core/prompts/__tests__/__snapshots__/system-prompt/with-diff-enabled-false.snap @@ -420,7 +420,7 @@ Replace the entire TODO list with an updated checklist reflecting the current st **When to Use:** -- The task involves multiple steps or requires ongoing tracking. +- The task is complicated or involves multiple steps or requires ongoing tracking. - You need to update the status of several todos at once. - New actionable items are discovered during task execution. - The user requests a todo list or provides multiple tasks. diff --git a/src/core/prompts/__tests__/__snapshots__/system-prompt/with-diff-enabled-true.snap b/src/core/prompts/__tests__/__snapshots__/system-prompt/with-diff-enabled-true.snap index ad90a58850..4390b95519 100644 --- a/src/core/prompts/__tests__/__snapshots__/system-prompt/with-diff-enabled-true.snap +++ b/src/core/prompts/__tests__/__snapshots__/system-prompt/with-diff-enabled-true.snap @@ -508,7 +508,7 @@ Replace the entire TODO list with an updated checklist reflecting the current st **When to Use:** -- The task involves multiple steps or requires ongoing tracking. +- The task is complicated or involves multiple steps or requires ongoing tracking. - You need to update the status of several todos at once. - New actionable items are discovered during task execution. - The user requests a todo list or provides multiple tasks. diff --git a/src/core/prompts/__tests__/__snapshots__/system-prompt/with-diff-enabled-undefined.snap b/src/core/prompts/__tests__/__snapshots__/system-prompt/with-diff-enabled-undefined.snap index 273e43d20b..632273dea0 100644 --- a/src/core/prompts/__tests__/__snapshots__/system-prompt/with-diff-enabled-undefined.snap +++ b/src/core/prompts/__tests__/__snapshots__/system-prompt/with-diff-enabled-undefined.snap @@ -420,7 +420,7 @@ Replace the entire TODO list with an updated checklist reflecting the current st **When to Use:** -- The task involves multiple steps or requires ongoing tracking. +- The task is complicated or involves multiple steps or requires ongoing tracking. - You need to update the status of several todos at once. - New actionable items are discovered during task execution. - The user requests a todo list or provides multiple tasks. diff --git a/src/core/prompts/__tests__/__snapshots__/system-prompt/with-different-viewport-size.snap b/src/core/prompts/__tests__/__snapshots__/system-prompt/with-different-viewport-size.snap index 005813848f..191816f180 100644 --- a/src/core/prompts/__tests__/__snapshots__/system-prompt/with-different-viewport-size.snap +++ b/src/core/prompts/__tests__/__snapshots__/system-prompt/with-different-viewport-size.snap @@ -473,7 +473,7 @@ Replace the entire TODO list with an updated checklist reflecting the current st **When to Use:** -- The task involves multiple steps or requires ongoing tracking. +- The task is complicated or involves multiple steps or requires ongoing tracking. - You need to update the status of several todos at once. - New actionable items are discovered during task execution. - The user requests a todo list or provides multiple tasks. diff --git a/src/core/prompts/__tests__/__snapshots__/system-prompt/with-mcp-hub-provided.snap b/src/core/prompts/__tests__/__snapshots__/system-prompt/with-mcp-hub-provided.snap index 8e1b90a1cf..7ca32b80a1 100644 --- a/src/core/prompts/__tests__/__snapshots__/system-prompt/with-mcp-hub-provided.snap +++ b/src/core/prompts/__tests__/__snapshots__/system-prompt/with-mcp-hub-provided.snap @@ -469,7 +469,7 @@ Replace the entire TODO list with an updated checklist reflecting the current st **When to Use:** -- The task involves multiple steps or requires ongoing tracking. +- The task is complicated or involves multiple steps or requires ongoing tracking. - You need to update the status of several todos at once. - New actionable items are discovered during task execution. - The user requests a todo list or provides multiple tasks. diff --git a/src/core/prompts/__tests__/__snapshots__/system-prompt/with-undefined-mcp-hub.snap b/src/core/prompts/__tests__/__snapshots__/system-prompt/with-undefined-mcp-hub.snap index 273e43d20b..632273dea0 100644 --- a/src/core/prompts/__tests__/__snapshots__/system-prompt/with-undefined-mcp-hub.snap +++ b/src/core/prompts/__tests__/__snapshots__/system-prompt/with-undefined-mcp-hub.snap @@ -420,7 +420,7 @@ Replace the entire TODO list with an updated checklist reflecting the current st **When to Use:** -- The task involves multiple steps or requires ongoing tracking. +- The task is complicated or involves multiple steps or requires ongoing tracking. - You need to update the status of several todos at once. - New actionable items are discovered during task execution. - The user requests a todo list or provides multiple tasks. diff --git a/src/core/prompts/tools/update-todo-list.ts b/src/core/prompts/tools/update-todo-list.ts index 528d5a1b51..30100617df 100644 --- a/src/core/prompts/tools/update-todo-list.ts +++ b/src/core/prompts/tools/update-todo-list.ts @@ -56,7 +56,7 @@ Replace the entire TODO list with an updated checklist reflecting the current st **When to Use:** -- The task involves multiple steps or requires ongoing tracking. +- The task is complicated or involves multiple steps or requires ongoing tracking. - You need to update the status of several todos at once. - New actionable items are discovered during task execution. - The user requests a todo list or provides multiple tasks.