Collab Sessions

Entry point for collab workflow. Handles session management and delegates to MCP state machine.

Step 1: Check Server

Tool: mcp__plugin_mermaid-collab_mermaid__check_server_health
Args: {}

If not healthy: "Server not running. Start with: bun run bin/mermaid-collab.ts start" STOP if server not running.

Step 2: Find/Create Session

List sessions for this project:

Tool: mcp__plugin_mermaid-collab_mermaid__list_sessions
Args: {}

If sessions exist: Present list with "Create new" option If no sessions: Go to Step 3

Step 3: Create New Session

1. Generate name:

   mcp__plugin_mermaid-collab_mermaid__generate_session_name()

2. Ask user to confirm or pick own name
3. Initialize state:

   Tool: mcp__plugin_mermaid-collab_mermaid__update_session_state
   Args: { "project": "<cwd>", "session": "<name>", "phase": "brainstorming", "currentItem": null }
   

4. Get first skill from state machine:

   Tool: mcp__plugin_mermaid-collab_mermaid__complete_skill
   Args: { "project": "<cwd>", "session": "<name>", "skill": "collab-start" }
   

5. Invoke: result.next_skill

Step 4: Resume Existing Session

1. Get session state:

   mcp__plugin_mermaid-collab_mermaid__get_session_state()

2. Check for snapshot:
   • If snapshot exists: Load it, delete it, invoke snapshot.activeSkill
   • If no snapshot: Call complete_skill with current phase's skill, invoke result.next_skill

No Manual Routing

This skill does NOT:

• Route by item type (MCP state machine does this)
• Invoke brainstorming/rough-draft directly (complete_skill returns next skill)
• Manage the work item loop (routing nodes handle this)