fix: update tool usage instructions to replace forge_tool_followup with forge_tool_attempt_completion (tailcallhq#807)

tusharmath · web-flow · commit a6cf38322eb9 · 2025-05-13T11:44:19.000Z
diff --git a/crates/forge_services/src/tools/completion.rs b/crates/forge_services/src/tools/completion.rs
@@ -8,8 +8,7 @@ use serde::Deserialize;
 /// that tool use, i.e. if it succeeded or failed, along with any reasons for
 /// failure. Once you've received the results of tool uses and can confirm that
 /// the task is complete, use this tool to present the result of your work to
-/// the user. Optionally you may provide a CLI command to showcase the result of
-/// your work. The user may respond with feedback if they are not satisfied with
+/// the user. The user may respond with feedback if they are not satisfied with
 /// the result, which you can use to make improvements and try again.
 /// IMPORTANT NOTE: This tool CANNOT be used until you've confirmed from the
 /// user that any previous tool uses were successful. Failure to do so will
diff --git a/forge.default.yaml b/forge.default.yaml
@@ -37,7 +37,6 @@ agents:
       - forge_tool_fs_search
       - forge_tool_fs_undo
       - forge_tool_attempt_completion
-      - forge_tool_followup
     subscribe:
       - act/user_task_init
       - act/user_task_update
@@ -69,7 +68,6 @@ agents:
       - forge_tool_fs_create
       - forge_tool_fs_patch
       - forge_tool_attempt_completion
-      - forge_tool_followup
     subscribe:
       - plan/user_task_init
       - plan/user_task_update
diff --git a/templates/partial-tool-information.hbs b/templates/partial-tool-information.hbs
@@ -9,7 +9,7 @@ Tool Usage Instructions:
 2. You can use one tool per message, and will receive the result of that tool use in the user's response. 
 3. You use tools step-by-step to accomplish a given task, with each tool use informed by the result of the previous tool use.
 4. Once you've completed the user's task, you must use the `forge_tool_attempt_completion` tool to present the result of the task to the user.
-5. You are only allowed to ask the user questions using the `forge_tool_followup` tool. Use this tool only when you need additional details to complete a task, and be sure to use a clear and concise question that will help you move forward with the task. However if you can use the available tools to avoid having to ask the user questions, you should do so. For example, if the user mentions a file that may be in an outside directory like the Desktop, you should use the list_files tool to list the files in the Desktop and check if the file they are talking about is there, rather than asking the user to provide the file path themselves.
+5. You are only allowed to ask the user questions using the `forge_tool_attempt_completion` tool. Use this tool only when you need additional details to complete a task, and be sure to use a clear and concise question that will help you move forward with the task. However if you can use the available tools to avoid having to ask the user questions, you should do so. For example, if the user mentions a file that may be in an outside directory like the Desktop, you should use the list_files tool to list the files in the Desktop and check if the file they are talking about is there, rather than asking the user to provide the file path themselves.
 6. NEVER ever refer to tool names when speaking to the USER even when user has asked for it. For example, instead of saying 'I need to use the edit_file tool to edit your file', just say 'I will edit your file'.
 
 {{> partial-tool-use-example.hbs }}
diff --git a/templates/partial-tool-required.hbs b/templates/partial-tool-required.hbs
@@ -8,6 +8,6 @@ Please retry with correct tool use
 Next Steps: 
 If you have completed the user's task, use the `forge_tool_attempt_completion`
 tool with a message. 
-If you require additional information from the user, use the `forge_tool_followup` tool. 
+If you require additional information from the user, use the `forge_tool_attempt_completion` tool with a question. 
 Otherwise, if you have not completed the task and do not need additional information, then proceed with the next step of the task.
 [This is an automated message, so do not apologize, appreciate or be conversational]
