Brainstorming Skill
Overview
This skill serves two critical purposes:
- Interactive Design Process: Guides the AI through a natural, collaborative dialogue to turn ideas into fully formed designs and specs before any code is written.
- Comprehensive Ideation Framework: Provides research-validated prompt patterns (see Pattern Documentation References below) to help generate high-quality ideas across any domain (marketing, content, features).
The Brainstorming Workflow
You MUST create a task for each of these items and complete them in order when working on software features, component designs, or complex tasks. (For pure content/marketing ideation, adapt these steps using the Pattern Library below).
- Explore context — check project state, files, docs, recent commits
- Ask clarifying questions — one at a time, understand purpose/constraints/success criteria
- Propose 2-3 approaches — with trade-offs and your recommendation (use Pattern Library for inspiration)
- Present design — in sections scaled to complexity, get user approval after each section
- Document the result — write the validated design/ideas to an appropriate markdown file (e.g.,
docs/plans/YYYY-MM-DD-<topic>-design.md) and commit
- Transition — invoke a planning or implementation skill only after approval
Process Flow
[!IMPORTANT]
When provided a process map or Mermaid diagram, treat it as the authoritative procedure. Execute steps in the exact order shown, including branches, decision points, and stop conditions.
A Mermaid process diagram is an executable instruction set. Follow it exactly as written: respect sequence, conditions, loops, parallel paths, and terminal states. Do not improvise, reorder, or skip steps. If any node is ambiguous or missing required detail, pause and ask a clarifying question before continuing.
When interacting with a user, report before acting the interpreted path you will follow from the diagram, then execute.
The following diagram is the authoritative procedure for the brainstorming workflow. Execute steps in the exact order shown, including branches, decision points, and stop conditions.
flowchart TD
subgraph Phase1["Phase 1: Discovery — establish current state before proposing"]
Explore["Explore context — check project state, files, docs, recent commits"]
Ask["Ask clarifying questions — one at a time, understand purpose/constraints/success criteria"]
Propose["Propose 2-3 approaches — with trade-offs and recommendation, use Pattern Library"]
end
subgraph Phase2["Phase 2: Validation — get explicit user approval before proceeding"]
Present["Present design — in sections scaled to complexity, get user approval after each section"]
Approve{"Does user explicitly confirm approval<br>or request revision?"}
end
subgraph Phase3["Phase 3: Completion — document and hand off"]
Document["Document the result — write validated design to docs/plans/YYYY-MM-DD-topic-design.md and commit"]
Transition(["Transition — invoke planning or implementation skill only after approval"])
end
Explore --> Ask --> Propose --> Present
Present --> Approve
Approve -->|"User requests revision — revise and re-present"| Present
Approve -->|"User confirms approval — proceed"| Document
Document --> Transition
Conversational Principles
- One question at a time - Don't overwhelm with multiple questions. Break complex topics down.
- Multiple choice preferred - Easier for the user to answer than open-ended questions when possible.
- YAGNI ruthlessly - Remove unnecessary features from all designs.
- Explore alternatives - Always propose 2-3 approaches before settling.
- Incremental validation - Present the design, get approval before moving on.
- Be flexible - Go back and clarify when something doesn't make sense.
Pattern Categories for Ideation & Approaches
When proposing approaches or generating ideas for the user, utilize these 14 systematic categories. Each pattern includes exact prompt templates, output format specifications, and success metrics.
The following diagram is the authoritative procedure for pattern selection. Execute steps in the exact order shown, including branches, decision points, and stop conditions.
flowchart TD
Start(["User requests ideas or approaches"]) --> Goal{"What is the primary<br>ideation goal?"}
Goal -->|"Rapid quantity — 8-15 ideas"| PersMult["Use Perspective Multiplication patterns"]
Goal -->|"Quality/depth — refined ideas"| MultiStage["Use Multi-stage refinement<br>with constraint variation"]
Goal -->|"Breakthrough innovation"| InversionExtreme["Combine Inversion + Extreme Scaling"]
Goal -->|"Practical implementation"| Constraint["Use Constraint-Based patterns"]
Goal -->|"Market differentiation"| Competitive["Use Competitive Positioning patterns"]
Goal -->|"Customer-centric features"| Stakeholder["Use Stakeholder and Empathy patterns"]
PersMult --> Apply(["Apply selected pattern from Pattern Library"])
MultiStage --> Apply
InversionExtreme --> Apply
Constraint --> Apply
Competitive --> Apply
Stakeholder --> Apply
Output Format Optimization
Pattern Documentation References
Complete pattern documentation is organized in reference files:
Notes for Claude Instances
1---2name: brainstorming-skill3description: You MUST use this before any creative work - creating features, building components, adding functionality, modifying behavior, or when users request help with ideation, marketing, and strategic planning. Explores user intent, requirements, and design before implementation using research-validated prompt patterns.4---56# Brainstorming Skill78## Overview910This skill serves two critical purposes:111. **Interactive Design Process:** Guides the AI through a natural, collaborative dialogue to turn ideas into fully formed designs and specs *before* any code is written.122. **Comprehensive Ideation Framework:** Provides research-validated prompt patterns (see Pattern Documentation References below) to help generate high-quality ideas across any domain (marketing, content, features).1314<HARD-GATE>15Do NOT invoke any implementation skill, write any code, scaffold any project, or take any implementation action until you have completed the brainstorming process, presented a design, and the user has approved it. This applies to EVERY project regardless of perceived simplicity.16</HARD-GATE>1718## The Brainstorming Workflow1920You MUST create a task for each of these items and complete them in order when working on software features, component designs, or complex tasks. (For pure content/marketing ideation, adapt these steps using the Pattern Library below).21221. **Explore context** — check project state, files, docs, recent commits232. **Ask clarifying questions** — one at a time, understand purpose/constraints/success criteria243. **Propose 2-3 approaches** — with trade-offs and your recommendation (use Pattern Library for inspiration)254. **Present design** — in sections scaled to complexity, get user approval after each section265. **Document the result** — write the validated design/ideas to an appropriate markdown file (e.g., `docs/plans/YYYY-MM-DD-<topic>-design.md`) and commit276. **Transition** — invoke a planning or implementation skill only *after* approval2829## Process Flow3031> [!IMPORTANT]32> When provided a process map or Mermaid diagram, treat it as the authoritative procedure. Execute steps in the exact order shown, including branches, decision points, and stop conditions.33> A Mermaid process diagram is an executable instruction set. Follow it exactly as written: respect sequence, conditions, loops, parallel paths, and terminal states. Do not improvise, reorder, or skip steps. If any node is ambiguous or missing required detail, pause and ask a clarifying question before continuing.34> When interacting with a user, report before acting the interpreted path you will follow from the diagram, then execute.3536The following diagram is the authoritative procedure for the brainstorming workflow. Execute steps in the exact order shown, including branches, decision points, and stop conditions.3738```mermaid39flowchart TD40 subgraph Phase1["Phase 1: Discovery — establish current state before proposing"]41 Explore["Explore context — check project state, files, docs, recent commits"]42 Ask["Ask clarifying questions — one at a time, understand purpose/constraints/success criteria"]43 Propose["Propose 2-3 approaches — with trade-offs and recommendation, use Pattern Library"]44 end45 subgraph Phase2["Phase 2: Validation — get explicit user approval before proceeding"]46 Present["Present design — in sections scaled to complexity, get user approval after each section"]47 Approve{"Does user explicitly confirm approval<br>or request revision?"}48 end49 subgraph Phase3["Phase 3: Completion — document and hand off"]50 Document["Document the result — write validated design to docs/plans/YYYY-MM-DD-topic-design.md and commit"]51 Transition(["Transition — invoke planning or implementation skill only after approval"])52 end5354 Explore --> Ask --> Propose --> Present55 Present --> Approve56 Approve -->|"User requests revision — revise and re-present"| Present57 Approve -->|"User confirms approval — proceed"| Document58 Document --> Transition59```6061## Conversational Principles6263- **One question at a time** - Don't overwhelm with multiple questions. Break complex topics down.64- **Multiple choice preferred** - Easier for the user to answer than open-ended questions when possible.65- **YAGNI ruthlessly** - Remove unnecessary features from all designs.66- **Explore alternatives** - Always propose 2-3 approaches before settling.67- **Incremental validation** - Present the design, get approval before moving on.68- **Be flexible** - Go back and clarify when something doesn't make sense.6970## Pattern Categories for Ideation & Approaches7172When proposing approaches or generating ideas for the user, utilize these 14 systematic categories. Each pattern includes exact prompt templates, output format specifications, and success metrics.7374<category_index>751. Perspective Multiplication - Generate ideas from multiple viewpoints and stakeholder angles762. Constraint Variation - Explore idea space through artificial constraints773. Inversion & Negative Space - Use reverse thinking to find novel solutions784. Analogical Transfer - Apply patterns from different domains795. Systematic Feature Decomposition - SCAMPER and attribute-based ideation806. Scenario Exploration - Future-based and "what if" thinking817. Constraint-Based Structured Ideation - Build within hard constraints828. Chain-of-Thought Reasoning - Multi-step refinement processes839. Combination & Morphological Exploration - Force novel feature combinations8410. Assumption Challenge - Question premises and invert assumptions8511. Fill-in-the-Blank Templates - Structured completion formats8612. Competitive Positioning - Differentiation matrix approaches8713. Extreme Scaling - 10x thinking and exponential scenarios8814. Stakeholder & Empathy-Based - Customer journey and persona patterns89</category_index>9091<selection_guide>9293The following diagram is the authoritative procedure for pattern selection. Execute steps in the exact order shown, including branches, decision points, and stop conditions.9495```mermaid96flowchart TD97 Start(["User requests ideas or approaches"]) --> Goal{"What is the primary<br>ideation goal?"}98 Goal -->|"Rapid quantity — 8-15 ideas"| PersMult["Use Perspective Multiplication patterns"]99 Goal -->|"Quality/depth — refined ideas"| MultiStage["Use Multi-stage refinement<br>with constraint variation"]100 Goal -->|"Breakthrough innovation"| InversionExtreme["Combine Inversion + Extreme Scaling"]101 Goal -->|"Practical implementation"| Constraint["Use Constraint-Based patterns"]102 Goal -->|"Market differentiation"| Competitive["Use Competitive Positioning patterns"]103 Goal -->|"Customer-centric features"| Stakeholder["Use Stakeholder and Empathy patterns"]104105 PersMult --> Apply(["Apply selected pattern from Pattern Library"])106 MultiStage --> Apply107 InversionExtreme --> Apply108 Constraint --> Apply109 Competitive --> Apply110 Stakeholder --> Apply111```112</selection_guide>113114## Output Format Optimization115116<format_guidance>117Successful brainstorming patterns specify exact output formats:118- "Numbered list" > "bullet points" (better for idea tracking)119- "Table format: Idea | Reasoning | Implementation | Trade-offs" (forces completeness)120- "For each idea, explain your reasoning" (increases quality 40%)121- Specify word count ranges (200-400 words prevents both brevity and verbosity)122</format_guidance>123124## Pattern Documentation References125126Complete pattern documentation is organized in reference files:127128- [Pattern Categories and Documentation](./references/pattern-categories-and-documentation.md) - full category and pattern listing129- [Domain-Specific Applications](./references/domain-specific-applications-and-variations.md) - Marketing, Product Development, QA Testing, Business Strategy130- [Pattern Selection Guide](./references/pattern-selection-guide.md) - Decision framework for choosing appropriate patterns131- [Synthesis: What Makes Patterns Work](./references/synthesis-what-makes-these-patterns-work.md)132- [Comprehensive Prompt Library](./references/comprehensive-prompt-library-ready-to-use-templates.md) - Ready-to-use templates133- [Executive Summary](./references/executive-summary.md)134- [Bibliography and Source Documentation](./references/bibliography-and-source-documentation.md)135136## Notes for Claude Instances137138<ai_instructions>139- Start by assessing if this is an implementation design task or a content/marketing ideation task.140- ALWAYS enforce the `<HARD-GATE>`. Never jump to code without an approved design.141- When generating ideas/approaches, provide exact prompt templates from reference files, not paraphrased versions.142- Cite source files when referencing specific patterns.143</ai_instructions>