docs updates

src/modules/bmm/workflows/1-analysis/brainstorm-project/README.md

@@ -1,29 +1,113 @@
----
-last-redoc-date: 2025-10-01
----
-
 # Project Brainstorming Workflow
 
-This workflow facilitates structured ideation for non-game software projects through systematic exploration of problem spaces, architectures, and implementation strategies. Unlike traditional requirement gathering, it employs creative techniques to uncover non-obvious approaches and identify innovative solutions that address core business needs while considering technical constraints and organizational capabilities.
+Structured ideation for software projects exploring problem spaces, architectures, and innovative solutions beyond traditional requirements gathering.
 
-The workflow operates through a project-specific context framework that captures business objectives, technical environment, stakeholder needs, and organizational constraints. It generates multiple solution vectors through parallel ideation tracks: architectural approaches, user experience paradigms, integration patterns, and value delivery mechanisms. Each track produces concrete proposals that are evaluated against feasibility, impact, and alignment with strategic objectives.
+## Table of Contents
 
-Critical differentiators include its focus on solution innovation rather than requirement enumeration, emphasis on technical-business alignment from inception, and structured approach to surfacing hidden assumptions. The workflow produces actionable outputs that directly feed into Product Brief development, ensuring that creative exploration translates into concrete planning artifacts.
+- [Purpose](#purpose)
+- [Usage](#usage)
+- [Process](#process)
+- [Inputs & Outputs](#inputs--outputs)
+- [Integration](#integration)
+
+## Purpose
+
+Generate multiple solution approaches for software projects through:
+
+- Parallel ideation tracks (architecture, UX, integration, value delivery)
+- Technical-business alignment from inception
+- Hidden assumption discovery
+- Innovation beyond obvious solutions
 
 ## Usage
 
 ```bash
-bmad bmm 1-analysis brainstorm-project
+# Run brainstorming session
+bmad bmm *brainstorm-project
+
+# Or via Analyst agent
+*brainstorm-project
 ```
 
-## Inputs
+## Process
 
-- **Project Context Document**: Business objectives, technical environment, stakeholder landscape, organizational constraints, success criteria, and known pain points
-- **Problem Statement** (optional): Core business challenge or opportunity driving the project
+### 1. Context Capture
 
-## Outputs
+- Business objectives and constraints
+- Technical environment
+- Stakeholder needs
+- Success criteria
 
-- **Architecture Proposals**: Multiple technical approaches with trade-off analysis and feasibility assessments
-- **Value Delivery Framework**: Prioritized feature concepts aligned with business objectives and user needs
-- **Risk and Opportunity Analysis**: Identified technical dependencies, integration challenges, and innovation opportunities
-- **Strategic Recommendation**: Synthesized direction with rationale and implementation considerations
+### 2. Parallel Ideation
+
+- **Architecture Track**: Technical approaches with trade-offs
+- **UX Track**: Interface paradigms and user journeys
+- **Integration Track**: System connection patterns
+- **Value Track**: Feature prioritization and delivery
+
+### 3. Solution Synthesis
+
+- Evaluate feasibility and impact
+- Align with strategic objectives
+- Surface hidden assumptions
+- Generate recommendations
+
+## Inputs & Outputs
+
+### Inputs
+
+| Input             | Type     | Purpose                                       |
+| ----------------- | -------- | --------------------------------------------- |
+| Project Context   | Document | Business objectives, environment, constraints |
+| Problem Statement | Optional | Core challenge or opportunity                 |
+
+### Outputs
+
+| Output                   | Content                                     |
+| ------------------------ | ------------------------------------------- |
+| Architecture Proposals   | Multiple approaches with trade-off analysis |
+| Value Framework          | Prioritized features aligned to objectives  |
+| Risk Analysis            | Dependencies, challenges, opportunities     |
+| Strategic Recommendation | Synthesized direction with rationale        |
+
+## Integration
+
+### Workflow Chain
+
+1. **brainstorm-project** ← Current step
+2. research (optional deep dive)
+3. product-brief (strategic document)
+4. Phase 2 planning (PRD/tech-spec)
+
+### Feed Into
+
+- Product Brief development
+- Architecture decisions
+- PRD requirements
+- Epic prioritization
+
+## Best Practices
+
+1. **Prepare context** - Gather business and technical background
+2. **Think broadly** - Explore non-obvious approaches
+3. **Document assumptions** - Capture implicit beliefs
+4. **Consider constraints** - Technical, organizational, resource
+5. **Focus on value** - Align to business objectives
+
+## Configuration
+
+```yaml
+# bmad/bmm/config.yaml
+output_folder: ./output
+project_name: Your Project
+```
+
+## Related Workflows
+
+- [Research](../research/README.md) - Deep investigation
+- [Product Brief](../product-brief/README.md) - Strategic planning
+- [PRD](../../2-plan-workflows/prd/README.md) - Requirements document
+
+---
+
+Part of BMad Method v6 - Phase 1 Analysis workflows