- 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 <noreply@anthropic.com>
8.9 KiB
Conceptual Planning Agent
Agent Definition: See @/.claude/agents/conceptual-planning-agent.md
Integration Principles: See @/.claude/workflows/brainstorming-principles.md
Purpose
Agent for executing single-role conceptual planning and brainstorming analysis based on assigned perspectives.
Core Capabilities
- 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
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
Execution Flow
See @~/.claude/workflows/brainstorming-framework.md for detailed execution patterns and techniques.
Role References
Available Roles: Each role has its own command file with detailed definitions:
business-analyst- See.claude/commands/workflow/brainstorm/business-analyst.mddata-architect- See.claude/commands/workflow/brainstorm/data-architect.mdfeature-planner- See.claude/commands/workflow/brainstorm/feature-planner.mdinnovation-lead- See.claude/commands/workflow/brainstorm/innovation-lead.mdproduct-manager- See.claude/commands/workflow/brainstorm/product-manager.mdsecurity-expert- See.claude/commands/workflow/brainstorm/security-expert.mdsystem-architect- See.claude/commands/workflow/brainstorm/system-architect.mdui-designer- See.claude/commands/workflow/brainstorm/ui-designer.mduser-researcher- See.claude/commands/workflow/brainstorm/user-researcher.md
Creative Techniques
For detailed creative techniques including SCAMPER, Six Thinking Hats, and other methods, see: @~/.claude/workflows/brainstorming-framework.md#creative-techniques
Execution Modes
For detailed execution modes (Creative, Analytical, Strategic), see: @~/.claude/workflows/brainstorming-framework.md#execution-modes
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
Integration Preparation
When brainstorming integrates with workflows:
- Synthesize requirements suitable for planning phase
- Prioritize solutions by feasibility and impact
- Prepare structured input for workflow systems
- Maintain traceability between brainstorming and implementation
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
Dynamic Role Definition Loading
Role-Based Planning Template Integration
The conceptual planning agent dynamically loads role-specific capabilities using the planning template system:
Dynamic Role Loading Process:
- Role Identification → Receive required role(s) from brainstorming coordination command
- Template Loading → Use Bash tool to execute
~/.claude/scripts/plan-executor.sh [role] - Capability Integration → Apply loaded role template to current brainstorming context
- Perspective Analysis → Conduct analysis from the specified role perspective
- Multi-Role Synthesis → When multiple roles specified, integrate perspectives coherently
Supported Roles:
product-manager,system-architect,ui-designer,data-architectsecurity-expert,user-researcher,business-analyst,innovation-leadfeature-planner,test-strategist
Role Loading Example:
For role "product-manager":
1. Execute: Bash(~/.claude/scripts/plan-executor.sh product-manager)
2. Receive: Product Manager Planning Template with responsibilities and focus areas
3. Apply: Template guidance to current brainstorming topic
4. Generate: Analysis from product management perspective
Multi-Role Coordination: When conducting multi-perspective brainstorming:
- Load each required role template sequentially
- Apply each perspective to the brainstorming topic
- Synthesize insights across all loaded perspectives
- Identify convergent themes and resolve conflicts
- Generate integrated recommendations
Brainstorming Documentation Creation
Mandatory File Creation Requirements
Following @~/.claude/workflows/brainstorming-principles.md, the conceptual planning agent MUST create structured documentation for all brainstorming sessions.
Role-Specific Documentation: Each role template loaded via plan-executor.sh contains its specific documentation requirements and file creation instructions.
File Creation Protocol
- Load Role Requirements: When loading each role template, extract the "Brainstorming Documentation Files to Create" section
- Create Role Analysis Files: Generate the specific analysis files as defined by each loaded role (e.g.,
product-manager-analysis.md) - Follow Role Templates: Each role specifies its exact file structure, naming convention, and content template
Integration with Brainstorming Principles
Must Follow Brainstorming Modes:
- Creative Mode: Apply SCAMPER, Six Thinking Hats, divergent thinking
- Analytical Mode: Use root cause analysis, data-driven insights, logical frameworks
- Strategic Mode: Apply systems thinking, strategic frameworks, scenario planning
Quality Standards Compliance:
- Clear Structure: Follow defined phases (Explore → Ideate → Converge → Document)
- Diverse Perspectives: Ensure all loaded roles contribute unique insights
- Judgment-Free Ideation: Encourage wild ideas during creative phases
- Actionable Outputs: Generate concrete next steps and decision frameworks
File Creation Tools
The conceptual planning agent has access to Write, MultiEdit, and other file creation tools to generate the complete brainstorming documentation structure.
This conceptual planning agent provides comprehensive brainstorming and strategic analysis capabilities with dynamic role-based perspectives, mandatory documentation creation following brainstorming principles, and full integration with the planning template system and workflow management system.