@kood/claude-code 0.5.9 → 0.6.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (63) hide show
  1. package/dist/index.js +127 -135
  2. package/package.json +1 -1
  3. package/templates/.claude/agents/build-fixer.md +371 -0
  4. package/templates/.claude/agents/critic.md +223 -0
  5. package/templates/.claude/agents/deep-executor.md +320 -0
  6. package/templates/.claude/agents/dependency-manager.md +0 -1
  7. package/templates/.claude/agents/deployment-validator.md +0 -1
  8. package/templates/.claude/agents/designer.md +0 -1
  9. package/templates/.claude/agents/document-writer.md +0 -1
  10. package/templates/.claude/agents/git-operator.md +15 -0
  11. package/templates/.claude/agents/implementation-executor.md +0 -1
  12. package/templates/.claude/agents/ko-to-en-translator.md +0 -1
  13. package/templates/.claude/agents/lint-fixer.md +0 -1
  14. package/templates/.claude/agents/planner.md +11 -7
  15. package/templates/.claude/agents/qa-tester.md +488 -0
  16. package/templates/.claude/agents/researcher.md +189 -0
  17. package/templates/.claude/agents/scientist.md +544 -0
  18. package/templates/.claude/agents/security-reviewer.md +549 -0
  19. package/templates/.claude/agents/tdd-guide.md +413 -0
  20. package/templates/.claude/agents/vision.md +165 -0
  21. package/templates/.claude/commands/pre-deploy.md +79 -2
  22. package/templates/.claude/instructions/agent-patterns/model-routing.md +2 -2
  23. package/templates/.claude/skills/brainstorm/SKILL.md +889 -0
  24. package/templates/.claude/skills/bug-fix/SKILL.md +69 -0
  25. package/templates/.claude/skills/crawler/SKILL.md +156 -0
  26. package/templates/.claude/skills/crawler/references/anti-bot-checklist.md +162 -0
  27. package/templates/.claude/skills/crawler/references/code-templates.md +119 -0
  28. package/templates/.claude/skills/crawler/references/crawling-patterns.md +167 -0
  29. package/templates/.claude/skills/crawler/references/document-templates.md +147 -0
  30. package/templates/.claude/skills/crawler/references/network-crawling.md +141 -0
  31. package/templates/.claude/skills/crawler/references/playwriter-commands.md +172 -0
  32. package/templates/.claude/skills/crawler/references/pre-crawl-checklist.md +221 -0
  33. package/templates/.claude/skills/crawler/references/selector-strategies.md +140 -0
  34. package/templates/.claude/skills/execute/SKILL.md +5 -0
  35. package/templates/.claude/skills/feedback/SKILL.md +570 -0
  36. package/templates/.claude/skills/figma-to-code/SKILL.md +1 -0
  37. package/templates/.claude/skills/global-uiux-design/SKILL.md +1 -0
  38. package/templates/.claude/skills/korea-uiux-design/SKILL.md +1 -0
  39. package/templates/.claude/skills/nextjs-react-best-practices/SKILL.md +1 -0
  40. package/templates/.claude/skills/plan/SKILL.md +44 -0
  41. package/templates/.claude/skills/ralph/SKILL.md +16 -18
  42. package/templates/.claude/skills/refactor/SKILL.md +19 -0
  43. package/templates/.claude/skills/tanstack-start-react-best-practices/SKILL.md +1 -0
  44. package/templates/.claude/skills/stitch-design/README.md +0 -34
  45. package/templates/.claude/skills/stitch-design/SKILL.md +0 -213
  46. package/templates/.claude/skills/stitch-design/examples/DESIGN.md +0 -154
  47. package/templates/.claude/skills/stitch-loop/README.md +0 -54
  48. package/templates/.claude/skills/stitch-loop/SKILL.md +0 -316
  49. package/templates/.claude/skills/stitch-loop/examples/SITE.md +0 -73
  50. package/templates/.claude/skills/stitch-loop/examples/next-prompt.md +0 -25
  51. package/templates/.claude/skills/stitch-loop/resources/baton-schema.md +0 -61
  52. package/templates/.claude/skills/stitch-loop/resources/site-template.md +0 -104
  53. package/templates/.claude/skills/stitch-react/README.md +0 -36
  54. package/templates/.claude/skills/stitch-react/SKILL.md +0 -323
  55. package/templates/.claude/skills/stitch-react/examples/gold-standard-card.tsx +0 -88
  56. package/templates/.claude/skills/stitch-react/package-lock.json +0 -231
  57. package/templates/.claude/skills/stitch-react/package.json +0 -16
  58. package/templates/.claude/skills/stitch-react/resources/architecture-checklist.md +0 -15
  59. package/templates/.claude/skills/stitch-react/resources/component-template.tsx +0 -37
  60. package/templates/.claude/skills/stitch-react/resources/stitch-api-reference.md +0 -14
  61. package/templates/.claude/skills/stitch-react/resources/style-guide.json +0 -24
  62. package/templates/.claude/skills/stitch-react/scripts/fetch-stitch.sh +0 -30
  63. package/templates/.claude/skills/stitch-react/scripts/validate.js +0 -77
