feat: simplify ask_followup_question prompt documentation

[daniel-lxs]

Summary

This PR simplifies the documentation for the ask_followup_question tool to reduce excessive questioning behavior seen with newer models, while keeping the old XML attribute format for backward compatibility.

Changes

Documentation Simplification

• Reduced documentation size by ~60% (from ~45 lines to ~17 lines)
• Simplified description: removed verbose explanations about "interactive problem-solving" and "maintaining balance"
• Streamlined parameter descriptions to be more concise
• Consolidated from 2 examples to 1 focused example
• Removed redundant numbered requirements list

Key Points

• ✅ Uses the OLD XML format with mode as an attribute: <suggest mode="code">...
• ✅ All snapshot tests updated (13 snapshots)
• ✅ No implementation changes - only documentation
• ✅ Maintains full backward compatibility
• ✅ All 3,419 tests passing

Related to PR #6880

This is a companion PR to #6880. The work has been split:

• This PR (#new): Contains only the prompt documentation simplification using the old XML format
• PR feat: update ask_followup_question format to nested XML and simplify tool description and documentation #6880: Contains the XML schema changes (new nested format) and implementation updates

Testing

• Ran full test suite: all tests passing
• Updated all affected snapshot tests
• No functional changes to the tool itself

Impact

This simplified documentation helps prevent newer models from over-using the follow-up question tool while maintaining the exact same functionality for existing implementations.

---

Important

Simplifies ask_followup_question documentation, reducing verbosity while maintaining backward compatibility and updating snapshot tests.

• Documentation Simplification:
  • Reduces ask_followup_question documentation from ~45 lines to ~17 lines in ask-followup-question.ts.
  • Simplifies descriptions by removing verbose explanations and redundant lists.
  • Consolidates examples from 2 to 1.
• Backward Compatibility:
  • Retains old XML format with mode as an attribute.
  • Updates 13 snapshot tests to reflect documentation changes.
• Testing:
  • All 3,419 tests passing, ensuring no functional changes to the tool.

^{This description was created by for 6480c50. You can customize this summary. It will automatically update as commits are pushed.}

[roomote]

Thank you for this excellent simplification! I've reviewed the changes and the documentation reduction is impressive while maintaining full backward compatibility. The changes are well-tested with all 13 snapshots properly updated. I have a couple of minor suggestions that could further improve clarity, but they're not blockers.