Claude-Code-Workflow/.claude/workflows/conceptual-planning-agent.md

# 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.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`

### 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:**
1. **Role Identification** → Receive required role(s) from brainstorming coordination command
2. **Template Loading** → Use Bash tool to execute `~/.claude/scripts/plan-executor.sh [role]`
3. **Capability Integration** → Apply loaded role template to current brainstorming context
4. **Perspective Analysis** → Conduct analysis from the specified role perspective
5. **Multi-Role Synthesis** → When multiple roles specified, integrate perspectives coherently

**Supported Roles:**
- `product-manager`, `system-architect`, `ui-designer`, `data-architect`
- `security-expert`, `user-researcher`, `business-analyst`, `innovation-lead`
- `feature-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:
1. Load each required role template sequentially
2. Apply each perspective to the brainstorming topic
3. Synthesize insights across all loaded perspectives
4. Identify convergent themes and resolve conflicts
5. 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
1. **Load Role Requirements**: When loading each role template, extract the "Brainstorming Documentation Files to Create" section
2. **Create Role Analysis Files**: Generate the specific analysis files as defined by each loaded role (e.g., `product-manager-analysis.md`)
3. **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.