Skip to content

Conversation

@DS-Controller2
Copy link
Contributor

TLDR

Enhance the usage guidance for the TASK tool in system prompts to encourage agents to proactively break down large, complex tasks into manageable chunks, preventing context window overflow.

Dive Deeper

This PR updates the system prompts and Task tool descriptions to make the agent more proactive about using the TASK tool for large, complex tasks. The changes include:

  • Added explicit instructions to proactively use the TASK tool for large, complex tasks that might fill the context window
  • Enhanced Task Management section with specific guidance on when to use the TASK tool
  • Updated Software Engineering Tasks workflow to encourage proactive TASK tool usage
  • Strengthened Subagent Delegation guidance for context overflow prevention
  • Updated getSubagentSystemReminder to emphasize critical importance of using TASK tool for large tasks
  • Enhanced Task tool description to emphasize breaking down large tasks that might fill the context window
  • Updated usage notes to encourage proactive use for large, complex tasks and context overflow prevention

Reviewer Test Plan

  1. Review the updated system prompts in packages/core/src/core/prompts.ts to ensure they clearly guide the agent to use the TASK tool proactively
  2. Review the updated Task tool description in packages/core/src/tools/task.ts to ensure it emphasizes breaking down large tasks
  3. Run the test suite to ensure all tests pass (npm run test:ci)
  4. Test the changes by using the agent on a complex task that might fill the context window to see if it appropriately uses the TASK tool

Testing Matrix

🍏 🪟 🐧
npm run
npx
Docker
Podman - -
Seatbelt - -

(All testing indicators should be marked as validated after confirming the changes work properly)

Linked issues / bugs

This PR addresses the need to encourage the agent to break down large tasks into manageable chunks using the TASK tool, preventing context window overflow.

The changes have been implemented, tested (with snapshots updated), and committed to the branch. You would now use the GitHub web interface to create the pull request from the task-tool-usage-improvements branch to the main branch.

- Add explicit instructions to proactively use the TASK tool for large, complex tasks that might fill the context window
- Update Task Management section with specific guidance on when to use the TASK tool
- Enhance Software Engineering Tasks workflow to encourage proactive TASK tool usage
- Strengthen Subagent Delegation guidance for context overflow prevention
- Update getSubagentSystemReminder to emphasize critical importance of using TASK tool for large tasks
- Enhance Task tool description to emphasize breaking down large tasks that might fill the context window
- Update usage notes to encourage proactive use for large, complex tasks and context overflow prevention

This addresses the need to encourage the agent to break down large tasks into manageable chunks using the TASK tool, preventing context window overflow.

Fixes #000

Co-authored-by: Qwen-Coder <[email protected]>

The changes refine the usage of the Task tool to encourage agents to break down large tasks into manageable chunks, preventing context window overflow. The updates enhance both system prompts and tool descriptions to emphasize proactive use of the TASK tool for complex tasks that might overwhelm the agent's context window.
DS-Controller2 and others added 2 commits October 5, 2025 14:37
The CI was failing on Windows due to inconsistent line ending handling in
integration-tests/test-helper.ts. The code was splitting content using the
platform-specific EOL constant but then joining content back using hardcoded
\n instead of the platform-appropriate EOL.

This fix ensures consistent line ending handling across platforms by using
the EOL constant for both splitting and joining operations.

Co-authored-by: Qwen-Coder <[email protected]>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant