🤖 Agent & Model Selection UX

[vasconceloscezar]

Summary

Improve how users understand, select, and switch between agents and LLM models. Feedback indicates confusion about agent purposes and friction in switching modes.

Problems Identified

1. Agent Differentiation Unclear

Current: Different agents available but users don't know when to use which.
Impact: Feature goes unused, suboptimal agent selection.

Solution:

• Clear descriptions for each agent type
• "Suggested for" hints based on task context
• Agent comparison guide in docs/help
• Tooltips explaining agent strengths

2. No AGUI/Select Tool Support

Current: Claude Code has AGUI select tool for planning, Forge doesn't.
Impact: Users can't get same planning assistance.

Solution:

• Implement equivalent interactive selection UI
• Visual tool for exploring options during planning
• Integration with task creation flow

3. Plan Mode ↔ Bypass Toggle Friction

Current: Switching modes requires manually changing task agent.
Impact: Extra clicks, interrupts flow.

Claude Code: One-button toggle between modes.

Solution:

• Quick toggle button in chat header
• Keyboard shortcut for mode switch
• Visual indicator of current mode
• Persist mode preference

4. Can't Change Model Mid-Chat

Current: Model selection locked once chat starts.
Impact: Can't switch to different model for specific subtasks.

Solution:

• Model dropdown accessible during chat
• "Switch model for next message" option
• Warning if switching may affect context
• Show which model generated each response

5. Agent Selection UI Improvements

Current: Basic dropdown for agent selection.

Solution:

• Richer agent selector with icons and descriptions
• Recently used agents at top
• Favorites/pinned agents
• Search/filter for many agents

Acceptance Criteria

• Each agent has clear description and use-case hints
• Plan/bypass mode toggle is one click
• Model can be changed during active chat
• Agent selector shows meaningful information
• Current mode/model always visible

Technical Notes

Components:

• Enhanced agent selector dropdown
• Mode toggle button component
• Model switcher in chat header
• Agent info tooltips/popovers

State:

• Track current mode per task
• Model selection history
• Agent preferences

Team Feedback Sources

• Feedback 3: Agent utility unclear
• Feedback 5: AGUI, plan mode toggle
• Feedback 6: Model switching mid-chat

Priority

🟢 P2 - Medium (usability improvement, not blocking)