@@ -0,0 +1,889 @@
1
+ ---
2
+ name: brainstorm
3
+ description: 자료 수집 + 웹 검색 + 코드베이스 분석 기반 체계적 브레인스토밍. 아이디어 도출 및 구조화.
4
+ user-invocable: true
5
+ ---
6
+
7
+ @../../instructions/workflow-patterns/sequential-thinking.md
8
+ @../../instructions/agent-patterns/parallel-execution.md
9
+ @../../instructions/agent-patterns/model-routing.md
10
+ @../../instructions/validation/forbidden-patterns.md
11
+ @../../instructions/validation/required-behaviors.md
12
+
13
+ # Brainstorm Skill
14
+
15
+ > 자료 수집 + 웹 검색 + 코드베이스 분석 기반 체계적 브레인스토밍
16
+
17
+ ---
18
+
19
+ <when_to_use>
20
+
21
+ ## 사용 시점
22
+
23
+ | 상황 | 예시 |
24
+ |------|------|
25
+ | **신규 기능 아이디어** | "사용자 참여를 높일 방법" |
26
+ | **기술 선택** | "상태 관리 라이브러리 비교" |
27
+ | **UX 개선** | "온보딩 플로우 개선 방안" |
28
+ | **아키텍처 설계** | "마이크로서비스 분리 전략" |
29
+ | **문제 해결** | "성능 병목 해결 방법" |
30
+ | **시장 조사** | "경쟁사 기능 분석" |
31
+
32
+ ## 호출 방법
33
+
34
+ ```bash
35
+ # 기본 사용
36
+ /brainstorm 실시간 협업 기능 아이디어
37
+
38
+ # 특정 영역 지정
39
+ /brainstorm UX: 모바일 결제 플로우 개선
40
+
41
+ # 기술 비교
42
+ /brainstorm 기술: WebSocket vs SSE vs Long Polling
43
+ ```
44
+
45
+ ## 결과물
46
+
47
+ - 다각도 자료 수집 (웹, 코드베이스, 트렌드)
48
+ - 체계적 아이디어 목록 (카테고리별)
49
+ - 실행 가능성 평가 (노력/영향도 매트릭스)
50
+ - 추천 방향 및 다음 단계
51
+
52
+ </when_to_use>
53
+
54
+ ---
55
+
56
+ <argument_validation>
57
+
58
+ ## ARGUMENT 필수 확인
59
+
60
+ ```
61
+ $ARGUMENTS 없음 → 즉시 질문:
62
+
63
+ "어떤 주제로 브레인스토밍을 진행할까요?
64
+
65
+ 예시:
66
+ - 신규 기능: '사용자 참여를 높일 방법'
67
+ - 기술 선택: 'WebSocket vs SSE 비교'
68
+ - UX 개선: '온보딩 플로우 개선'
69
+ - 문제 해결: '성능 병목 해결'"
70
+
71
+ $ARGUMENTS 있음 → 다음 단계 진행
72
+ ```
73
+
74
+ </argument_validation>
75
+
76
+ ---
77
+
78
+ <workflow>
79
+
80
+ ## 실행 흐름
81
+
82
+ | 단계 | 작업 | 도구 |
83
+ |------|------|------|
84
+ | 1. 입력 확인 | ARGUMENT 검증 | - |
85
+ | 2. 주제 분석 | 브레인스토밍 범위 결정 | sequentialthinking (1-2단계) |
86
+ | 3. 자료 수집 | 병렬 정보 수집 (웹 + 코드베이스 + 트렌드) | Task 병렬 (researcher, explore) + WebSearch |
87
+ | 4. 아이디어 도출 | 수집 자료 기반 아이디어 생성 | sequentialthinking (3-5단계) |
88
+ | 5. 구조화 | 카테고리별 정리 + 실행 가능성 평가 | - |
89
+ | 6. 문서 저장 | `.claude/brainstorms/` 폴더에 결과 저장 | Write |
90
+ | 7. 결과 제시 | 아이디어 목록 + 추천 방향 + 파일 경로 안내 | - |
91
+
92
+ ### 복잡도별 사고 패턴
93
+
94
+ | 복잡도 | 사고 횟수 | 판단 기준 |
95
+ |--------|----------|----------|
96
+ | **간단** | 3 | 단일 영역, 명확한 범위 |
97
+ | **보통** | 5 | 다중 영역, 기술 + 비즈니스 고려 |
98
+ | **복잡** | 7+ | 아키텍처 결정, 다중 이해관계자 |
99
+
100
+ </workflow>
101
+
102
+ ---
103
+
104
+ <document_storage>
105
+
106
+ ## 결과 저장
107
+
108
+ ### 폴더 구조
109
+
110
+ 브레인스토밍 결과는 `.claude/brainstorms/` 폴더에 저장:
111
+
112
+ ```
113
+ .claude/brainstorms/
114
+ ├── 00.사용자_참여_향상.md
115
+ ├── 01.실시간_통신_기술_선택.md
116
+ ├── 02.모바일_결제_UX_개선.md
117
+ └── ...
118
+ ```
119
+
120
+ ### 파일명 형식
121
+
122
+ `[넘버링].[주제_요약].md`
123
+
124
+ - **넘버링**: 기존 파일 목록 조회 → 다음 번호 자동 부여 (00, 01, 02...)
125
+ - **주제 요약**: 한글, 언더스코어로 구분, 간결하게
126
+
127
+ ### 저장 워크플로우
128
+
129
+ ```typescript
130
+ // 1. 넘버링 결정
131
+ Bash("ls .claude/brainstorms/ 2>/dev/null | grep -E '^[0-9]+' | wc -l")
132
+ const nextNumber = "00" // 결과 기반 계산
133
+
134
+ // 2. 폴더 생성 (없으면)
135
+ Bash("mkdir -p .claude/brainstorms")
136
+
137
+ // 3. 결과 저장
138
+ Write({
139
+ file_path: `.claude/brainstorms/${nextNumber}.${주제_요약}.md`,
140
+ content: 브레인스토밍_결과
141
+ })
142
+
143
+ // 4. 사용자에게 경로 안내
144
+ "브레인스토밍 결과가 저장되었습니다: .claude/brainstorms/00.사용자_참여_향상.md"
145
+ ```
146
+
147
+ ### 저장 내용
148
+
149
+ | 섹션 | 내용 |
150
+ |------|------|
151
+ | **메타데이터** | 주제, 생성일, 관련 컨텍스트 |
152
+ | **수집 자료 요약** | 외부 트렌드, 경쟁사/사례, 현재 시스템 |
153
+ | **아이디어 목록** | 카테고리별 아이디어 + 노력/영향도 |
154
+ | **우선순위 매트릭스** | Quick Wins, Big Bets 분류 |
155
+ | **추천 방향** | 최우선 추천, 다음 단계 |
156
+
157
+ </document_storage>
158
+
159
+ ---
160
+
161
+ <parallel_agent_execution>
162
+
163
+ ## 병렬 Agent 실행
164
+
165
+ ### Recommended Agents
166
+
167
+ | Agent | Model | 용도 | 복잡도 |
168
+ |-------|-------|------|--------|
169
+ | **@researcher** | sonnet | 웹 조사, 외부 문서/API/트렌드 | MEDIUM |
170
+ | **@explore** | haiku | 코드베이스 탐색, 현재 구조 분석 | LOW |
171
+ | **@analyst** | sonnet | 요구사항 분석, 가정 검증 | MEDIUM |
172
+ | **@architect** | opus | 아키텍처 평가, 설계 방향 (READ-ONLY) | HIGH |
173
+ | **@designer** | sonnet | UI/UX 아이디어, 디자인 패턴 | MEDIUM |
174
+ | **@scientist** | sonnet | 데이터 분석 아이디어, 통계적 접근 | MEDIUM |
175
+
176
+ ---
177
+
178
+ ### 병렬 수집 패턴
179
+
180
+ **패턴 1: 다각도 자료 수집 (기본)**
181
+
182
+ ```typescript
183
+ // 웹 + 코드베이스 + 트렌드 동시 수집
184
+ Task({
185
+ subagent_type: 'researcher',
186
+ model: 'sonnet',
187
+ prompt: `
188
+ [주제]에 대한 외부 자료 조사:
189
+ - 최신 트렌드 및 베스트 프랙티스
190
+ - 경쟁사/유사 서비스 사례
191
+ - 기술 블로그, 문서, 아티클
192
+ `
193
+ })
194
+
195
+ Task({
196
+ subagent_type: 'explore',
197
+ model: 'haiku',
198
+ prompt: `
199
+ 현재 코드베이스에서 [주제] 관련 분석:
200
+ - 기존 구현 패턴
201
+ - 확장 가능한 포인트
202
+ - 제약사항
203
+ `
204
+ })
205
+
206
+ Task({
207
+ subagent_type: 'analyst',
208
+ model: 'sonnet',
209
+ prompt: `
210
+ [주제] 요구사항 분석:
211
+ - 사용자 니즈
212
+ - 비즈니스 목표
213
+ - 기술적 제약
214
+ `
215
+ })
216
+ ```
217
+
218
+ **효과:** 3방향 동시 조사 → 포괄적 정보 수집
219
+
220
+ ---
221
+
222
+ **패턴 2: 기술 비교 조사**
223
+
224
+ ```typescript
225
+ // 여러 기술 옵션 동시 조사
226
+ Task({
227
+ subagent_type: 'researcher',
228
+ model: 'sonnet',
229
+ prompt: '기술 A (WebSocket) 장단점, 사례, 성능 특성'
230
+ })
231
+
232
+ Task({
233
+ subagent_type: 'researcher',
234
+ model: 'sonnet',
235
+ prompt: '기술 B (SSE) 장단점, 사례, 성능 특성'
236
+ })
237
+
238
+ Task({
239
+ subagent_type: 'researcher',
240
+ model: 'sonnet',
241
+ prompt: '기술 C (Long Polling) 장단점, 사례, 성능 특성'
242
+ })
243
+
244
+ Task({
245
+ subagent_type: 'explore',
246
+ model: 'haiku',
247
+ prompt: '현재 프로젝트 통신 구조 및 요구사항 분석'
248
+ })
249
+ ```
250
+
251
+ **효과:** 기술 옵션 병렬 조사 → 공정한 비교
252
+
253
+ ---
254
+
255
+ **패턴 3: UX 아이디어 수집**
256
+
257
+ ```typescript
258
+ // UX 관점 다각도 수집
259
+ Task({
260
+ subagent_type: 'researcher',
261
+ model: 'sonnet',
262
+ prompt: `
263
+ [UX 주제] 관련 외부 사례:
264
+ - 유명 앱/서비스 UX 패턴
265
+ - 최신 UX 트렌드 (2024-2025)
266
+ - 사용자 리서치 결과
267
+ `
268
+ })
269
+
270
+ Task({
271
+ subagent_type: 'designer',
272
+ model: 'sonnet',
273
+ prompt: `
274
+ [UX 주제] 디자인 아이디어:
275
+ - 사용자 플로우 개선안
276
+ - 마이크로인터랙션 제안
277
+ - 접근성 고려사항
278
+ `
279
+ })
280
+
281
+ Task({
282
+ subagent_type: 'explore',
283
+ model: 'haiku',
284
+ prompt: '현재 UI 컴포넌트 및 디자인 시스템 분석'
285
+ })
286
+ ```
287
+
288
+ ---
289
+
290
+ **패턴 4: 아키텍처 브레인스토밍**
291
+
292
+ ```typescript
293
+ // 아키텍처 결정을 위한 심층 분석
294
+ Task({
295
+ subagent_type: 'architect',
296
+ model: 'opus',
297
+ prompt: `
298
+ [아키텍처 주제] 설계 방향 분석:
299
+ - 현재 구조의 장단점
300
+ - 확장성, 유지보수성 평가
301
+ - 대안 아키텍처 제안
302
+ `
303
+ })
304
+
305
+ Task({
306
+ subagent_type: 'researcher',
307
+ model: 'sonnet',
308
+ prompt: `
309
+ [아키텍처 주제] 업계 사례:
310
+ - 유사 규모 시스템 아키텍처
311
+ - 마이그레이션 사례
312
+ - 실패/성공 교훈
313
+ `
314
+ })
315
+
316
+ Task({
317
+ subagent_type: 'explore',
318
+ model: 'sonnet',
319
+ prompt: `
320
+ 현재 시스템 심층 분석:
321
+ - 모듈 의존성
322
+ - 데이터 흐름
323
+ - 병목 구간
324
+ `
325
+ })
326
+ ```
327
+
328
+ ---
329
+
330
+ **패턴 5: 문제 해결 아이디어**
331
+
332
+ ```typescript
333
+ // 문제 해결을 위한 다각도 접근
334
+ Task({
335
+ subagent_type: 'analyst',
336
+ model: 'sonnet',
337
+ prompt: `
338
+ [문제] 근본 원인 분석:
339
+ - 증상 vs 원인 구분
340
+ - 영향 범위 파악
341
+ - 가정 검증
342
+ `
343
+ })
344
+
345
+ Task({
346
+ subagent_type: 'researcher',
347
+ model: 'sonnet',
348
+ prompt: `
349
+ [문제] 유사 사례 및 해결책:
350
+ - 동일 문제 해결 사례
351
+ - 베스트 프랙티스
352
+ - 피해야 할 안티패턴
353
+ `
354
+ })
355
+
356
+ Task({
357
+ subagent_type: 'explore',
358
+ model: 'haiku',
359
+ prompt: `
360
+ [문제] 관련 코드 분석:
361
+ - 문제 발생 지점
362
+ - 관련 로직
363
+ - 수정 영향 범위
364
+ `
365
+ })
366
+ ```
367
+
368
+ ---
369
+
370
+ ### Model Routing
371
+
372
+ | 조사 유형 | 모델 | Agent | 이유 |
373
+ |----------|------|-------|------|
374
+ | **트렌드/사례** | sonnet | researcher | 외부 정보 종합 |
375
+ | **코드 탐색** | haiku | explore | 빠른 구조 파악 |
376
+ | **요구사항** | sonnet | analyst | 분석 품질 |
377
+ | **아키텍처** | opus | architect | 설계 깊이 |
378
+ | **UI/UX** | sonnet | designer | 창의성 + 실용성 |
379
+
380
+ </parallel_agent_execution>
381
+
382
+ ---
383
+
384
+ <ideation_framework>
385
+
386
+ ## 아이디어 도출 프레임워크
387
+
388
+ > AI에 최적화된 8가지 브레인스토밍 기법
389
+
390
+ ### 기법 선택 가이드
391
+
392
+ | 상황 | 추천 기법 |
393
+ |------|----------|
394
+ | **신규 기능 아이디어** | Tree of Thoughts, SCAMPER, Multi-Persona |
395
+ | **문제 해결** | Reverse Brainstorming, 5 Whys, Tree of Thoughts |
396
+ | **요구사항 발굴** | Starbursting (5W1H), How Might We |
397
+ | **아이디어 평가** | 6 Thinking Hats, Multi-Persona |
398
+ | **빠른 발상** | Crazy 8s, SCAMPER |
399
+ | **복잡한 의사결정** | Tree of Thoughts, 6 Thinking Hats |
400
+
401
+ ---
402
+
403
+ ### 1. Tree of Thoughts (ToT) ⭐ AI 핵심
404
+
405
+ > 여러 해결 경로를 동시에 탐색하고 평가하는 AI 특화 기법
406
+
407
+ **원리:** 선형적 사고 대신 트리 구조로 여러 아이디어 분기 → 평가 → 유망한 경로 확장
408
+
409
+ **AI 구현:**
410
+ ```
411
+ 단계 1: 문제를 3-5개 하위 문제로 분해
412
+ 단계 2: 각 하위 문제에 3-5개 해결 경로 생성 (병렬)
413
+ 단계 3: 각 경로 평가 (실현 가능성 1-5, 영향도 1-5)
414
+ 단계 4: 상위 경로 선택 및 심화 탐색
415
+ 단계 5: 최종 아이디어 종합
416
+ ```
417
+
418
+ **병렬 에이전트 패턴:**
419
+ ```typescript
420
+ // 여러 경로 동시 탐색
421
+ Task({ subagent_type: 'analyst', prompt: '경로 A: [접근법 1] 심층 분석' })
422
+ Task({ subagent_type: 'analyst', prompt: '경로 B: [접근법 2] 심층 분석' })
423
+ Task({ subagent_type: 'analyst', prompt: '경로 C: [접근법 3] 심층 분석' })
424
+ // → 결과 비교 후 유망 경로 선택
425
+ ```
426
+
427
+ **적합한 상황:** 복잡한 문제, 여러 해결책 비교, 의사결정
428
+
429
+ ---
430
+
431
+ ### 2. Multi-Persona Simulation ⭐ AI 핵심
432
+
433
+ > 여러 전문가/이해관계자 관점을 시뮬레이션하여 다각도 아이디어 생성
434
+
435
+ **페르소나 예시:**
436
+
437
+ | 페르소나 | 관점 | 질문 |
438
+ |---------|------|------|
439
+ | **CEO** | 비즈니스 가치 | ROI는? 시장 기회는? |
440
+ | **개발자** | 기술적 실현 | 구현 가능? 복잡도는? |
441
+ | **UX 디자이너** | 사용자 경험 | 직관적인가? 접근성은? |
442
+ | **고객** | 실제 사용 | 내 문제를 해결하나? |
443
+ | **비평가** | 약점/리스크 | 실패 시나리오는? |
444
+
445
+ **병렬 에이전트 패턴:**
446
+ ```typescript
447
+ // 여러 페르소나 동시 실행
448
+ Task({ subagent_type: 'analyst', prompt: 'CEO 관점: 비즈니스 가치 분석' })
449
+ Task({ subagent_type: 'architect', prompt: '개발자 관점: 기술적 실현 가능성' })
450
+ Task({ subagent_type: 'designer', prompt: 'UX 디자이너 관점: 사용자 경험' })
451
+ Task({ subagent_type: 'analyst', prompt: '고객 관점: 실제 사용 시나리오' })
452
+ Task({ subagent_type: 'analyst', prompt: '비평가 관점: 약점과 리스크' })
453
+ ```
454
+
455
+ **적합한 상황:** 다각도 검토, 이해관계자 분석, 제품 기획
456
+
457
+ ---
458
+
459
+ ### 3. SCAMPER 기법
460
+
461
+ > 7가지 질문으로 체계적 발상
462
+
463
+ | 기법 | 질문 | 예시 |
464
+ |------|------|------|
465
+ | **S**ubstitute | 대체할 수 있는 것? | 이메일 → 푸시 알림 |
466
+ | **C**ombine | 결합할 수 있는 것? | 검색 + 추천 |
467
+ | **A**dapt | 적용할 수 있는 것? | 다른 앱의 UX 패턴 |
468
+ | **M**odify | 수정/확대/축소? | 단계 축소, 기능 확대 |
469
+ | **P**ut to other uses | 다른 용도? | 분석 도구 → 마케팅 도구 |
470
+ | **E**liminate | 제거할 것? | 불필요한 단계 제거 |
471
+ | **R**earrange | 재배열/역순? | 플로우 순서 변경 |
472
+
473
+ **AI 적용:** 각 질문에 대해 3개 이상 아이디어 생성
474
+
475
+ ---
476
+
477
+ ### 4. Starbursting (5W1H)
478
+
479
+ > 질문 중심 브레인스토밍으로 요구사항 발굴
480
+
481
+ | 질문 | 탐색 영역 | 예시 질문 |
482
+ |------|----------|----------|
483
+ | **Who** | 사용자/이해관계자 | 누가 사용하는가? 누가 영향받는가? |
484
+ | **What** | 기능/목적 | 무엇을 해결하는가? 무엇이 필요한가? |
485
+ | **Where** | 적용 범위 | 어디서 사용되는가? 어떤 환경에서? |
486
+ | **When** | 시점/조건 | 언제 필요한가? 어떤 상황에서? |
487
+ | **Why** | 목적/가치 | 왜 중요한가? 왜 지금인가? |
488
+ | **How** | 구현/방법 | 어떻게 구현하는가? 어떻게 측정하는가? |
489
+
490
+ **AI 적용:** 각 질문에 대해 5-10개 하위 질문 생성 → 요구사항 도출
491
+
492
+ ---
493
+
494
+ ### 5. Reverse Brainstorming
495
+
496
+ > 역발상으로 새로운 관점 획득
497
+
498
+ **워크플로우:**
499
+ ```
500
+ 단계 1: "어떻게 하면 [문제]를 악화시킬 수 있을까?"
501
+ 단계 2: 악화 시나리오 5-10개 생성
502
+ 단계 3: 각 시나리오를 역전환
503
+ 단계 4: 실행 가능한 아이디어로 정제
504
+ ```
505
+
506
+ **예시:**
507
+ ```
508
+ 문제: "사용자 이탈률을 낮추려면?"
509
+ ↓ 역전환
510
+ "어떻게 하면 사용자를 더 빨리 이탈시킬까?"
511
+ - 복잡한 가입 절차 → 역전환: 원클릭 가입
512
+ - 느린 로딩 → 역전환: 스켈레톤 UI + 지연 로딩
513
+ - 혼란스러운 네비게이션 → 역전환: 명확한 정보 구조
514
+ ```
515
+
516
+ **적합한 상황:** 막힌 상황 돌파, 새로운 관점, 문제 예방
517
+
518
+ ---
519
+
520
+ ### 6. 6 Thinking Hats (AI 버전)
521
+
522
+ > 6가지 관점으로 체계적 평가 - 병렬 에이전트 활용
523
+
524
+ | 모자 | 관점 | AI 에이전트 | 질문 |
525
+ |------|------|-----------|------|
526
+ | ⚪ 하얀 | 정보/데이터 | analyst | 현재 데이터가 말하는 것? |
527
+ | 🔴 빨간 | 감정/직관 | analyst | 사용자가 느끼는 감정? |
528
+ | ⚫ 검은 | 비판/리스크 | analyst | 잠재적 문제점? 실패 시나리오? |
529
+ | 🟡 노란 | 긍정/이점 | analyst | 기대 효과? 성공 시나리오? |
530
+ | 🟢 초록 | 창의/대안 | designer | 새로운 접근 방법? 대안? |
531
+ | 🔵 파란 | 프로세스/관리 | planner | 어떻게 진행? 우선순위? |
532
+
533
+ **병렬 에이전트 패턴:**
534
+ ```typescript
535
+ // 6가지 관점 동시 분석
536
+ Task({ subagent_type: 'analyst', prompt: '⚪ White Hat: [주제] 관련 데이터/팩트 분석' })
537
+ Task({ subagent_type: 'analyst', prompt: '🔴 Red Hat: [주제] 사용자 감정/직관 분석' })
538
+ Task({ subagent_type: 'analyst', prompt: '⚫ Black Hat: [주제] 리스크/문제점 분석' })
539
+ Task({ subagent_type: 'analyst', prompt: '🟡 Yellow Hat: [주제] 이점/긍정적 효과 분석' })
540
+ Task({ subagent_type: 'designer', prompt: '🟢 Green Hat: [주제] 창의적 대안 제시' })
541
+ Task({ subagent_type: 'planner', prompt: '🔵 Blue Hat: [주제] 실행 프로세스 설계' })
542
+ ```
543
+
544
+ ---
545
+
546
+ ### 7. Crazy 8s (AI 버전)
547
+
548
+ > 8가지 빠른 아이디어 생성
549
+
550
+ **원리:** 양(quantity) 우선, 질(quality)은 나중에
551
+
552
+ **AI 적용:**
553
+ ```
554
+ [주제]에 대해 8가지 서로 다른 아이디어를 빠르게 생성:
555
+
556
+ 1. 가장 단순한 해결책
557
+ 2. 가장 기술적으로 진보된 해결책
558
+ 3. 경쟁사라면 어떻게?
559
+ 4. 예산이 무제한이라면?
560
+ 5. 예산이 0이라면?
561
+ 6. 10년 후라면?
562
+ 7. 완전히 다른 분야에서 가져온다면?
563
+ 8. 가장 미친 아이디어
564
+ ```
565
+
566
+ **적합한 상황:** 빠른 발상, 초기 아이디어 탐색, 창의적 돌파
567
+
568
+ ---
569
+
570
+ ### 8. 5 Whys
571
+
572
+ > 근본 원인 분석으로 진짜 문제 발견
573
+
574
+ **워크플로우:**
575
+ ```
576
+ 문제: [현상]
577
+ Why 1: 왜 [현상]이 발생하는가? → [원인 1]
578
+ Why 2: 왜 [원인 1]이 발생하는가? → [원인 2]
579
+ Why 3: 왜 [원인 2]이 발생하는가? → [원인 3]
580
+ Why 4: 왜 [원인 3]이 발생하는가? → [원인 4]
581
+ Why 5: 왜 [원인 4]이 발생하는가? → [근본 원인]
582
+ ```
583
+
584
+ **예시:**
585
+ ```
586
+ 문제: 사용자 이탈률이 높다
587
+ Why 1: 왜? → 회원가입 완료율이 낮다
588
+ Why 2: 왜? → 가입 폼이 너무 길다
589
+ Why 3: 왜? → 불필요한 정보를 수집한다
590
+ Why 4: 왜? → 요구사항 분석 없이 설계했다
591
+ Why 5: 왜? → 사용자 리서치가 없었다
592
+ → 근본 원인: 사용자 리서치 부재
593
+ ```
594
+
595
+ **적합한 상황:** 버그 분석, 문제 진단, 프로세스 개선
596
+
597
+ ---
598
+
599
+ ### 9. How Might We (HMW)
600
+
601
+ > 디자인 씽킹의 핵심 기법
602
+
603
+ **질문 생성 패턴:**
604
+ ```
605
+ - How might we [사용자 문제]를 해결할 수 있을까?
606
+ - How might we [목표]를 더 쉽게 달성할 수 있을까?
607
+ - How might we [제약]을 기회로 바꿀 수 있을까?
608
+ ```
609
+
610
+ **예시:**
611
+ - HMW 사용자가 3초 안에 원하는 정보를 찾게 할까?
612
+ - HMW 신규 사용자의 이탈률을 낮출까?
613
+ - HMW 모바일에서 복잡한 작업을 간단하게 만들까?
614
+
615
+ **적합한 상황:** 요구사항 발굴, 문제 재정의, 기회 발견
616
+
617
+ </ideation_framework>
618
+
619
+ ---
620
+
621
+ <result_structure>
622
+
623
+ ## 결과물 구조
624
+
625
+ ### 브레인스토밍 결과 형식
626
+
627
+ ```markdown
628
+ # 브레인스토밍 결과: [주제]
629
+
630
+ **생성일:** YYYY-MM-DD
631
+ **관련 컨텍스트:** [프로젝트명 또는 관련 파일]
632
+
633
+ ---
634
+
635
+ ## 📊 수집 자료 요약
636
+
637
+ ### 외부 트렌드
638
+ - 트렌드 1: [설명]
639
+ - 트렌드 2: [설명]
640
+
641
+ ### 경쟁사/사례
642
+ - 사례 1: [서비스명] - [특징]
643
+ - 사례 2: [서비스명] - [특징]
644
+
645
+ ### 현재 시스템
646
+ - 강점: [목록]
647
+ - 개선점: [목록]
648
+ - 제약: [목록]
649
+
650
+ ---
651
+
652
+ ## 💡 아이디어 목록
653
+
654
+ ### 카테고리 1: [예: 사용자 경험]
655
+
656
+ | ID | 아이디어 | 설명 | 노력 | 영향도 |
657
+ |----|---------|------|------|--------|
658
+ | 1-1 | [아이디어명] | [설명] | 낮음 | 높음 |
659
+ | 1-2 | [아이디어명] | [설명] | 중간 | 중간 |
660
+
661
+ ### 카테고리 2: [예: 기술 개선]
662
+
663
+ | ID | 아이디어 | 설명 | 노력 | 영향도 |
664
+ |----|---------|------|------|--------|
665
+ | 2-1 | [아이디어명] | [설명] | 높음 | 높음 |
666
+
667
+ ### 카테고리 3: [예: 비즈니스]
668
+
669
+ | ID | 아이디어 | 설명 | 노력 | 영향도 |
670
+ |----|---------|------|------|--------|
671
+ | 3-1 | [아이디어명] | [설명] | 낮음 | 중간 |
672
+
673
+ ---
674
+
675
+ ## 📈 우선순위 매트릭스
676
+
677
+ ```
678
+ 높은 영향도
679
+
680
+ [Quick │ [Big
681
+ Wins] │ Bets]
682
+
683
+ ─────────────┼─────────────
684
+
685
+ [Fill │ [Money
686
+ Ins] │ Pit]
687
+
688
+ 낮은 영향도
689
+
690
+ 낮은 노력 ◄──────────► 높은 노력
691
+ ```
692
+
693
+ ### Quick Wins (낮은 노력 + 높은 영향도)
694
+ - 1-1: [아이디어명]
695
+
696
+ ### Big Bets (높은 노력 + 높은 영향도)
697
+ - 2-1: [아이디어명]
698
+
699
+ ### Fill Ins (낮은 노력 + 낮은 영향도)
700
+ - 3-1: [아이디어명]
701
+
702
+ ---
703
+
704
+ ## 🎯 추천 방향
705
+
706
+ **최우선 추천:** [아이디어 ID] - [이유]
707
+
708
+ **다음 단계:**
709
+ 1. [구체적 액션 1]
710
+ 2. [구체적 액션 2]
711
+ 3. [구체적 액션 3]
712
+
713
+ **추가 탐색 필요:**
714
+ - [불확실한 영역]
715
+ - [추가 조사 필요 항목]
716
+ ```
717
+
718
+ </result_structure>
719
+
720
+ ---
721
+
722
+ <examples>
723
+
724
+ ## 실전 예시
725
+
726
+ ### 예시 1: 기능 아이디어 브레인스토밍
727
+
728
+ ```bash
729
+ 사용자: /brainstorm 사용자 참여를 높일 방법
730
+
731
+ 1. Sequential Thinking (2단계):
732
+ thought 1: "사용자 참여 - 넓은 주제, UX/기능/게이미피케이션 다각도 접근"
733
+ thought 2: "외부 트렌드 + 경쟁사 + 현재 시스템 동시 조사"
734
+
735
+ 2. 병렬 자료 수집:
736
+ Task (researcher): "2024-2025 사용자 참여 트렌드, 게이미피케이션 사례"
737
+ Task (researcher): "토스, 카카오, 배민 등 참여 유도 기능 분석"
738
+ Task (explore): "현재 앱 사용자 플로우, 참여 포인트 분석"
739
+
740
+ 3. Sequential Thinking (3-5단계):
741
+ thought 3: "수집 결과 - 알림, 리워드, 소셜, 개인화 4가지 축"
742
+ thought 4: "SCAMPER 적용: 기존 기능 결합, 새 기능 추가"
743
+ thought 5: "우선순위: Quick Wins → Big Bets 순"
744
+
745
+ 4. 결과 저장:
746
+ → .claude/brainstorms/00.사용자_참여_향상.md
747
+
748
+ 5. 결과 요약:
749
+ ## 💡 아이디어 목록
750
+
751
+ ### 사용자 경험
752
+ - 1-1: 진행률 표시 (낮음/높음) - Quick Win
753
+ - 1-2: 개인화 대시보드 (중간/높음)
754
+
755
+ ### 게이미피케이션
756
+ - 2-1: 연속 사용 보상 (낮음/높음) - Quick Win
757
+ - 2-2: 레벨 시스템 (높음/중간)
758
+
759
+ ### 소셜
760
+ - 3-1: 친구 초대 리워드 (중간/높음)
761
+
762
+ ## 🎯 추천: 1-1, 2-1 먼저 구현 (Quick Wins)
763
+
764
+ 📁 전체 결과: .claude/brainstorms/00.사용자_참여_향상.md
765
+ ```
766
+
767
+ ### 예시 2: 기술 선택 브레인스토밍
768
+
769
+ ```bash
770
+ 사용자: /brainstorm 기술: 실시간 통신 방식 선택
771
+
772
+ 1. Sequential Thinking (2단계):
773
+ thought 1: "기술 비교 - WebSocket, SSE, Polling 등 옵션"
774
+ thought 2: "각 기술 병렬 조사 + 현재 요구사항 분석"
775
+
776
+ 2. 병렬 자료 수집:
777
+ Task (researcher): "WebSocket 장단점, 사용 사례, 스케일링"
778
+ Task (researcher): "SSE 장단점, 브라우저 지원, 제약"
779
+ Task (researcher): "Long Polling 장단점, 사용 시나리오"
780
+ Task (explore): "현재 통신 구조, 요구사항 분석"
781
+
782
+ 3. Sequential Thinking (3-5단계):
783
+ thought 3: "요구사항: 양방향 통신, 모바일 지원, 중간 규모"
784
+ thought 4: "WebSocket이 요구사항에 가장 적합"
785
+ thought 5: "Socket.io vs ws 비교: Socket.io 추천 (재연결 자동화)"
786
+
787
+ 4. 결과 저장:
788
+ → .claude/brainstorms/01.실시간_통신_기술_선택.md
789
+
790
+ 5. 결과 요약:
791
+ ## 📊 기술 비교
792
+
793
+ | 기준 | WebSocket | SSE | Polling |
794
+ |------|-----------|-----|---------|
795
+ | 양방향 | ✅ | ❌ | ⚠️ |
796
+ | 실시간성 | ⭐⭐⭐ | ⭐⭐ | ⭐ |
797
+ | 복잡도 | 중간 | 낮음 | 낮음 |
798
+ | 스케일링 | 중간 | 높음 | 낮음 |
799
+
800
+ ## 🎯 추천: WebSocket (Socket.io)
801
+ - 이유: 양방향 필요, 재연결 자동화, 생태계 성숙
802
+
803
+ 📁 전체 결과: .claude/brainstorms/01.실시간_통신_기술_선택.md
804
+ ```
805
+
806
+ ### 예시 3: UX 개선 브레인스토밍
807
+
808
+ ```bash
809
+ 사용자: /brainstorm UX: 모바일 결제 플로우 개선
810
+
811
+ 1. Sequential Thinking (2단계):
812
+ thought 1: "모바일 결제 UX - 전환율 직결, 사용자 리서치 중요"
813
+ thought 2: "경쟁사 UX + 베스트 프랙티스 + 현재 플로우 분석"
814
+
815
+ 2. 병렬 자료 수집:
816
+ Task (researcher): "토스, 카카오페이, Apple Pay UX 분석"
817
+ Task (designer): "모바일 결제 UX 베스트 프랙티스, 마이크로인터랙션"
818
+ Task (explore): "현재 결제 플로우, 이탈 포인트 분석"
819
+
820
+ 3. Sequential Thinking (3-5단계):
821
+ thought 3: "현재 이탈 포인트: 주소 입력, 카드 정보, 최종 확인"
822
+ thought 4: "HMW: 어떻게 3단계 → 1단계로 줄일 수 있을까?"
823
+ thought 5: "저장된 정보 활용, 원터치 결제, 생체인증"
824
+
825
+ 4. 결과 저장:
826
+ → .claude/brainstorms/02.모바일_결제_UX_개선.md
827
+
828
+ 5. 결과 요약:
829
+ ## 💡 아이디어 목록
830
+
831
+ ### 단계 축소
832
+ - 1-1: 기본 배송지 자동 선택 (낮음/높음)
833
+ - 1-2: 원터치 결제 (중간/높음)
834
+
835
+ ### 신뢰 구축
836
+ - 2-1: 단계 인디케이터 (낮음/중간)
837
+ - 2-2: 실시간 에러 안내 (낮음/중간)
838
+
839
+ ## 🎯 추천: 1-1, 2-1 먼저 (Quick Wins)
840
+ 다음: 1-2 원터치 결제 (Big Bet)
841
+
842
+ 📁 전체 결과: .claude/brainstorms/02.모바일_결제_UX_개선.md
843
+ ```
844
+
845
+ </examples>
846
+
847
+ ---
848
+
849
+ <validation>
850
+
851
+ ## 검증 체크리스트
852
+
853
+ 실행 전 확인:
854
+
855
+ ```text
856
+ ✅ ARGUMENT 확인 (없으면 질문)
857
+ ✅ Sequential Thinking 최소 3단계
858
+ ✅ 병렬 자료 수집 (researcher + explore + analyst)
859
+ ✅ 아이디어 최소 5개 이상
860
+ ✅ 노력/영향도 평가
861
+ ✅ 우선순위 매트릭스
862
+ ✅ 명확한 추천 방향
863
+ ✅ .claude/brainstorms/ 폴더에 결과 저장
864
+ ✅ 파일 경로 사용자에게 안내
865
+ ```
866
+
867
+ 절대 금지:
868
+
869
+ ```text
870
+ ❌ ARGUMENT 없이 브레인스토밍 시작
871
+ ❌ 자료 수집 없이 아이디어 제시
872
+ ❌ 단일 관점만 고려
873
+ ❌ 평가 기준 없이 나열
874
+ ❌ 다음 단계 없이 종료
875
+ ❌ 결과 저장 없이 종료
876
+ ```
877
+
878
+ ## 병렬 실행 체크리스트
879
+
880
+ ```text
881
+ ✅ 다각도 수집: 외부 + 내부 + 분석
882
+ ✅ researcher: 트렌드, 사례, 베스트 프랙티스
883
+ ✅ explore: 코드베이스, 현재 구조
884
+ ✅ analyst/designer: 요구사항, UX
885
+ ✅ 모델 선택: 조사(sonnet), 탐색(haiku), 아키텍처(opus)
886
+ ✅ 병렬 실행 3-5개 권장
887
+ ```
888
+
889
+ </validation>