@kood/claude-code 0.6.0 → 0.6.2

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 (32) hide show
  1. package/dist/index.js +1 -1
  2. package/package.json +1 -1
  3. package/templates/.claude/instructions/agent-patterns/delegation-patterns.md +389 -0
  4. package/templates/.claude/instructions/context-optimization/phase-based-execution.md +410 -0
  5. package/templates/.claude/instructions/context-optimization/redundant-exploration-prevention.md +646 -0
  6. package/templates/.claude/instructions/context-optimization/sub-agent-distribution.md +476 -0
  7. package/templates/.claude/instructions/glossary.md +48 -0
  8. package/templates/.claude/instructions/project-context-template.md +453 -0
  9. package/templates/.claude/instructions/skill-integration.md +90 -0
  10. package/templates/.claude/instructions/sourcing/reliable-search.md +411 -0
  11. package/templates/.claude/instructions/validation/forbidden-patterns.md +47 -0
  12. package/templates/.claude/instructions/validation/required-behaviors.md +120 -0
  13. package/templates/.claude/instructions/validation/scope-completeness.md +367 -0
  14. package/templates/.claude/instructions/workflow-patterns/todowrite-pattern.md +2 -0
  15. package/templates/.claude/skills/brainstorm/SKILL.md +110 -644
  16. package/templates/.claude/skills/bug-fix/SKILL.md +9 -137
  17. package/templates/.claude/skills/docs-fetch/CLAUDE.md +3 -0
  18. package/templates/.claude/skills/docs-fetch/SKILL.md +458 -0
  19. package/templates/.claude/skills/elon-musk/CLAUDE.md +3 -0
  20. package/templates/.claude/skills/elon-musk/SKILL.md +367 -0
  21. package/templates/.claude/skills/execute/SKILL.md +18 -397
  22. package/templates/.claude/skills/plan/SKILL.md +12 -986
  23. package/templates/.claude/skills/prd/SKILL.md +225 -586
  24. package/templates/.claude/skills/prd/references/ai-native-prd.md +116 -0
  25. package/templates/.claude/skills/prd/references/anti-patterns.md +82 -0
  26. package/templates/.claude/skills/prd/references/frameworks.md +216 -0
  27. package/templates/.claude/skills/prd/references/pm-leaders.md +106 -0
  28. package/templates/.claude/skills/prd/references/trends-2026.md +157 -0
  29. package/templates/.claude/skills/ralph/SKILL.md +15 -497
  30. package/templates/.claude/skills/refactor/SKILL.md +11 -655
  31. package/templates/.claude/skills/research/SKILL.md +257 -0
  32. package/templates/.claude/skills/research/report-template.md +88 -0
@@ -7,6 +7,8 @@ user-invocable: true
7
7
  @../../instructions/workflow-patterns/sequential-thinking.md
8
8
  @../../instructions/agent-patterns/parallel-execution.md
9
9
  @../../instructions/agent-patterns/model-routing.md
10
+ @../../instructions/sourcing/reliable-search.md
11
+ @../../instructions/context-optimization/redundant-exploration-prevention.md
10
12
  @../../instructions/validation/forbidden-patterns.md
11
13
  @../../instructions/validation/required-behaviors.md
12
14
 
@@ -44,7 +46,7 @@ user-invocable: true
44
46
 
45
47
  ## 결과물
46
48
 
47
- - 다각도 자료 수집 (웹, 코드베이스, 트렌드)
49
+ - 다각도 자료 수집 (웹, 코드베이스, 트렌드, Firecrawl/SearXNG)
48
50
  - 체계적 아이디어 목록 (카테고리별)
49
51
  - 실행 가능성 평가 (노력/영향도 매트릭스)
50
52
  - 추천 방향 및 다음 단계
@@ -75,20 +77,58 @@ $ARGUMENTS 있음 → 다음 단계 진행
75
77
 
76
78
  ---
77
79
 
