Back to Skills

brainstorming-transition

verified

Transition from brainstorming to rough-draft skill

View on GitHub

Marketplace

mermaid-collab-dev

ben-mad-jlp/claude-mermaid-collab

Plugin

mermaid-collab

Repository

ben-mad-jlp/claude-mermaid-collab

skills/brainstorming-transition/SKILL.md

Last Verified

January 25, 2026

Install Skill

Select agents to install to:

Scope:
npx add-skill https://github.com/ben-mad-jlp/claude-mermaid-collab/blob/main/skills/brainstorming-transition/SKILL.md -a claude-code --skill brainstorming-transition

Installation paths:

Claude
.claude/skills/brainstorming-transition/
Powered by add-skill CLI

Instructions

# Transition to Rough-Draft

After the VALIDATING phase passes, transition to the rough-draft skill.

## Pre-Transition Checklist

Before transitioning, verify:

- [ ] Completeness gate passed
- [ ] User confirmed "Yes" to proceed
- [ ] Design doc is saved and up-to-date
- [ ] All diagrams are finalized

## Transition Process

### 1. Update Collab State

```
Tool: mcp__plugin_mermaid-collab_mermaid__update_session_state
Args: { "project": "<cwd>", "session": "<name>", "phase": "rough-draft/interface" }
```

Note: `lastActivity` is automatically updated by the MCP tool.

### 2. Save Snapshot

Before invoking rough-draft, save context via MCP:

```
FUNCTION saveSnapshot(pendingQuestion):
  session = current session name

  # Read current state via MCP
  Tool: mcp__plugin_mermaid-collab_mermaid__get_session_state
  Args: { "project": "<cwd>", "session": session }
  Returns: state = { "phase": "...", "currentItem": ..., ... }

  # Save snapshot via MCP
  Tool: mcp__plugin_mermaid-collab_mermaid__save_snapshot
  Args: {
    "project": "<cwd>",
    "session": session,
    "activeSkill": "brainstorming",
    "currentStep": "VALIDATING",
    "pendingQuestion": null,
    "inProgressItem": state.currentItem,
    "recentContext": []
  }
  # Note: version and timestamp are automatically added

  # Update state to mark snapshot exists
  Tool: mcp__plugin_mermaid-collab_mermaid__update_session_state
  Args: { "project": "<cwd>", "session": session, "hasSnapshot": true }
```

### 3. Pre-Transition Compaction

Before transitioning to rough-draft:

Ask user: "Compact context before starting rough-draft?"

```
1. Yes
2. No
```

- If **1 (Yes)**: Invoke skill: collab-compact, wait for completion, then invoke rough-draft
- If **2 (No)**: Invoke rough-draft directly

### 4. Invoke Rough-Draft Skill

The rough-draft skill will:
1. Read the design doc
2. Create interface definitions
3. Write pseudocode
4. Build code skeleton
5. Hand off to implementation

## Standalone Mode (No Collab)

I

Validation Details

Front Matter
Required Fields
Valid Name Format
Valid Description
Has Sections
Allowed Tools
Instruction Length:
4320 chars