Transition from brainstorming to rough-draft skill
View on GitHubben-mad-jlp/claude-mermaid-collab
mermaid-collab
skills/brainstorming-transition/SKILL.md
January 25, 2026
Select agents to install to:
npx add-skill https://github.com/ben-mad-jlp/claude-mermaid-collab/blob/main/skills/brainstorming-transition/SKILL.md -a claude-code --skill brainstorming-transitionInstallation paths:
.claude/skills/brainstorming-transition/# 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