80
+ <sourcing_strategy>
81
+
82
+ ## Brainstorm 전용 MCP 활용
83
+
84
+ @../../instructions/sourcing/reliable-search.md 참조
85
+
86
+ **브레인스토밍 특화 활용:**
87
+
88
+ | MCP 도구 | 활용 | 폴백 |
89
+ |----------|------|------|
90
+ | `firecrawl_search` | 주제별 심층 검색 (경쟁사, 트렌드) | WebSearch |
91
+ | `firecrawl_scrape` | 참고 사이트 컨텐츠 추출 | WebFetch |
92
+ | `firecrawl_map` | 경쟁사/참고 사이트 구조 파악 | WebFetch 수동 |
93
+ | `search_repositories/code` | GitHub 관련 프로젝트 검색 | `gh search` |
94
+
95
+ **MCP는 main agent가 직접 실행** (subagent는 MCP 도구 사용 불가)
96
+
97
+ </sourcing_strategy>
98
+
99
+ ---
100
+
78
101
  <workflow>
79
102
 
80
103
  ## 실행 흐름
81
104
 
82
105
  | 단계 | 작업 | 도구 |
83
106
  |------|------|------|
107
+ | 0. MCP 감지 | Firecrawl/SearXNG/GitHub MCP 가용 여부 확인 | ToolSearch × 3 |
84
108
  | 1. 입력 확인 | ARGUMENT 검증 | - |
85
- | 2. 주제 분석 | 브레인스토밍 범위 결정 | sequentialthinking (1-2단계) |
86
- | 3. 자료 수집 | 병렬 정보 수집 (웹 + 코드베이스 + 트렌드) | Task 병렬 (researcher, explore) + WebSearch |
109
+ | 2. 주제 분석 | 브레인스토밍 범위 결정 + 채널 배분 | sequentialthinking (1-2단계) |
110
+ | 3. 자료 수집 | 병렬 정보 수집 (웹 + MCP + 코드베이스, **현재 연도 포함 필수, 출처 신뢰도 확인**) | Task 병렬 + MCP 직접 실행 |
87
111
  | 4. 아이디어 도출 | 수집 자료 기반 아이디어 생성 | sequentialthinking (3-5단계) |
88
112
  | 5. 구조화 | 카테고리별 정리 + 실행 가능성 평가 | - |
89
113
  | 6. 문서 저장 | `.claude/brainstorms/` 폴더에 결과 저장 | Write |
90
114
  | 7. 결과 제시 | 아이디어 목록 + 추천 방향 + 파일 경로 안내 | - |
91
115
 
116
+ ### Phase 0: MCP 환경 감지
117
+
118
+ ```
119
+ 1. MCP 감지 (병렬): ToolSearch("firecrawl"), ToolSearch("searxng"), ToolSearch("github")
120
+ 2. 가용 채널 결정: MCP 있으면 Tier 1, 없으면 Tier 2 폴백
121
+ 3. 기존 브레인스토밍: .claude/brainstorms/ 동일 주제 확인
122
+ ```
123
+
124
+ ### Phase 2: 주제 분석 시 채널 배분
125
+
126
+ ```
127
+ Sequential Thinking (2단계):
128
+ thought 1: 주제 유형 확정, 범위 결정, MCP 가용 여부 반영
129
+ thought 2: 에이전트 역할 배분 + main agent MCP 직접 실행 계획
130
+ ```
131
+
92
132
  ### 복잡도별 사고 패턴
93
133
 
94
134
  | 복잡도 | 사고 횟수 | 판단 기준 |
@@ -124,27 +164,7 @@ $ARGUMENTS 있음 → 다음 단계 진행
124
164
  - **넘버링**: 기존 파일 목록 조회 → 다음 번호 자동 부여 (00, 01, 02...)
125
165
  - **주제 요약**: 한글, 언더스코어로 구분, 간결하게
126
166
 
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
- ### 저장 내용
167
+ ### 저장 규칙
148
168
 
149
169
  | 섹션 | 내용 |
150
170
  |------|------|
