02_Initial_Interaction - jezweb/roo-commander GitHub Wiki
When you first activate the π Roo Commander mode in the Roo Code chat interface, or sometimes when your initial request is broad, Roo Commander will present you with a standard set of starting options.
This guide explains the purpose of this initial interaction and what happens when you select one of the options. The goal is to help you quickly direct Roo Commander towards the most relevant workflow for your immediate needs.
You'll typically see a prompt similar to this:
<ask_followup_question>
<question>Welcome to Roo Commander v7 (Wallaby)! How can I assist you today?</question>
<follow_up>
<suggest>π Install/Manage MCP Servers</suggest> <!-- Option 0 -->
<suggest>π© Start a NEW project from scratch</suggest> <!-- Option 1 -->
<suggest>π Analyze/Onboard the CURRENT project workspace</suggest> <!-- Option 2 -->
<suggest>π Clone a Git repository & onboard</suggest> <!-- Option 3 -->
<suggest>ποΈ Use existing project files/plans to define the work</suggest> <!-- Option 4 -->
<suggest>π Plan/Design a new feature or project</suggest> <!-- Option 5 -->
<suggest>π Fix a specific bug</suggest> <!-- Option 6 -->
<suggest>β»οΈ Refactor or improve existing code</suggest> <!-- Option 7 -->
<suggest>βοΈ Write or update documentation</suggest> <!-- Option 8 -->
<suggest>π Review project status / Manage tasks (MDTM)</suggest> <!-- Option 9 -->
<suggest>β Research a topic / Ask a technical question</suggest> <!-- Option 10 -->
<suggest>πΊ Execute a command / Delegate a specific known task</suggest> <!-- Option 11 -->
<suggest>πͺ Manage Roo Configuration (Advanced)</suggest> <!-- Option 12 -->
<suggest>π²οΈ Update my preferences / profile</suggest> <!-- Option 13 -->
<suggest>π¦ Learn about Roo Commander capabilities</suggest> <!-- Option 14 -->
<suggest>πΎ Join the Roo Commander Community (Discord)</suggest> <!-- Option 15 -->
<suggest>π€ Something else... (Describe your goal)</suggest> <!-- Option 16 -->
<suggest>π§βπ¨ Mode Management</suggest> <!-- Option 17 -->
</follow_up>
</ask_followup_question>
Purpose: Instead of trying to guess your exact intent from a potentially vague initial prompt (like "Help me with my project"), Roo Commander presents these common starting points. Each option acts as a shortcut to a specific, predefined workflow designed for that common scenario.
This structured approach helps Roo Commander:
- Clarify Intent: Quickly understand your primary goal.
- Activate Correct Workflow: Initiate the most relevant sequence of actions and delegate to the right specialist modes from the start.
- Save Time: Avoid lengthy back-and-forth clarification dialogues for common starting tasks.
This initial interaction is governed by a specific rule: .roo/rules-roo-commander/02-initialization-workflow-rule.md
.
When you select an option (e.g., "π Fix a specific bug"), this rule instructs Roo Commander to execute a detailed procedure defined in a corresponding Knowledge Base (KB) file located within .ruru/modes/roo-commander/kb/initial-actions/
.
-
Example: Selecting Option 6 ("π Fix a specific bug") triggers the execution of the procedure defined in
.ruru/modes/roo-commander/kb/initial-actions/06-fix-bug.md
. This KB file tells Commander to ask you for bug details and then delegate the task to thedev-fixer
mode.
Each option (0-16, plus Mode Management) has a corresponding KB file in the initial-actions
directory that outlines the specific steps Commander will take, including any necessary user prompts or delegations to other modes.
If your goal doesn't neatly fit into the predefined options, choose "π€ Something else... (Describe your goal)". This will prompt you to provide a more detailed description. Roo Commander will then analyze your description and attempt to route you to the most appropriate workflow or specialist mode, potentially falling back to its general coordination capabilities if the goal is complex or unique.
The initial prompt with its multiple options is a core part of Roo Commander's strategy for efficient workflow initiation. By selecting the option that best matches your immediate goal, you help Commander quickly understand your intent and activate the most relevant procedures and specialist modes, streamlining the start of your development task.