Skip to content

Commit 17e8243

Browse files
catlog22claude
andcommitted
refactor: Update brainstorming workflow roles and documentation
Major role restructuring to improve workflow efficiency and clarity: ## New Roles Added (4) - product-owner: Backlog management and user story definition - scrum-master: Sprint planning and agile process facilitation - ux-expert: User experience optimization and usability testing - subject-matter-expert: Domain expertise and industry standards ## Roles Removed (5) - business-analyst → functionality split to product-owner and scrum-master - feature-planner → merged into product-owner responsibilities - innovation-lead → integrated into subject-matter-expert - security-expert → integrated into subject-matter-expert - user-researcher → merged into ux-expert ## Files Updated ### Command Files (.claude/commands/workflow/brainstorm/) - Created: product-owner.md, scrum-master.md, ux-expert.md, subject-matter-expert.md - Deleted: business-analyst.md, feature-planner.md, innovation-lead.md, security-expert.md, user-researcher.md - Updated: artifacts.md, auto-parallel.md, auto-squeeze.md, synthesis.md ### Planning Templates (.claude/workflows/cli-templates/planning-roles/) - Created: product-owner.md, scrum-master.md, ux-expert.md, subject-matter-expert.md - Archived: Moved 5 deprecated roles to _deprecated/ with migration guide - Added: _deprecated/README.md with deprecation details and migration paths ### Agent Configurations - Updated conceptual-planning-agent.md with new role mappings - Updated action-planning-agent.md with new role references ### Documentation - Updated README.md brainstorming role tables and descriptions - Updated README_CN.md with Chinese translations for new roles - Updated workflow documentation files with new role references ## Breaking Changes Commands for removed roles are no longer available. Use replacement roles: - /workflow:brainstorm:business-analyst → use product-owner or scrum-master - /workflow:brainstorm:feature-planner → use product-owner - /workflow:brainstorm:innovation-lead → use subject-matter-expert - /workflow:brainstorm:security-expert → use subject-matter-expert - /workflow:brainstorm:user-researcher → use ux-expert 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude <noreply@anthropic.com>
1 parent 35ef08f commit 17e8243

28 files changed

+1434
-1884
lines changed