@@ -160,222 +180,17 @@ Write({
160
180
 
161
181
  <parallel_agent_execution>
162
182
 
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 |
183
+ ## 병렬 에이전트 실행
175
184
 
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
- ---
185
+ @../../instructions/agent-patterns/delegation-patterns.md
186
+ @../../instructions/agent-patterns/parallel-execution.md
187
+ @../../instructions/agent-patterns/model-routing.md
369
188
 
370
- ### Model Routing
189
+ ### Brainstorm 스킬 고유 패턴
371
190
 
372
- | 조사 유형 | 모델 | Agent | 이유 |
373
- |----------|------|-------|------|
374
- | **트렌드/사례** | sonnet | researcher | 외부 정보 종합 |
375
- | **코드 탐색** | haiku | explore | 빠른 구조 파악 |
376
- | **요구사항** | sonnet | analyst | 분석 품질 |
377
- | **아키텍처** | opus | architect | 설계 깊이 |
378
- | **UI/UX** | sonnet | designer | 창의성 + 실용성 |
191
+ - **다채널 수집**: WebSearch + SearXNG + Firecrawl을 병렬로 실행하여 아이디어 소스 수집
192
+ - **멀티 페르소나**: 여러 관점(사용자, 개발자, 비즈니스)에서 동시에 아이디어 평가
193
+ - **검색 신뢰성**: 검색 쿼리에 현재 연도(2026) 포함 필수, 수집 자료별 발행일+소스유형 기재
379
194
 
380
195
  </parallel_agent_execution>
381
196
 
@@ -385,37 +200,32 @@ Task({
385
200
 
386
201
  ## 아이디어 도출 프레임워크
387
202
 
388
- > AI에 최적화된 8가지 브레인스토밍 기법
389
-
390
- ### 기법 선택 가이드
203
+ ### 기법 선택
391
204
 
392
205
  | 상황 | 추천 기법 |
393
206
  |------|----------|
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 |
207
+ | **신규 기능** | Tree of Thoughts, SCAMPER, Multi-Persona |
208
+ | **문제 해결** | Reverse Brainstorming, 5 Whys, ToT |
209
+ | **요구사항** | Starbursting (5W1H), How Might We |
210
+ | **평가** | 6 Thinking Hats, Multi-Persona |
398
211
  | **빠른 발상** | Crazy 8s, SCAMPER |
399
- | **복잡한 의사결정** | Tree of Thoughts, 6 Thinking Hats |
400
-
401
- ---
402
212
 
403
- ### 1. Tree of Thoughts (ToT) ⭐ AI 핵심
213
+ ### AI 핵심 기법
404
214
 
405
- > 여러 해결 경로를 동시에 탐색하고 평가하는 AI 특화 기법
215
+ | 기법 | 원리 | 적합 상황 | AI 구현 |
216
+ |------|------|----------|--------|
217
+ | **Tree of Thoughts** | 트리 구조로 여러 경로 탐색 → 평가 → 확장 | 복잡한 문제, 의사결정 | 문제 분해 → 각 경로 병렬 생성 → 평가 (1-5) → 유망 경로 심화 |
218
+ | **Multi-Persona** | 여러 관점 시뮬레이션 | 다각도 검토, 제품 기획 | CEO/개발자/UX/고객/비평가 관점 병렬 실행 |
219
+ | **SCAMPER** | 7가지 질문 (대체/결합/적용/수정/전용/제거/재배열) | 체계적 발상 | 각 질문당 3+ 아이디어 |
220
+ | **Starbursting** | 5W1H 질문 중심 | 요구사항 발굴 | 각 질문당 5-10개 하위 질문 |
221
+ | **Reverse** | 역발상 (악화 → 역전환) | 막힌 상황, 예방 | 악화 시나리오 → 역전환 → 정제 |
222
+ | **6 Thinking Hats** | 6가지 관점 (정보/감정/비판/긍정/창의/프로세스) | 체계적 평가 | 6개 에이전트 병렬 분석 |
223
+ | **Crazy 8s** | 8가지 빠른 아이디어 | 초기 탐색 | 단순/진보/경쟁사/무제한/제로/미래/타분야/미친 |
224
+ | **5 Whys** | 5번 Why → 근본 원인 | 버그 분석, 진단 | 현상 → Why 1-5 → 근본 원인 |
225
+ | **How Might We** | HMW 질문 생성 | 문제 재정의, 기회 | "어떻게 [목표] 달성?" |
406
226
 
407
- **원리:** 선형적 사고 대신 트리 구조로 여러 아이디어 분기 → 평가 → 유망한 경로 확장
227
+ ### Tree of Thoughts 병렬 패턴
408
228
 
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
229
  ```typescript
420
230
  // 여러 경로 동시 탐색
421
231
  Task({ subagent_type: 'analyst', prompt: '경로 A: [접근법 1] 심층 분석' })
@@ -424,25 +234,8 @@ Task({ subagent_type: 'analyst', prompt: '경로 C: [접근법 3] 심층 분석'
424
234
  // → 결과 비교 후 유망 경로 선택
425
235
  ```
426
236
 
427
- **적합한 상황:** 복잡한 문제, 여러 해결책 비교, 의사결정
428
-
429
- ---
430
-
431
- ### 2. Multi-Persona Simulation ⭐ AI 핵심
432
-
433
- > 여러 전문가/이해관계자 관점을 시뮬레이션하여 다각도 아이디어 생성
237
+ ### Multi-Persona 병렬 패턴
434
238
 
435
- **페르소나 예시:**
436
-
437
- | 페르소나 | 관점 | 질문 |
438
- |---------|------|------|
439
- | **CEO** | 비즈니스 가치 | ROI는? 시장 기회는? |
440
- | **개발자** | 기술적 실현 | 구현 가능? 복잡도는? |
441
- | **UX 디자이너** | 사용자 경험 | 직관적인가? 접근성은? |
442
- | **고객** | 실제 사용 | 내 문제를 해결하나? |
443
- | **비평가** | 약점/리스크 | 실패 시나리오는? |
444
-
445
- **병렬 에이전트 패턴:**
446
239
  ```typescript
447
240
  // 여러 페르소나 동시 실행
448
241
  Task({ subagent_type: 'analyst', prompt: 'CEO 관점: 비즈니스 가치 분석' })
@@ -452,168 +245,6 @@ Task({ subagent_type: 'analyst', prompt: '고객 관점: 실제 사용 시나리
452
245
  Task({ subagent_type: 'analyst', prompt: '비평가 관점: 약점과 리스크' })
453
246
  ```
454
247
 
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
248
  </ideation_framework>
618
249
 
619
250
  ---
@@ -622,98 +253,13 @@ Why 5: 왜? → 사용자 리서치가 없었다
622
253
 
623
254
  ## 결과물 구조
624
255
 
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
- ```
256
+ | 섹션 | 내용 |
257
+ |------|------|
258
+ | **메타데이터** | 주제, 생성일, 관련 컨텍스트 |
259
+ | **📊 수집 자료 요약** | 외부 트렌드, 경쟁사/사례, 현재 시스템 (강점/개선/제약) |
260
+ | **💡 아이디어 목록** | 카테고리별 표 (ID, 아이디어, 설명, 노력, 영향도) |
261
+ | **📈 우선순위 매트릭스** | Quick Wins/Big Bets/Fill Ins/Money Pit 분류 |
262
+ | **🎯 추천 방향** | 최우선 추천, 다음 단계 (구체적 액션), 추가 탐색 필요 항목 |
717
263
 
718
264
  </result_structure>
719
265
 
@@ -723,124 +269,31 @@ Why 5: 왜? → 사용자 리서치가 없었다
723
269
 
724
270
  ## 실전 예시
725
271
 
726
- ### 예시 1: 기능 아이디어 브레인스토밍
272
+ ### 핵심 예시: 기능 아이디어 브레인스토밍
727
273
 
728
274
  ```bash
729
275
  사용자: /brainstorm 사용자 참여를 높일 방법
730
276
 
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
277
+ 1. Sequential Thinking (2단계): 주제 분석 → 채널 배분
278
+ 2. 병렬 자료 수집: researcher (트렌드+경쟁사) + explore (현재 플로우) + MCP
279
+ 3. Sequential Thinking (3-5단계): 수집 결과 SCAMPER 적용 우선순위
280
+ 4. 결과 저장: .claude/brainstorms/00.사용자_참여_향상.md
747
281
 
748
- 5. 결과 요약:
749
- ## 💡 아이디어 목록
282
+ 결과 요약:
283
+ ## 💡 아이디어 목록
284
+ - 1-1: 진행률 표시 (낮음/높음) - Quick Win
285
+ - 2-1: 연속 사용 보상 (낮음/높음) - Quick Win
286
+ - 3-1: 친구 초대 리워드 (중간/높음)
750
287
 
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
288
+ ## 🎯 추천: 1-1, 2-1 먼저 구현 (Quick Wins)
765
289
  ```
766
290
 
767
- ### 예시 2: 기술 선택 브레인스토밍
768
-
769
- ```bash
770
- 사용자: /brainstorm 기술: 실시간 통신 방식 선택
291
+ ### 기타 예시
771
292
 
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
- ```
293
+ | 예시 | 프로세스 | 결과 |
294
+ |------|----------|------|
295
+ | **기술 선택** | 각 기술 병렬 조사 + 요구사항 분석 → 비교표 | WebSocket (Socket.io) 추천 |
296
+ | **UX 개선** | 경쟁사 UX + 베스트 프랙티스 + 현재 플로우 → HMW | Quick Wins (자동 선택, 인디케이터) 우선 |
844
297
 
845
298
  </examples>
846
299
 
@@ -853,9 +306,11 @@ Why 5: 왜? → 사용자 리서치가 없었다
853
306
  실행 전 확인:
854
307
 
855
308
  ```text
309
+ ✅ Phase 0: MCP 감지 (ToolSearch × 3: firecrawl, searxng, github)
856
310
  ✅ ARGUMENT 확인 (없으면 질문)
857
311
  ✅ Sequential Thinking 최소 3단계
858
- ✅ 병렬 자료 수집 (researcher + explore + analyst)
312
+ ✅ 병렬 자료 수집 (researcher + explore + analyst + MCP 직접 실행)
313
+ ✅ MCP 가용 시 main agent가 firecrawl_search/scrape 병렬 실행
859
314
  ✅ 아이디어 최소 5개 이상
860
315
  ✅ 노력/영향도 평가
861
316
  ✅ 우선순위 매트릭스
@@ -864,6 +319,15 @@ Why 5: 왜? → 사용자 리서치가 없었다
864
319
  ✅ 파일 경로 사용자에게 안내
865
320
  ```
866
321
 
322
+ 신뢰도 검증:
323
+
324
+ ```text
325
+ ✅ 검색 쿼리에 현재 연도 포함 (2026)
326
+ ✅ 수집 자료별 발행일/출처 확인
327
+ ✅ 오래된 정보 (3년 이상) 제외 또는 명시
328
+ ✅ 출처 신뢰도 평가 (공식 문서 > 기술 블로그 > 커뮤니티)
329
+ ```
330
+
867
331
  절대 금지:
868
332
 
869
333
  ```text
@@ -873,15 +337,17 @@ Why 5: 왜? → 사용자 리서치가 없었다
873
337
  ❌ 평가 기준 없이 나열
874
338
  ❌ 다음 단계 없이 종료
875
339
  ❌ 결과 저장 없이 종료
340
+ ❌ 발행일 미확인 정보 기반 추천
876
341
  ```
877
342
 
878
343
  ## 병렬 실행 체크리스트
879
344
 
880
345
  ```text
881
- ✅ 다각도 수집: 외부 + 내부 + 분석
882
- ✅ researcher: 트렌드, 사례, 베스트 프랙티스
346
+ ✅ 다각도 수집: 외부 + 내부 + 분석 + MCP
347
+ ✅ researcher: 트렌드, 사례, 베스트 프랙티스 (검색 쿼리에 현재 연도)
883
348
  ✅ explore: 코드베이스, 현재 구조
884
349
  ✅ analyst/designer: 요구사항, UX
350
+ ✅ main agent: MCP 가용 시 firecrawl_search/scrape 직접 실행
885
351
  ✅ 모델 선택: 조사(sonnet), 탐색(haiku), 아키텍처(opus)
886
352
  ✅ 병렬 실행 3-5개 권장
887
353
  ```