brainstorming

Brainstorming v2.0: Resilient Multi-Model Planning

Turn ideas into validated designs through collaborative AI dialogue with resilient model execution and confidence-based validation.

Overview

This skill improves upon v1.0 by addressing critical reliability gaps:

Key v2.0 Improvements:

• No AskUserQuestion dependency: Uses Task + Tasks for structured interaction
• Fallback chains: 3+ models per role ensures completion even if some fail
• Explicit parallelism: Documented Task call patterns for parallel execution
• Defined algorithms: Consensus matrix and confidence scoring are mathematically specified

When to Use

Use this skill BEFORE implementing any feature:

• "Design a user authentication system"
• "Brainstorm approaches for API rate limiting"
• "Plan architecture for a new dashboard feature"
• "Evaluate options for real-time data synchronization"

Prerequisites

Required Setup

# 1. Install required skills
/plugin marketplace add MadAppGang/claude-code
skill install superpowers:using-git-worktrees
skill install superpowers:writing-plans

# 2. Verify OpenRouter access (for multi-model)
export OPENROUTER_API_KEY=your-key

# 3. Configure models in ~/.claude/settings.json
{
  "brainstorming": {
    "primary_model": "anthropic/claude-opus-4-20250514",
    "explorer_models": [
      "x-ai/grok-code-fast-1",
      "google/gemini-2-5-pro",
      "anthropic/claude-sonnet-4-20250514"
    ]
  }
}

Model Requirements

Role	Min Context	Capabilities
Primary	200K tokens	Complex reasoning, orchestration
Explorer	100K tokens	Code generation, analysis

Workflow

Phase 0: Problem Analysis (200-300 words)

Objective: Capture problem scope, constraints, and success criteria

How to Ask Users (Without AskUserQuestion):

// Pattern: Use Tasks to track questions, Read/Write for presentation

// 1. Write question to temp file
await Write({
  file_path: "/tmp/brainstorm-q1.md",
  content: `## Question 1 of 3

**What are the main constraints or requirements for this feature?**

Please respond with:
- Functional requirements (what it must do)
- Non-functional requirements (performance, scale)
- Any existing dependencies or integrations
`
});

// 2. Present file and wait for user response
// User reads file, provides input via conversation

// 3. Summarize understanding
const problemSummary = await Write({
  file_path: "/tmp/brainstorm-problem.md",
  content: `## Problem Understanding

**Constraints identified:**
- [From user response]

**Success criteria:**
- [Measurable outcomes]

**Scope boundaries:**
- [What's in/out]

---

**Does this accurately capture the problem?** (Reply "yes" to proceed or clarify)
`
});