Claude-Code-Workflow/.claude/commands/workflow/brainstorm/synthesis.md

name, description, usage, argument-hint, examples, allowed-tools

name	description	usage	argument-hint	examples	allowed-tools
synthesis	Generate synthesis-report.md from topic-framework and role analyses with @ references	/workflow:brainstorm:synthesis	no arguments required - synthesizes existing framework and role analyses	/workflow:brainstorm:synthesis	Read(*), Write(*), TodoWrite(*), Glob(*)

🧩 Synthesis Document Generator

Core Function

Specialized command for generating synthesis-report.md that integrates topic-framework.md and all role analysis.md files using @ reference system. Creates comprehensive strategic analysis with cross-role insights.

Primary Capabilities

• Framework Integration: Reference topic-framework.md discussion points across all roles
• Role Analysis Integration: Consolidate all role/analysis.md files using @ references
• Cross-Framework Comparison: Compare how each role addressed framework discussion points
• @ Reference System: Create structured references to source documents
• Update Detection: Smart updates when new role analyses are added

Document Integration Model

Three-Document Reference System:

1. topic-framework.md → Structured discussion framework (input)
2. [role]/analysis.md → Role-specific analyses addressing framework (input)
3. synthesis-report.md → Integrated synthesis with @ references (output)

⚙️ Execution Protocol

⚠️ Direct Execution Only

DO NOT use Task tool or delegate to any agent - This is a document synthesis task using only Read/Write/Glob tools for aggregating existing analyses.

Phase 1: Document Discovery & Validation

# Detect active brainstorming session
CHECK: .workflow/.active-* marker files
IF active_session EXISTS:
    session_id = get_active_session()
    brainstorm_dir = .workflow/WFS-{session}/.brainstorming/
ELSE:
    ERROR: "No active brainstorming session found"
    EXIT

# Validate required documents
CHECK: brainstorm_dir/topic-framework.md
IF NOT EXISTS:
    ERROR: "topic-framework.md not found. Run /workflow:brainstorm:artifacts first"
    EXIT

Phase 2: Role Analysis Discovery

# Discover available role analyses
SCAN_DIRECTORY: .workflow/WFS-{session}/.brainstorming/
FIND_ANALYSES: [
    */analysis.md files in role directories
]
LOAD_DOCUMENTS: {
    "topic_framework": topic-framework.md,
    "role_analyses": [discovered analysis.md files],
    "existing_synthesis": synthesis-report.md (if exists)
}

Phase 3: Update Mechanism Check

# Check for existing synthesis
IF synthesis-report.md EXISTS:
    SHOW current synthesis summary to user
    ASK: "Synthesis exists. Do you want to:"
    OPTIONS:
      1. "Regenerate completely" → Create new synthesis
      2. "Update with new analyses" → Integrate new role analyses
      3. "Preserve existing" → Exit without changes
ELSE:
    CREATE new synthesis

Phase 4: Synthesis Generation Process

Initialize synthesis task tracking:

[
  {"content": "Validate topic-framework.md and role analyses availability", "status": "in_progress", "activeForm": "Validating source documents"},
  {"content": "Load topic framework discussion points structure", "status": "pending", "activeForm": "Loading framework structure"},
  {"content": "Cross-analyze role responses to each framework point", "status": "pending", "activeForm": "Cross-analyzing framework responses"},
  {"content": "Generate synthesis-report.md with @ references", "status": "pending", "activeForm": "Generating synthesis with references"},
  {"content": "Update session metadata with synthesis completion", "status": "pending", "activeForm": "Updating session metadata"}
]

Phase 4: Cross-Role Analysis Execution

4.1 Data Collection and Preprocessing

FOR each role_directory in brainstorming_roles:
    IF role_directory exists:
        role_analysis = Read(role_directory + "/analysis.md")
        role_recommendations = Read(role_directory + "/recommendations.md") IF EXISTS
        role_insights[role] = extract_key_insights(role_analysis)
        role_recommendations[role] = extract_recommendations(role_analysis)
        role_concerns[role] = extract_concerns_risks(role_analysis)
    END IF
END FOR

4.2 Cross-Role Insight Analysis

# Consensus identification
consensus_areas = identify_common_themes(role_insights)
agreement_matrix = create_agreement_matrix(role_recommendations)

# Disagreement analysis
disagreement_areas = identify_conflicting_views(role_insights)
tension_points = analyze_role_conflicts(role_recommendations)

# Innovation opportunity extraction
innovation_opportunities = extract_breakthrough_ideas(role_insights)
synergy_opportunities = identify_cross_role_synergies(role_insights)

4.3 Priority and Decision Matrix Generation

# Create comprehensive evaluation matrix
FOR each recommendation:
    impact_score = calculate_business_impact(recommendation, role_insights)
    feasibility_score = calculate_technical_feasibility(recommendation, role_insights)
    effort_score = calculate_implementation_effort(recommendation, role_insights)
    risk_score = calculate_associated_risks(recommendation, role_insights)
    
    priority_score = weighted_score(impact_score, feasibility_score, effort_score, risk_score)
END FOR

SORT recommendations BY priority_score DESC

📊 Output Specification

Output Location

.workflow/WFS-{topic-slug}/.brainstorming/
├── topic-framework.md          # Input: Framework structure
├── [role]/analysis.md          # Input: Role analyses (multiple)
└── synthesis-report.md         # ★ OUTPUT: Integrated synthesis with @ references