.claude/agents/action-planning-agent.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -82,7 +82,7 @@ Phase 2: Document Generation (Autonomous Output)
8282
"topic_framework": ".workflow/WFS-auth/.brainstorming/topic-framework.md",
8383
"role_analyses": [
8484
".workflow/WFS-auth/.brainstorming/system-architect/analysis.md",
85-
".workflow/WFS-auth/.brainstorming/security-expert/analysis.md"
85+
".workflow/WFS-auth/.brainstorming/subject-matter-expert/analysis.md"
8686
]
8787
},
8888
"context_package": {

.claude/agents/conceptual-planning-agent.md

Lines changed: 8 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -90,13 +90,12 @@ def handle_brainstorm_assignment(prompt):
9090
|------|-------------------|--------------|-----------|
9191
| system-architect | architecture_patterns, scalability_analysis, integration_points | Technical design and system structure | `mcp__exa__get_code_context_exa("microservices patterns")` |
9292
| ui-designer | user_flow_patterns, component_reuse, design_system_compliance | UI/UX patterns and consistency | `mcp__exa__get_code_context_exa("React design system patterns")` |
93-
| business-analyst | process_optimization, cost_analysis, efficiency_metrics, workflow_patterns | Business process and ROI | `mcp__exa__get_code_context_exa("business workflow automation")` |
9493
| data-architect | data_models, flow_patterns, storage_optimization | Data structure and flow | `mcp__exa__get_code_context_exa("database schema patterns")` |
95-
| security-expert | vulnerability_assessment, threat_modeling, compliance_check | Security risks and compliance | `mcp__exa__get_code_context_exa("security authentication patterns")` |
96-
| user-researcher | usage_patterns, pain_points, behavior_analysis | User behavior and needs | `mcp__exa__get_code_context_exa("user research methodologies")` |
9794
| product-manager | feature_alignment, market_fit, competitive_analysis | Product strategy and positioning | `mcp__exa__get_code_context_exa("product management frameworks")` |
98-
| innovation-lead | emerging_patterns, technology_trends, disruption_potential | Innovation opportunities | `mcp__exa__get_code_context_exa("emerging technology trends")` |
99-
| feature-planner | implementation_complexity, dependency_mapping, risk_assessment | Development planning | `mcp__exa__get_code_context_exa("agile development patterns")` |
95+
| product-owner | backlog_management, user_stories, acceptance_criteria | Product backlog and prioritization | `mcp__exa__get_code_context_exa("product backlog management patterns")` |
96+
| scrum-master | sprint_planning, team_dynamics, process_optimization | Agile process and collaboration | `mcp__exa__get_code_context_exa("scrum agile methodologies")` |
97+
| ux-expert | usability_optimization, interaction_design, design_systems | User experience and interface | `mcp__exa__get_code_context_exa("UX design patterns")` |
98+
| subject-matter-expert | domain_standards, compliance, best_practices | Domain expertise and standards | `mcp__exa__get_code_context_exa("industry best practices standards")` |
10099

101100
### Output Integration
102101

@@ -134,12 +133,12 @@ When called, you receive:
134133
### Role Options Include:
135134
- `system-architect` - Technical architecture, scalability, integration
136135
- `ui-designer` - User experience, interface design, usability
136+
- `ux-expert` - User experience optimization, interaction design, design systems
137137
- `product-manager` - Business value, user needs, market positioning
138+
- `product-owner` - Backlog management, user stories, acceptance criteria
139+
- `scrum-master` - Sprint planning, team dynamics, agile process
138140
- `data-architect` - Data flow, storage, analytics
139-
- `security-expert` - Security implications, threat modeling, compliance
140-
- `user-researcher` - User behavior, pain points, research insights
141-
- `business-analyst` - Process optimization, efficiency, ROI
142-
- `innovation-lead` - Emerging trends, disruptive technologies
141+
- `subject-matter-expert` - Domain expertise, industry standards, compliance
143142
- `test-strategist` - Testing strategy and quality assurance
144143

145144
### Single Role Execution

.claude/commands/cli/execute.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -167,7 +167,7 @@ RULES: $(cat [task_template]) | Task type: [task_type], Scope: [task_scope]
167167
cd .workflow/WFS-123 && ~/.claude/scripts/gemini-wrapper --approval-mode yolo -p "
168168
PURPOSE: Implement user profile editing
169169
TASK: Execute IMPL-001 implementation
170-
CONTEXT: @{src/user/**/*} @{.brainstorming/feature-planner/analysis.md} @{CLAUDE.md}
170+
CONTEXT: @{src/user/**/*} @{.brainstorming/product-owner/analysis.md} @{CLAUDE.md}
171171
EXPECTED: Profile edit API, UI components, validation, tests
172172
RULES: $(cat ~/.claude/workflows/cli-templates/prompts/development/feature.txt) | Type: feature, Scope: user module
173173
"

.claude/commands/workflow/brainstorm/artifacts.md

Lines changed: 37 additions & 28 deletions
Original file line numberDiff line numberDiff line change
@@ -5,8 +5,8 @@ usage: /workflow:brainstorm:artifacts "<topic>" [--roles "role1,role2,role3"]
55
argument-hint: "topic or challenge description for framework generation"
66
examples:
77
- /workflow:brainstorm:artifacts "Build real-time collaboration feature"
8-
- /workflow:brainstorm:artifacts "Optimize database performance" --roles "system-architect,data-architect,security-expert"
9-
- /workflow:brainstorm:artifacts "Implement secure authentication system" --roles "ui-designer,security-expert,user-researcher"
8+
- /workflow:brainstorm:artifacts "Optimize database performance" --roles "system-architect,data-architect,subject-matter-expert"
9+
- /workflow:brainstorm:artifacts "Implement secure authentication system" --roles "ui-designer,ux-expert,subject-matter-expert"
1010
allowed-tools: TodoWrite(*), Read(*), Write(*), Bash(*), Glob(*)
1111
---
1212

@@ -109,7 +109,7 @@ Framework content adapts based on `--roles` parameter:
109109
- **Scope**: [Topic boundaries relevant to selected roles]
110110
- **Objectives**: [Goals from perspective of selected roles]
111111
- **Context**: [Background focusing on role-specific concerns]
112-
- **Target Roles**: ui-designer, system-architect, security-expert
112+
- **Target Roles**: ui-designer, system-architect, subject-matter-expert
113113

114114
## Role-Specific Discussion Points
115115

@@ -135,29 +135,29 @@ Framework content adapts based on `--roles` parameter:
135135
- What are the performance requirements?
136136
- What dependencies must be managed?
137137

138-
### For Security Expert
139-
1. **Security Requirements**
140-
- What are the key security concerns?
141-
- What threat vectors must be addressed?
142-
- What compliance requirements apply?
138+
### For Subject Matter Expert
139+
1. **Domain Expertise & Standards**
140+
- What industry standards and best practices apply?
141+
- What regulatory compliance requirements exist?
142+
- What domain-specific patterns should be followed?
143143

144-
2. **Security Implementation**
145-
- What authentication/authorization is needed?
146-
- What data protection mechanisms are required?
147-
- How to handle security incidents?
144+
2. **Technical Quality & Risk**
145+
- What technical debt considerations exist?
146+
- What scalability and maintenance implications apply?
147+
- What knowledge transfer and documentation is needed?
148148

149149
## Cross-Role Integration Points
150150
- How do UI decisions impact architecture?
151151
- How does architecture constrain UI possibilities?
152-
- What security requirements affect both UI and architecture?
152+
- What domain standards affect both UI and architecture?
153153

154154
## Framework Usage
155155
**For Role Agents**: Address your specific section + integration points
156156
**Reference Format**: @../topic-framework.md in your analysis.md
157157
**Update Process**: Use /workflow:brainstorm:artifacts to update
158158

159159
---
160-
*Generated for roles: ui-designer, system-architect, security-expert*
160+
*Generated for roles: ui-designer, system-architect, subject-matter-expert*
161161
*Last updated: [timestamp]*
162162
```
163163

@@ -200,9 +200,9 @@ Framework content adapts based on `--roles` parameter:
200200

201201
## Available Role Perspectives
202202
Framework supports analysis from any of these roles:
203-
- system-architect, ui-designer, security-expert
204-
- user-researcher, product-manager, business-analyst
205-
- data-architect, innovation-lead, feature-planner
203+
- **Technical**: system-architect, data-architect, subject-matter-expert
204+
- **Product & Design**: ui-designer, ux-expert, product-manager, product-owner
205+
- **Agile & Quality**: scrum-master, test-strategist
206206

207207
---
208208
*Comprehensive framework - adaptable to any role*
@@ -216,17 +216,17 @@ Framework supports analysis from any of these roles:
216216
**Technical Roles**:
217217
- `system-architect`: Architecture patterns, scalability, technology stack, integration
218218
- `data-architect`: Data modeling, processing workflows, analytics, storage
219-
- `security-expert`: Security requirements, threat modeling, compliance, protection
219+
- `subject-matter-expert`: Domain expertise, industry standards, compliance, best practices
220220

221221
**Product & Design Roles**:
222222
- `ui-designer`: User interface, visual design, interaction patterns, accessibility
223-
- `user-researcher`: User needs, behavior analysis, usability testing, personas
223+
- `ux-expert`: User experience optimization, usability testing, interaction design, design systems
224224
- `product-manager`: Business value, feature prioritization, market positioning, roadmap
225+
- `product-owner`: Backlog management, user stories, acceptance criteria, stakeholder alignment
225226

226-
**Business Roles**:
227-
- `business-analyst`: Process optimization, requirements analysis, cost-benefit, ROI
228-
- `innovation-lead`: Emerging technologies, competitive advantage, transformation, trends
229-
- `feature-planner`: Feature specification, user stories, acceptance criteria, dependencies
227+
**Agile & Quality Roles**:
228+
- `scrum-master`: Sprint planning, team dynamics, process optimization, delivery management
229+
- `test-strategist`: Testing strategies, quality assurance, test automation, validation approaches
230230

231231
### Dynamic Discussion Point Generation
232232

@@ -248,23 +248,32 @@ Generate:
248248

249249
#### Example 1: Architecture-Heavy Topic
250250
```bash
251-
/workflow:brainstorm:artifacts "Design scalable microservices platform" --roles "system-architect,data-architect,security-expert"
251+
/workflow:brainstorm:artifacts "Design scalable microservices platform" --roles "system-architect,data-architect,subject-matter-expert"
252252
```
253253
**Generated framework focuses on**:
254254
- Service architecture and communication patterns
255255
- Data flow and storage strategies
256-
- Security boundaries and authentication
256+
- Domain standards and best practices
257257

258258
#### Example 2: User-Focused Topic
259259
```bash
260-
/workflow:brainstorm:artifacts "Improve user onboarding experience" --roles "ui-designer,user-researcher,product-manager"
260+
/workflow:brainstorm:artifacts "Improve user onboarding experience" --roles "ui-designer,ux-expert,product-manager"
261261
```
262262
**Generated framework focuses on**:
263263
- Onboarding flow and UI components
264-
- User behavior and pain points
264+
- User experience optimization and usability
265265
- Business value and success metrics
266266

267-
#### Example 3: Comprehensive Analysis
267+
#### Example 3: Agile Delivery Topic
268+
```bash
269+
/workflow:brainstorm:artifacts "Optimize sprint delivery process" --roles "scrum-master,product-owner,test-strategist"
270+
```
271+
**Generated framework focuses on**:
272+
- Sprint planning and team collaboration
273+
- Backlog management and prioritization
274+
- Quality assurance and testing strategies
275+
276+
#### Example 4: Comprehensive Analysis
268277
```bash
269278
/workflow:brainstorm:artifacts "Build real-time collaboration feature"
270279
```

.claude/commands/workflow/brainstorm/auto-parallel.md

Lines changed: 9 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -18,15 +18,17 @@ allowed-tools: SlashCommand(*), Task(*), TodoWrite(*), Read(*), Write(*), Bash(*
1818
```
1919

2020
## Role Selection Logic
21-
- **Technical & Architecture**: `architecture|system|performance|database|security` → system-architect, data-architect, security-expert
22-
- **Product & UX**: `user|ui|ux|interface|design|product|feature` → ui-designer, user-researcher, product-manager
21+
- **Technical & Architecture**: `architecture|system|performance|database|security` → system-architect, data-architect, security-expert, subject-matter-expert
22+
- **Product & UX**: `user|ui|ux|interface|design|product|feature|experience` → ui-designer, user-researcher, product-manager, ux-expert, product-owner
2323
- **Business & Process**: `business|process|workflow|cost|innovation|testing` → business-analyst, innovation-lead, test-strategist
24+
- **Agile & Delivery**: `agile|sprint|scrum|team|collaboration|delivery` → scrum-master, product-owner
25+
- **Domain Expertise**: `domain|standard|compliance|expertise|regulation` → subject-matter-expert
2426
- **Multi-role**: Complex topics automatically select 2-3 complementary roles
2527
- **Default**: `product-manager` if no clear match
2628

2729
**Template Loading**: `bash($(cat "~/.claude/workflows/cli-templates/planning-roles/<role-name>.md"))`
2830
**Template Source**: `.claude/workflows/cli-templates/planning-roles/`
29-
**Available Roles**: business-analyst, data-architect, feature-planner, innovation-lead, product-manager, security-expert, system-architect, test-strategist, ui-designer, user-researcher
31+
**Available Roles**: data-architect, product-manager, product-owner, scrum-master, subject-matter-expert, system-architect, test-strategist, ui-designer, ux-expert
3032

3133
**Example**:
3234
```bash
@@ -72,9 +74,10 @@ Auto command coordinates independent specialized commands:
7274
4. **Command coordination**: SlashCommand handles execution and validation
7375

7476
**Role Selection Logic**:
75-
- **Technical**: `architecture|system|performance|database|security` → system-architect, data-architect, security-expert
76-
- **Product & UX**: `user|ui|ux|interface|design|product|feature` → ui-designer, user-researcher, product-manager
77-
- **Business**: `business|process|workflow|cost|innovation` → business-analyst, innovation-lead
77+
- **Technical**: `architecture|system|performance|database` → system-architect, data-architect, subject-matter-expert
78+
- **Product & UX**: `user|ui|ux|interface|design|product|feature|experience` → ui-designer, ux-expert, product-manager, product-owner
79+
- **Agile & Delivery**: `agile|sprint|scrum|team|collaboration|delivery` → scrum-master, product-owner
80+
- **Domain Expertise**: `domain|standard|compliance|expertise|regulation` → subject-matter-expert
7881
- **Auto-select**: 2-3 most relevant roles based on topic analysis
7982

8083
### Simplified Processing Standards

.claude/commands/workflow/brainstorm/auto-squeeze.md

Lines changed: 23 additions & 23 deletions
Original file line numberDiff line numberDiff line change
@@ -61,16 +61,16 @@ Use keyword analysis to auto-select 2-3 roles:
6161

6262
**Role Selection Logic**:
6363
- **Technical/Architecture keywords**: `architecture|system|performance|database|api|backend|scalability`
64-
→ system-architect, data-architect, security-expert
64+
→ system-architect, data-architect, subject-matter-expert
6565
- **UI/UX keywords**: `user|ui|ux|interface|design|frontend|experience`
66-
→ ui-designer, user-researcher
66+
→ ui-designer, ux-expert
6767
- **Product/Business keywords**: `product|feature|business|workflow|process|customer`
68-
→ product-manager, business-analyst
69-
- **Security keywords**: `security|auth|permission|encryption|compliance`
70-
security-expert
71-
- **Innovation keywords**: `innovation|new|disrupt|transform|emerging`
72-
innovation-lead
73-
- **Default**: ui-designer (if no clear match)
68+
→ product-manager, product-owner
69+
- **Agile/Delivery keywords**: `agile|sprint|scrum|team|collaboration|delivery`
70+
scrum-master, product-owner
71+
- **Domain Expertise keywords**: `domain|standard|compliance|expertise|regulation`
72+
subject-matter-expert
73+
- **Default**: product-manager (if no clear match)
7474

7575
**Selection Rules**:
7676
- Maximum 3 roles
@@ -91,14 +91,14 @@ Execute each selected role command one by one:
9191

9292
**Commands**:
9393
- `SlashCommand(command="/workflow:brainstorm:ui-designer")`
94+
- `SlashCommand(command="/workflow:brainstorm:ux-expert")`
9495
- `SlashCommand(command="/workflow:brainstorm:system-architect")`
95-
- `SlashCommand(command="/workflow:brainstorm:security-expert")`
96-
- `SlashCommand(command="/workflow:brainstorm:user-researcher")`
97-
- `SlashCommand(command="/workflow:brainstorm:product-manager")`
98-
- `SlashCommand(command="/workflow:brainstorm:business-analyst")`
9996
- `SlashCommand(command="/workflow:brainstorm:data-architect")`
100-
- `SlashCommand(command="/workflow:brainstorm:innovation-lead")`
101-
- `SlashCommand(command="/workflow:brainstorm:feature-planner")`
97+
- `SlashCommand(command="/workflow:brainstorm:product-manager")`
98+
- `SlashCommand(command="/workflow:brainstorm:product-owner")`
99+
- `SlashCommand(command="/workflow:brainstorm:scrum-master")`
100+
- `SlashCommand(command="/workflow:brainstorm:subject-matter-expert")`
101+
- `SlashCommand(command="/workflow:brainstorm:test-strategist")`
102102

103103
**Validation** (after each role):
104104
- File `.workflow/[session]/.brainstorming/[role]/analysis.md` exists
@@ -202,24 +202,24 @@ Return summary to user
202202
**Keywords detected**: user, interface, design
203203
**Selected roles**:
204204
- ui-designer (primary: UI/UX match)
205-
- user-researcher (secondary: user experience)
206-
- security-expert (complementary: auth security)
205+
- ux-expert (secondary: user experience)
206+
- subject-matter-expert (complementary: auth standards)
207207

208208
### Example 2: Architecture Topic
209209
**Topic**: "Design scalable microservices architecture"
210210
**Keywords detected**: architecture, scalable, system
211211
**Selected roles**:
212212
- system-architect (primary: architecture match)
213213
- data-architect (secondary: scalability/data)
214-
- security-expert (complementary: system security)
214+
- subject-matter-expert (complementary: domain expertise)
215215

216-
### Example 3: Business Process Topic
217-
**Topic**: "Optimize customer onboarding workflow"
218-
**Keywords detected**: workflow, process, customer
216+
### Example 3: Agile Delivery Topic
217+
**Topic**: "Optimize team sprint planning and delivery process"
218+
**Keywords detected**: sprint, team, delivery, process
219219
**Selected roles**:
220-
- business-analyst (primary: process match)
221-
- product-manager (secondary: customer focus)
222-
- ui-designer (complementary: user experience)
220+
- scrum-master (primary: agile process match)
221+
- product-owner (secondary: backlog/delivery focus)
222+
- product-manager (complementary: product strategy)
223223

224224
## Error Handling
225225

0 commit comments

Comments
 (0)