From cf8a87143d502e10113c168df55b97b5f467e8f9 Mon Sep 17 00:00:00 2001 From: catlog22 Date: Tue, 9 Sep 2025 14:37:17 +0800 Subject: [PATCH] refactor: Reduce duplication in brainstorming system MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit - Create brainstorming-framework.md to centralize common techniques and execution modes - Simplify conceptual-planning-agent.md from 280 to 170 lines (39% reduction) - Update all 9 brainstorm commands to reference framework instead of agent - Eliminate circular dependencies and improve maintainability Key improvements: - Separated concerns: principles -> framework -> commands -> agent - Role definitions now only exist in their respective command files - Creative techniques centralized in framework file - Agent focused solely on execution logic - Clear hierarchical reference structure without duplication ๐Ÿค– Generated with Claude Code Co-Authored-By: Claude --- .../workflow/brainstorm/business-analyst.md | 2 +- .../workflow/brainstorm/data-architect.md | 2 +- .../workflow/brainstorm/feature-planner.md | 2 +- .../workflow/brainstorm/innovation-lead.md | 4 +- .../workflow/brainstorm/product-manager.md | 2 +- .../workflow/brainstorm/security-expert.md | 2 +- .../workflow/brainstorm/system-architect.md | 2 +- .../workflow/brainstorm/ui-designer.md | 2 +- .../workflow/brainstorm/user-researcher.md | 2 +- .claude/workflows/brainstorming-framework.md | 169 ++++++++++++++++++ .../workflows/conceptual-planning-agent.md | 151 ++++------------ 11 files changed, 209 insertions(+), 131 deletions(-) create mode 100644 .claude/workflows/brainstorming-framework.md diff --git a/.claude/commands/workflow/brainstorm/business-analyst.md b/.claude/commands/workflow/brainstorm/business-analyst.md index 8fe1a432..72bf5da5 100644 --- a/.claude/commands/workflow/brainstorm/business-analyst.md +++ b/.claude/commands/workflow/brainstorm/business-analyst.md @@ -36,7 +36,7 @@ Business process expert responsible for analyzing workflows, identifying require ## ๐Ÿง  **Analysis Framework** @~/.claude/workflows/brainstorming-principles.md -@~/.claude/workflows/conceptual-planning-agent.md +@~/.claude/workflows/brainstorming-framework.md ### Key Analysis Questions diff --git a/.claude/commands/workflow/brainstorm/data-architect.md b/.claude/commands/workflow/brainstorm/data-architect.md index 40efa075..b37ca21a 100644 --- a/.claude/commands/workflow/brainstorm/data-architect.md +++ b/.claude/commands/workflow/brainstorm/data-architect.md @@ -36,7 +36,7 @@ Strategic data professional responsible for designing scalable, efficient data a ## ๐Ÿง  **Analysis Framework** @~/.claude/workflows/brainstorming-principles.md -@~/.claude/workflows/conceptual-planning-agent.md +@~/.claude/workflows/brainstorming-framework.md ### Key Analysis Questions diff --git a/.claude/commands/workflow/brainstorm/feature-planner.md b/.claude/commands/workflow/brainstorm/feature-planner.md index 154d3b35..4f4abede 100644 --- a/.claude/commands/workflow/brainstorm/feature-planner.md +++ b/.claude/commands/workflow/brainstorm/feature-planner.md @@ -27,7 +27,7 @@ allowed-tools: Task(conceptual-planning-agent), TodoWrite(*) ## ๐Ÿง  **ๅˆ†ๆžๆก†ๆžถ** @~/.claude/workflows/brainstorming-principles.md -@~/.claude/workflows/conceptual-planning-agent.md +@~/.claude/workflows/brainstorming-framework.md ### ๆ ธๅฟƒๅˆ†ๆž้—ฎ้ข˜ 1. **ๅŠŸ่ƒฝ้œ€ๆฑ‚ๅˆ†ๆž**: diff --git a/.claude/commands/workflow/brainstorm/innovation-lead.md b/.claude/commands/workflow/brainstorm/innovation-lead.md index 8ebc7369..85d58c6c 100644 --- a/.claude/commands/workflow/brainstorm/innovation-lead.md +++ b/.claude/commands/workflow/brainstorm/innovation-lead.md @@ -24,10 +24,10 @@ allowed-tools: Task(conceptual-planning-agent), TodoWrite(*) - **ๅˆ›ๆ–ฐๆœบไผš**: ็ ดๅๆ€งๅˆ›ๆ–ฐใ€่“ๆตทๅธ‚ๅœบใ€ๆŠ€ๆœฏ่žๅˆๆœบไผš - **ๆœชๆฅๆ„ฟๆ™ฏ**: ้•ฟๆœŸๆŠ€ๆœฏ่ทฏ็บฟๅ›พใ€ๆฆ‚ๅฟต้ชŒ่ฏใ€ๅŽŸๅž‹ๅผ€ๅ‘ -## ๐Ÿง  **ๅˆ†ๆžๆก†ๆžถ** +## ๐Ÿง  **Analysis Framework** @~/.claude/workflows/brainstorming-principles.md -@~/.claude/workflows/conceptual-planning-agent.md +@~/.claude/workflows/brainstorming-framework.md ### ๆ ธๅฟƒๅˆ†ๆž้—ฎ้ข˜ 1. **ๆŠ€ๆœฏ่ถ‹ๅŠฟๅ’Œๆœบไผš**: diff --git a/.claude/commands/workflow/brainstorm/product-manager.md b/.claude/commands/workflow/brainstorm/product-manager.md index 49477f0c..b33448dc 100644 --- a/.claude/commands/workflow/brainstorm/product-manager.md +++ b/.claude/commands/workflow/brainstorm/product-manager.md @@ -36,7 +36,7 @@ Strategic product leader focused on maximizing user value and business impact th ## ๐Ÿง  **Analysis Framework** @~/.claude/workflows/brainstorming-principles.md -@~/.claude/workflows/conceptual-planning-agent.md +@~/.claude/workflows/brainstorming-framework.md ### Key Analysis Questions diff --git a/.claude/commands/workflow/brainstorm/security-expert.md b/.claude/commands/workflow/brainstorm/security-expert.md index 98bf1678..487f595b 100644 --- a/.claude/commands/workflow/brainstorm/security-expert.md +++ b/.claude/commands/workflow/brainstorm/security-expert.md @@ -36,7 +36,7 @@ Cybersecurity specialist focused on identifying threats, designing security cont ## ๐Ÿง  **Analysis Framework** @~/.claude/workflows/brainstorming-principles.md -@~/.claude/workflows/conceptual-planning-agent.md +@~/.claude/workflows/brainstorming-framework.md ### Key Analysis Questions diff --git a/.claude/commands/workflow/brainstorm/system-architect.md b/.claude/commands/workflow/brainstorm/system-architect.md index 9857b77d..818ea8cc 100644 --- a/.claude/commands/workflow/brainstorm/system-architect.md +++ b/.claude/commands/workflow/brainstorm/system-architect.md @@ -36,7 +36,7 @@ Technical leader responsible for designing scalable, maintainable, and high-perf ## ๐Ÿง  **Analysis Framework** @~/.claude/workflows/brainstorming-principles.md -@~/.claude/workflows/conceptual-planning-agent.md +@~/.claude/workflows/brainstorming-framework.md ### Key Analysis Questions diff --git a/.claude/commands/workflow/brainstorm/ui-designer.md b/.claude/commands/workflow/brainstorm/ui-designer.md index 5820cd54..5ae8b080 100644 --- a/.claude/commands/workflow/brainstorm/ui-designer.md +++ b/.claude/commands/workflow/brainstorm/ui-designer.md @@ -36,7 +36,7 @@ Creative professional responsible for designing intuitive, accessible, and visua ## ๐Ÿง  **Analysis Framework** @~/.claude/workflows/brainstorming-principles.md -@~/.claude/workflows/conceptual-planning-agent.md +@~/.claude/workflows/brainstorming-framework.md ### Key Analysis Questions diff --git a/.claude/commands/workflow/brainstorm/user-researcher.md b/.claude/commands/workflow/brainstorm/user-researcher.md index 4558b34d..becbcc3e 100644 --- a/.claude/commands/workflow/brainstorm/user-researcher.md +++ b/.claude/commands/workflow/brainstorm/user-researcher.md @@ -27,7 +27,7 @@ allowed-tools: Task(conceptual-planning-agent), TodoWrite(*) ## ๐Ÿง  **ๅˆ†ๆžๆก†ๆžถ** @~/.claude/workflows/brainstorming-principles.md -@~/.claude/workflows/conceptual-planning-agent.md +@~/.claude/workflows/brainstorming-framework.md ### ๆ ธๅฟƒๅˆ†ๆž้—ฎ้ข˜ 1. **็”จๆˆท็†่งฃๅ’ŒๆดžๅฏŸ**: diff --git a/.claude/workflows/brainstorming-framework.md b/.claude/workflows/brainstorming-framework.md new file mode 100644 index 00000000..5024719b --- /dev/null +++ b/.claude/workflows/brainstorming-framework.md @@ -0,0 +1,169 @@ +# Brainstorming Framework + +## Overview +Common creative techniques, execution modes, and quality standards for all brainstorming sessions. + +## Creative Techniques + +### SCAMPER Method +- **Substitute**: What can be substituted or replaced? +- **Combine**: What can be combined or merged? +- **Adapt**: What can be adapted from elsewhere? +- **Modify**: What can be magnified, minimized, or modified? +- **Put to other uses**: How else can this be used? +- **Eliminate**: What can be removed or simplified? +- **Reverse**: What can be rearranged or reversed? + +### Six Thinking Hats +- **White Hat**: Facts, information, data +- **Red Hat**: Emotions, feelings, intuition +- **Black Hat**: Critical judgment, caution, problems +- **Yellow Hat**: Optimism, benefits, positive thinking +- **Green Hat**: Creativity, alternatives, new ideas +- **Blue Hat**: Process control, meta-thinking + +### Additional Techniques +- **Mind Mapping**: Visual idea exploration and connection +- **Brainstorming**: Free-flowing idea generation +- **Brainwriting**: Silent idea generation and building +- **Random Word**: Stimulus-based creative thinking +- **What If**: Scenario-based exploration +- **Assumption Challenging**: Question fundamental assumptions + +## Execution Modes + +### Creative Mode (Default) +- **Techniques**: SCAMPER, Six Thinking Hats, wild ideas +- **Focus**: Innovation and unconventional solutions +- **Approach**: + - Emphasize divergent thinking and wild ideas + - Apply creative techniques extensively + - Encourage "what if" thinking and assumption challenging + - Focus on novel and unconventional solutions + +### Analytical Mode +- **Techniques**: Root cause analysis, data-driven insights +- **Focus**: Evidence-based systematic problem-solving +- **Approach**: + - Use structured analysis frameworks + - Apply root cause analysis and logical thinking + - Emphasize evidence-based reasoning + - Focus on systematic problem-solving + +### Strategic Mode +- **Techniques**: Systems thinking, scenario planning +- **Focus**: Long-term strategic positioning +- **Approach**: + - Apply strategic thinking frameworks + - Use systems thinking and long-term perspective + - Consider competitive dynamics and market forces + - Focus on strategic positioning and advantage + +## Brainstorming Session Protocol + +### Input Processing +``` +Topic: [Challenge or opportunity description] +Mode: [creative|analytical|strategic] +Perspectives: [Selected role perspectives] +Context: [Current situation and constraints] +``` + +### Execution Flow +``` +1. Challenge Analysis โ†’ Define scope, constraints, success criteria +2. Perspective Setup โ†’ Establish role contexts and viewpoints +3. Ideation Phase โ†’ Generate ideas using appropriate techniques +4. Convergence Phase โ†’ Evaluate, synthesize, prioritize solutions +5. Documentation โ†’ Create structured session records +``` + +## Documentation Standards + +### Session Summary Generation +Generate comprehensive session documentation including: +- Session metadata and configuration +- Challenge definition and scope +- Key insights and patterns +- Generated ideas with descriptions +- Perspective analysis from each role +- Evaluation and prioritization +- Recommendations and next steps + +### Idea Documentation +For each significant idea, create detailed documentation: +- Concept description and core mechanism +- Multi-perspective analysis and implications +- Feasibility assessment (technical, resource, timeline) +- Impact potential (user, business, technical) +- Implementation considerations and prerequisites +- Success metrics and validation approach +- Risk assessment and mitigation strategies + +## Output Format Standards + +### Brainstorming Session Output +``` +BRAINSTORMING_SUMMARY: [Comprehensive session overview] +CHALLENGE_DEFINITION: [Clear problem space definition] +KEY_INSIGHTS: [Major discoveries and patterns] +IDEA_INVENTORY: [Structured list of all generated ideas] +TOP_CONCEPTS: [5 most promising solutions with analysis] +PERSPECTIVE_SYNTHESIS: [Integration of role-based insights] +FEASIBILITY_ASSESSMENT: [Technical and resource evaluation] +IMPACT_ANALYSIS: [Expected outcomes and benefits] +RECOMMENDATIONS: [Prioritized next steps and actions] +WORKFLOW_INTEGRATION: [If applicable, workflow handoff preparation] +``` + +### Multi-Role Analysis Output +``` +ROLE_COORDINATION: [How perspectives were integrated] +PERSPECTIVE_INSIGHTS: [Key insights from each role] +SYNTHESIS_RESULTS: [Combined perspective analysis] +CONFLICT_RESOLUTION: [How role conflicts were addressed] +COMPREHENSIVE_COVERAGE: [Confirmation all aspects considered] +``` + +## Quality Standards + +### Effective Session Facilitation +- **Clear Structure** โ†’ Follow defined phases and maintain session flow +- **Inclusive Participation** โ†’ Ensure all perspectives are heard and valued +- **Creative Environment** โ†’ Maintain judgment-free ideation atmosphere +- **Productive Tension** โ†’ Balance creativity with practical constraints +- **Actionable Outcomes** โ†’ Generate concrete next steps and recommendations + +### Perspective Integration +- **Authentic Representation** โ†’ Accurately channel each role's mental models +- **Balanced Coverage** โ†’ Give appropriate attention to all perspectives +- **Constructive Synthesis** โ†’ Combine insights into stronger solutions +- **Conflict Navigation** โ†’ Address perspective tensions constructively +- **Comprehensive Analysis** โ†’ Ensure no critical aspects are overlooked + +### Documentation Quality +- **Structured Capture** โ†’ Organize insights and ideas systematically +- **Clear Communication** โ†’ Present complex ideas in accessible format +- **Decision Support** โ†’ Provide frameworks for evaluating options +- **Implementation Ready** โ†’ Prepare outputs for next development phases +- **Traceability** โ†’ Maintain clear links between ideas and analysis + +## Integration Guidelines + +### With Brainstorming Principles +This framework works in conjunction with @~/.claude/workflows/brainstorming-principles.md which defines: +- Project structure establishment +- Session initialization requirements +- Directory creation protocols +- Agent coordination standards + +### With Role Commands +Each role-specific brainstorm command implements this framework within their domain context: +- Applies appropriate techniques for their perspective +- Uses mode selection based on problem type +- Follows documentation standards +- Maintains quality criteria + +--- + +This framework provides the common foundation for all brainstorming activities while allowing role-specific customization and focus. \ No newline at end of file diff --git a/.claude/workflows/conceptual-planning-agent.md b/.claude/workflows/conceptual-planning-agent.md index b03ebfe1..895b75c4 100644 --- a/.claude/workflows/conceptual-planning-agent.md +++ b/.claude/workflows/conceptual-planning-agent.md @@ -4,139 +4,48 @@ **Integration Principles**: See @~/.claude/workflows/brainstorming-principles.md ## Purpose -Multi-role brainstorming and conceptual planning agent specialized in creative problem-solving, strategic thinking, and comprehensive perspective coordination. +Agent for executing single-role conceptual planning and brainstorming analysis based on assigned perspectives. ## Core Capabilities - -### Brainstorming Facilitation -- **Multi-Perspective Coordination** โ†’ Orchestrate insights from different role perspectives -- **Creative Technique Application** โ†’ Apply SCAMPER, Six Thinking Hats, and other proven methods -- **Structured Ideation** โ†’ Guide systematic idea generation and evaluation processes -- **Session Documentation** โ†’ Create comprehensive brainstorming records and summaries - -### Strategic Analysis -- **Systems Thinking** โ†’ Analyze complex interdependencies and relationships -- **Scenario Planning** โ†’ Explore multiple future possibilities and outcomes -- **Strategic Framework Application** โ†’ Use established strategic analysis tools -- **Long-term Vision Development** โ†’ Create compelling future state visions - -### Multi-Role Perspective Integration -- **Role-Based Analysis** โ†’ Channel different expertise areas and mental models -- **Perspective Synthesis** โ†’ Combine insights from multiple viewpoints into coherent solutions -- **Conflict Resolution** โ†’ Address tensions between different role perspectives -- **Comprehensive Coverage** โ†’ Ensure all relevant aspects are considered +- **Single-Role Analysis** โ†’ Deep analysis from one assigned role perspective +- **Context Integration** โ†’ Incorporate user requirements and constraints +- **Documentation Generation** โ†’ Create role-specific analysis outputs +- **Framework Application** โ†’ Apply techniques from @~/.claude/workflows/brainstorming-framework.md ## Execution Patterns -### Brainstorming Session Protocol +### Agent Invocation +This agent is called by role-specific brainstorm commands with: +- **ASSIGNED_ROLE**: The specific role to embody +- **Topic**: Challenge or opportunity to analyze +- **Context**: User requirements and constraints +- **Output Location**: Where to save analysis files -**Input Processing**: -``` -Topic: [Challenge or opportunity description] -Mode: [creative|analytical|strategic] -Perspectives: [Selected role perspectives] -Context: [Current situation and constraints] -``` +### Execution Flow +See @~/.claude/workflows/brainstorming-framework.md for detailed execution patterns and techniques. -**Execution Flow**: -``` -1. Challenge Analysis โ†’ Define scope, constraints, success criteria -2. Perspective Setup โ†’ Establish role contexts and viewpoints -3. Ideation Phase โ†’ Generate ideas using appropriate techniques -4. Convergence Phase โ†’ Evaluate, synthesize, prioritize solutions -5. Documentation โ†’ Create structured session records -``` +### Role References -### Multi-Role Perspective Execution +**Available Roles**: Each role has its own command file with detailed definitions: +- `business-analyst` - See `.claude/commands/workflow/brainstorm/business-analyst.md` +- `data-architect` - See `.claude/commands/workflow/brainstorm/data-architect.md` +- `feature-planner` - See `.claude/commands/workflow/brainstorm/feature-planner.md` +- `innovation-lead` - See `.claude/commands/workflow/brainstorm/innovation-lead.md` +- `product-manager` - See `.claude/commands/workflow/brainstorm/product-manager.md` +- `security-expert` - See `.claude/commands/workflow/brainstorm/security-expert.md` +- `system-architect` - See `.claude/commands/workflow/brainstorm/system-architect.md` +- `ui-designer` - See `.claude/commands/workflow/brainstorm/ui-designer.md` +- `user-researcher` - See `.claude/commands/workflow/brainstorm/user-researcher.md` -**Available Roles and Contexts**: +### Creative Techniques -**Product Manager Perspective**: -- Focus: User needs, business value, market positioning -- Questions: What do users want? How does this create business value? -- Output: User stories, business cases, market analysis +For detailed creative techniques including SCAMPER, Six Thinking Hats, and other methods, see: +@~/.claude/workflows/brainstorming-framework.md#creative-techniques -**System Architect Perspective**: -- Focus: Technical architecture, scalability, integration -- Questions: How does this scale? What are technical constraints? -- Output: Architecture diagrams, technical requirements, system design +### Execution Modes -**UI Designer Perspective**: -- Focus: User experience, interface design, usability -- Questions: How do users interact? What's the optimal user journey? -- Output: User flows, wireframes, interaction patterns, design principles - -**Data Architect Perspective**: -- Focus: Data flow, storage, analytics, insights -- Questions: What data is needed? How is it processed and analyzed? -- Output: Data models, flow diagrams, analytics requirements - -**Security Expert Perspective**: -- Focus: Security implications, threat modeling, compliance -- Questions: What are the risks? How do we protect against threats? -- Output: Threat models, security requirements, compliance frameworks - -**User Researcher Perspective**: -- Focus: User behavior, pain points, research insights -- Questions: What do users really need? What problems are we solving? -- Output: User research synthesis, personas, behavioral insights - -**Business Analyst Perspective**: -- Focus: Process optimization, efficiency, ROI -- Questions: How does this improve processes? What's the return on investment? -- Output: Process maps, efficiency metrics, cost-benefit analysis - -**Innovation Lead Perspective**: -- Focus: Emerging trends, disruptive technologies, future opportunities -- Questions: What's the innovation potential? What trends are relevant? -- Output: Technology roadmaps, trend analysis, innovation opportunities - -### Creative Technique Application - -**SCAMPER Method**: -- **Substitute**: What can be substituted or replaced? -- **Combine**: What can be combined or merged? -- **Adapt**: What can be adapted from elsewhere? -- **Modify**: What can be magnified, minimized, or modified? -- **Put to other uses**: How else can this be used? -- **Eliminate**: What can be removed or simplified? -- **Reverse**: What can be rearranged or reversed? - -**Six Thinking Hats**: -- **White Hat**: Facts, information, data -- **Red Hat**: Emotions, feelings, intuition -- **Black Hat**: Critical judgment, caution, problems -- **Yellow Hat**: Optimism, benefits, positive thinking -- **Green Hat**: Creativity, alternatives, new ideas -- **Blue Hat**: Process control, meta-thinking - -**Additional Techniques**: -- **Mind Mapping**: Visual idea exploration and connection -- **Brainstorming**: Free-flowing idea generation -- **Brainwriting**: Silent idea generation and building -- **Random Word**: Stimulus-based creative thinking -- **What If**: Scenario-based exploration -- **Assumption Challenging**: Question fundamental assumptions - -### Mode-Specific Execution - -**Creative Mode**: -- Emphasize divergent thinking and wild ideas -- Apply creative techniques extensively -- Encourage "what if" thinking and assumption challenging -- Focus on novel and unconventional solutions - -**Analytical Mode**: -- Use structured analysis frameworks -- Apply root cause analysis and logical thinking -- Emphasize evidence-based reasoning -- Focus on systematic problem-solving - -**Strategic Mode**: -- Apply strategic thinking frameworks -- Use systems thinking and long-term perspective -- Consider competitive dynamics and market forces -- Focus on strategic positioning and advantage +For detailed execution modes (Creative, Analytical, Strategic), see: +@~/.claude/workflows/brainstorming-framework.md#execution-modes ## Documentation Standards