Streamlined Single-Document Output ⚠️ SIMPLIFIED STRUCTURE

Output Document - Single Comprehensive Synthesis

The synthesis process creates one consolidated document that integrates all role perspectives:

.workflow/WFS-{topic-slug}/.brainstorming/
├── topic-framework.md          # Input: Framework structure
├── [role]/analysis.md          # Input: Role analyses (multiple)
└── synthesis-specification.md  # ★ OUTPUT: Complete integrated specification

synthesis-specification.md Structure (Complete Specification)

# [Topic] - Integrated Implementation Specification

**Framework Reference**: @topic-framework.md | **Generated**: [timestamp] | **Session**: WFS-[topic-slug]
**Source Integration**: All brainstorming role perspectives consolidated

## Executive Summary
Strategic overview with key insights, breakthrough opportunities, and implementation priorities.

## Requirements & Acceptance Criteria
### Functional Requirements
| ID | Description | Source | Priority | Acceptance | Dependencies |
|----|-------------|--------|----------|------------|--------------|
| FR-01 | Core feature | @role/analysis.md | High | Criteria | None |

### Non-Functional Requirements
| ID | Description | Target | Validation |
|----|-------------|--------|------------|
| NFR-01 | Performance | <200ms | Testing |

### Business Requirements
| ID | Description | Value | Success Metric |
|----|-------------|-------|----------------|
| BR-01 | User engagement | High | 80% retention |

## Design Specifications
### UI/UX Guidelines
**Consolidated from**: @ui-designer/analysis.md, @ux-expert/analysis.md
- Component specifications and interaction patterns
- Visual design system and accessibility requirements
- User flow and interface specifications

### Architecture Design
**Consolidated from**: @system-architect/analysis.md, @data-architect/analysis.md
- System architecture and component interactions
- Data flow and storage strategy
- Technology stack decisions

### Domain Expertise & Standards
**Consolidated from**: @subject-matter-expert/analysis.md
- Industry standards and best practices
- Compliance requirements and regulations
- Technical quality and domain-specific patterns

## Implementation Roadmap
### Development Phases
**Phase 1** (0-3 months): Foundation and core features
**Phase 2** (3-6 months): Advanced features and integrations
**Phase 3** (6+ months): Optimization and innovation

### Technical Guidelines
- Development standards and code organization
- Testing strategy and quality assurance
- Deployment and monitoring approach

### Task Breakdown
- Epic and feature mapping aligned with requirements
- Sprint planning guidance with dependency management
- Resource allocation and timeline recommendations

## Risk Assessment & Mitigation
### Critical Risks Identified
1. **Risk**: Description | **Mitigation**: Strategy
2. **Risk**: Description | **Mitigation**: Strategy

### Success Factors
- Key factors for implementation success
- Continuous monitoring requirements
- Quality gates and validation checkpoints

---
*Complete implementation specification consolidating all role perspectives into actionable guidance*

🔄 Session Integration

Streamlined Status Synchronization

Upon completion, update workflow-session.json:

{
  "phases": {
    "BRAINSTORM": {
      "status": "completed",
      "synthesis_completed": true,
      "completed_at": "timestamp",
      "participating_roles": ["product-manager", "product-owner", "scrum-master", "system-architect", "ui-designer", "ux-expert", "data-architect", "subject-matter-expert", "test-strategist"],
      "consolidated_output": {
        "synthesis_specification": ".workflow/WFS-{topic}/.brainstorming/synthesis-specification.md"
      },
      "synthesis_quality": {
        "role_integration": "complete",
        "requirement_coverage": "comprehensive",
        "implementation_readiness": "ready"
      },
      "content_metrics": {
        "roles_synthesized": 9,
        "functional_requirements": 25,
        "non_functional_requirements": 12,
        "business_requirements": 8,
        "implementation_phases": 3,
        "risk_factors_identified": 8
      }
    }
  }
}

✅ Quality Assurance

Required Synthesis Elements

• Integration of all available role analyses with comprehensive coverage
• Clear identification of consensus areas and disagreement points
• Quantified priority recommendation matrix with evaluation criteria
• Actionable implementation plan with phased approach
• Comprehensive risk assessment with mitigation strategies

Synthesis Analysis Quality Standards

• Completeness: Integrates all available role analyses without gaps
• Insight Generation: Identifies cross-role patterns and deep insights
• Actionability: Provides specific, executable recommendations and next steps
• Balance: Considers all role perspectives and addresses concerns
• Forward-Looking: Includes long-term strategic and innovation considerations

Output Validation Criteria

• Priority-Based: Recommendations prioritized using multi-dimensional evaluation
• Resource-Aware: Implementation plans consider resource and time constraints
• Risk-Managed: Comprehensive risk assessment with mitigation strategies
• Measurable Success: Clear success metrics and monitoring frameworks
• Clear Actions: Specific next steps with assigned responsibilities and timelines

Integration Excellence Standards

• Cross-Role Synthesis: Successfully identifies and resolves role perspective conflicts
• Strategic Coherence: Recommendations form coherent strategic direction
• Implementation Readiness: Plans are detailed enough for immediate execution
• Stakeholder Alignment: Addresses needs and concerns of all key stakeholders
• Continuous Improvement: Establishes framework for ongoing optimization and learning