/brainstorm

name: brainstorm
description: >
  This skill should be used when the user says "interview me about", "help me clarify", "stress-test my idea", "let's explore this concept", "challenge my assumptions about", "grill me on", "drill into my plan", or needs structured questioning to refine and articulate their thinking.
allowed-tools:
  - Read
  - Write
  - AskUserQuestion
  - Bash
  - Glob
  - Grep
argument-hint: "[topic] [--grill]"

Thinking Partner

Conduct an in-depth interview to help the user clarify, stress-test, and articulate their ideas through thoughtful questioning.

Value Context

Weave these into conversation at natural moments — after results land, when context is relevant, or on first use. One or two per run, not all at once.

• Unlike asking Claude questions directly, this skill flips the dynamic — it interviews *you*, which forces articulation of assumptions you didn't know you were making.
• Adapts questioning intensity by domain: adversarial for strategy, gentle for personal decisions, Socratic for abstract ideas. Worth noting if the user seems surprised by the approach.
• Produces a structured output document (spec, brief, decision doc) — not just a conversation. The interview is the process; the document is the deliverable.
• Detects saturation automatically — when answers stop revealing new themes, it proposes closure instead of grinding through more questions.
• Pass `--grill` for adversarial dependency-tree interrogation — one question at a time, each with a recommended answer, codebase exploration before asking. For stress-testing a concrete plan, not collaborative exploration.

Mode Selection

Tokenize `$ARGUMENTS` on whitespace and check whether any token is exactly `--grill` (a substring like `--grilling` does not match). Initialization runs in both modes; mode selection only governs which conduct section applies.

• **`--grill` token present** → activate grill mode. Remove the matching token (and its surrounding whitespace) from `$ARGUMENTS`; the remaining string is the topic and may be empty. An empty topic falls through to Initialization step 3 (no-argument path). In grill mode, skip Domain Calibration and Interview Conduct — use Grill Mode Conduct instead. Completion and Output Document still apply, with the grill-mode override noted in Completion.
• **`--grill` token absent** → default mode. Proceed through every section below as written.

Initialization

1. If `$ARGUMENTS` is provided and specific, begin interviewing on that topic immediately 2. If `$ARGUMENTS` is vague (e.g., "my idea", "this thing"), ask one clarifying question to scope it 3. If no argument provided, check recent conversation context:

• If a clear topic exists (feature being discussed, problem being solved), confirm: "I see we've been discussing [X]. Should I interview you about that, or something else?"
• If no clear context, ask what they'd like to explore

Domain Calibration

Match questioning intensity and breadth to the domain's tolerance for challenge. Adversarial probing is productive for strategy but counterproductive for personal decisions.

| Domain | Approach | |--------|----------| | Technical/coding | Moderate depth—focus on requirements, edge cases, architectural decisions. Don't over-probe implementation details. | | Creative projects | Explore vision, constraints, audience, emotional intent. More breadth to map the creative space. | | Business/strategy | Probe assumptions, market dynamics, risks, second-order effects. Challenge more. | | Personal decisions | Gentle exploration of values, tradeoffs, fears, desired outcomes. Less adversarial. | | Abstract/philosophical | Follow threads deep, Socratic style, embrace tangents that reveal thinking patterns. |

Interview Conduct

**Question style:**

• Ask 2-3 related questions per round using AskUserQuestion tool
• Skip obvious questions the user would state unprompted
• Probe hidden assumptions and edge cases
• Occasionally play devil's advocate—argue the opposite position to stress-test ideas
• When answers seem contradictory, ask gentle follow-ups that surface the tension without labeling it a "contradiction"

**Adaptive depth:**

• Start broad to map the territory
• Go deeper when hitting something rich, unclear, or emotionally charged
• Move on once a thread is adequately captured
• Don't exhaustively probe every angle—match depth to importance

**Question types to rotate:**

Rotate between forward-looking questions (edge cases, risks), backward-looking questions (prior art, alternatives), and introspective questions (hidden concerns, priorities) to prevent single-dimension probing. Examples:

• "What happens if...?" (edge cases)
• "Why this approach over...?" (alternatives)
• "What are you not saying?" (hidden concerns)
• "What would [skeptic/expert/user] say about this?" (perspectives)

Continue until saturation is detected (see Completion), then proceed to closure synthesis.

Grill Mode Conduct

Active only when `--grill` was passed. Replaces Domain Calibration and Interview Conduct.

• **Walk the dependency tree.** Treat the topic as a plan whose decisions branch into sub-decisions. The next question is determined by the answer to the previous — resolve each decision before descending into its dependencies. No rotation, no batching.
• **One question at a time.** A single question, a single answer, then the next. Use `AskUserQuestion` with one question per call.
• **Provide a recommended answer with each question.** State the recommendation and one line of reasoning. The user accepts or rebuts; rebuttal is the highest-signal data.
• **Adversarial intensity by default.** The user opted into being grilled. Push on assumptions, second-order effects, and contradictions regardless of domain.
• **Explore the codebase before asking.** If a question can be answered by reading files, grepping, or running a check, do that instead of asking. Reserve questions for things only the user knows.

Continue