Brainstorm

Parse the user's initial idea/concept and identify:

Idea Type Classification — Classify the idea to guide framework selection later:

Complexity Check — Flag ideas that may be too complex for a single-session brainstorm:

• Multiple distinct problem domains
• More than 5-6 major components or stakeholders
• Spans organizational boundaries
• Multi-month timeline with phases

If complexity is high, mention it: "This has a lot of dimensions — we can cover the key angles in this session, but if you want to go really deep, the deep-brainstorm skill spreads exploration across multiple sessions and builds a persistent knowledge structure."

Project Context Detection — Flag for codebase research when:

• User mentions specific files, modules, or features
• User references "the current system" or "our codebase"
• User mentions extending/modifying existing functionality

After parsing, summarize understanding and begin Phase 2.

Phase 2: Socratic Clarification

Engage in iterative questioning until the user signals readiness to proceed.

Question Categories (reference: references/questioning-frameworks.md):

1. Scope Questions — What boundaries should this have? What's out of scope?
2. Assumption Questions — What are we taking for granted? What must be true?
3. Alternative Questions — What other approaches exist? What's the opposite?
4. Consequence Questions — What happens if this succeeds? Fails? Second-order effects?
5. Evidence Questions — What supports this? How could we test it?

How to question well:

• Ask 2-4 questions per round, mixing categories
• Build on previous answers — don't just cycle through a list
• Use "what" and "how" more than "why" (less confrontational)
• Acknowledge insights before probing deeper
• Don't criticize during clarification — that's for analysis

Parking Lot — When the user mentions tangential ideas, interesting threads, or "oh and we could also..." thoughts that aren't central to the core concept, note them. Keep a mental running list and include them in the output. Good ideas shouldn't get lost just because they're not the main topic.

Continuation Protocol:

• After each round, give a signal about depth: "There are some interesting threads around [X] and [Y] I'd like to probe — want to keep going, or is the picture clear enough to move to analysis?"
• Continue until user explicitly signals readiness
• Don't rush this phase — thorough questioning produces better outcomes

Phase 3: Targeted Research

Spawn research agents only when they'll add genuine value. Don't research for the sake of researching.

Web Research — Spawn when the idea would benefit from external context (most ideas do, but very internal/project-specific ones may not):

Task(subagent_type="web-search-researcher",
     prompt="Research best practices, common patterns, and pitfalls for [idea topic].
             Find:
             1. Similar implementations and how they succeeded/failed
             2. Industry best practices and anti-patterns to avoid
             3. Common technical approaches and their trade-offs
             4. Lessons learned from comparable projects
             Focus on actionable insights, not just general information.")

Codebase Research — Spawn only when project context was detected in Phase 1:

Task(subagent_type="codebase-locator",
     prompt="Find all files related to [relevant feature area]. Include:
             - Core implementation files
             - Configuration and setup files
             - Test files
             - Documentation")

Task(subagent_type="codebase-analyzer",
     prompt="Analyze how [related functionality] is currently implemented.
             Trace the data flow and identify integration points.
             Include file:line references.")

Task(subagent_type="codebase-pattern-finder",
     prompt="Find implementation patterns for [type of implementation] in this codebase.
             Look for:
             - Similar features and how they're structured
             - Conventions for [relevant patterns]
             - Testing approaches used")

Don't wait idly for agents — move to Phase 4 and incorporate findings when they arrive.

Phase 4: Focused Analysis

Select 1-2 frameworks based on idea type. Applying all frameworks to every idea produces noise. Pick the ones that will generate the most useful insights.

Six Thinking Hats (when selected)

Don't force all six hats if only 3-4 are producing meaningful insights.

SCAMPER (when selected)

Skip letters that don't produce meaningful insights for this particular idea.

Premortem (when selected)

1. "Imagine this has completely failed 6 months from now."
2. "What went wrong?" — technical, people, process, external
3. "What warning signs did we ignore?"
4. "What did we underestimate?"
5. "How do we prevent each failure mode?"

Focus on the 3-5 most realistic failure modes, not an exhaustive list.

Phase 5: Synthesis & Output

Consolidate findings into actionable insights and write the output document.

Determine Output Location:

• Default: docs/brainstorms/YYYY-MM-DD-{topic-slug}.md
• Create directory if it doesn't exist

Write the output — include only sections with meaningful content. The template below shows all possible sections; omit any that would just contain filler.

# Brainstorm: [Idea Name]

**Date**: YYYY-MM-DD
**Status**: Ready for Planning | Needs More Exploration
**Type**: [Product/Feature | Architecture | Strategy | Process | Creative | Risk]

## Executive Summary
[2-3 sentence refined description of the idea after exploration]

## Idea Evolution

### Original Concept
[What the user initially described — preserve their words]

### Refined Understanding
[How the idea evolved through questioning — what became clearer]

### Key Clarifications
- [Clarification 1]
- [Clarification 2]

## Analysis

### Strengths
[Validated strengths with supporting evidence. Source these from
Yellow Hat findings or SCAMPER opportunities, depending on which
framework was used.]

### Risks & Concerns
| Risk | Likelihood | Impact | Mitigation |
|------|------------|--------|------------|
| [Risk 1] | H/M/L | H/M/L | [Strategy] |

[Source from Black Hat, Premortem, or both.]

### Gaps
- [ ] **[Gap 1]** — Suggested approach: [...]

### Enhancement Opportunities
[Only if SCAMPER was used. List the meaningful findings, not all 7 letters.]

### Premortem Findings
[Only if Premortem was used.]
- **Failure mode**: [Description] → **Prevention**: [Strategy]

## Research Findings

### External Best Practices
[Only if web research was conducted]

### Codebase Context
[Only if codebase research was conducted]
- Relevant files: [file:line references]
- Existing patterns: [patterns]
- Integration points: [components]

## Parking Lot
[Tangential ideas captured during the session that are worth revisiting]
- [Idea 1]
- [Idea 2]

## Recommended Next Steps
1. [Immediate next step]
2. [Follow-up step]

## Ready for Create-Plan
**[Yes/No]**

**If Yes**: Well-defined and ready for implementation planning.
**If No**: [What needs more exploration]

### Suggested Plan Scope
[What create-plan should focus on]

After writing:

1. Confirm file was saved
2. Present a concise summary to the user
3. If status is "Ready for Planning", offer to invoke create-plan
4. If the idea proved complex, suggest deep-brainstorm for areas that need more exploration

ADR Integration — Only invoke the ADR skill when a significant architectural or strategic decision clearly crystallized during the session (e.g., the user chose between competing approaches, a technology decision was made). Don't force ADR creation when no real decision was made.

Quality Checklist

Before finalizing output, verify:

• Socratic clarifications were thorough (not rushed)
• Framework selection matched the idea type
• Only relevant frameworks were applied
• Research was conducted where valuable (not mechanically)
• Risks have mitigation strategies
• Gaps have suggested approaches
• Parking lot captured tangential ideas
• Output includes only meaningful sections (no filler)
• Output file was written successfully
• Ready-for-plan status is accurate
• Complexity escalation to deep-brainstorm was suggested if warranted

Resources

references/

• questioning-frameworks.md - Detailed question templates for Socratic, Six Hats, SCAMPER, and Premortem frameworks