@kood/claude-code 0.6.1 → 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 (24) 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 +75 -672
  16. package/templates/.claude/skills/bug-fix/SKILL.md +9 -137
  17. package/templates/.claude/skills/docs-fetch/SKILL.md +64 -232
  18. package/templates/.claude/skills/elon-musk/SKILL.md +57 -310
  19. package/templates/.claude/skills/execute/SKILL.md +18 -397
  20. package/templates/.claude/skills/plan/SKILL.md +12 -986
  21. package/templates/.claude/skills/prd/SKILL.md +13 -1
  22. package/templates/.claude/skills/ralph/SKILL.md +15 -497
  23. package/templates/.claude/skills/refactor/SKILL.md +11 -655
  24. package/templates/.claude/skills/research/SKILL.md +20 -23
@@ -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
 
@@ -77,24 +79,20 @@ $ARGUMENTS 있음 → 다음 단계 진행
77
79
 
78
80
  <sourcing_strategy>
79
81
 
80
- ## Smart Tier Fallback
82
+ ## Brainstorm 전용 MCP 활용
81
83
 
82
- ```
83
- Tier 1 (MCP, Phase 0에서 ToolSearch로 감지):
84
- Firecrawl MCP → 페이지→MD, 사이트맵 | SearXNG MCP → 메타검색 (246+ 엔진) | GitHub MCP → 코드/리포
84
+ @../../instructions/sourcing/reliable-search.md 참조
85
85
 
86
- Tier 2 (내장, 항상 가용):
87
- WebSearch → 웹 검색 | WebFetch → 페이지 읽기 | gh CLI → GitHub API (Bash)
88
- ```
86
+ **브레인스토밍 특화 활용:**
89
87
 
90
- **MCP main agent가 직접 실행** (subagent는 MCP 도구 사용 불가)
88
+ | MCP 도구 | 활용 | 폴백 |
89
+ |----------|------|------|
90
+ | `firecrawl_search` | 주제별 심층 검색 (경쟁사, 트렌드) | WebSearch |
91
+ | `firecrawl_scrape` | 참고 사이트 컨텐츠 추출 | WebFetch |
92
+ | `firecrawl_map` | 경쟁사/참고 사이트 구조 파악 | WebFetch 수동 |
93
+ | `search_repositories/code` | GitHub 관련 프로젝트 검색 | `gh search` |
91
94
 
92
- | MCP 도구 | 브레인스토밍 활용 | 미설치 폴백 |
93
- |----------|-----------------|--------------|
94
- | `firecrawl_search` | 주제별 심층 검색 (경쟁사, 트렌드) | WebSearch (내장) |
95
- | `firecrawl_scrape` | 참고 사이트 컨텐츠 추출 | WebFetch (페이지별) |
96
- | `firecrawl_map` | 경쟁사/참고 사이트 구조 파악 | WebFetch (수동) |
97
- | `search_repositories/code` | GitHub 관련 프로젝트 검색 | `gh search` (Bash via explore) |
95
+ **MCP main agent가 직접 실행** (subagent는 MCP 도구 사용 불가)
98
96
 
99
97
  </sourcing_strategy>
100
98
 
@@ -109,7 +107,7 @@ Tier 2 (내장, 항상 가용):
109
107
  | 0. MCP 감지 | Firecrawl/SearXNG/GitHub MCP 가용 여부 확인 | ToolSearch × 3 |
110
108
  | 1. 입력 확인 | ARGUMENT 검증 | - |
111
109
  | 2. 주제 분석 | 브레인스토밍 범위 결정 + 채널 배분 | sequentialthinking (1-2단계) |
112
- | 3. 자료 수집 | 병렬 정보 수집 (웹 + MCP + 코드베이스) | Task 병렬 + MCP 직접 실행 |
110
+ | 3. 자료 수집 | 병렬 정보 수집 (웹 + MCP + 코드베이스, **현재 연도 포함 필수, 출처 신뢰도 확인**) | Task 병렬 + MCP 직접 실행 |
113
111
  | 4. 아이디어 도출 | 수집 자료 기반 아이디어 생성 | sequentialthinking (3-5단계) |
114
112
  | 5. 구조화 | 카테고리별 정리 + 실행 가능성 평가 | - |
115
113
  | 6. 문서 저장 | `.claude/brainstorms/` 폴더에 결과 저장 | Write |
@@ -166,27 +164,7 @@ Sequential Thinking (2단계):
166
164
  - **넘버링**: 기존 파일 목록 조회 → 다음 번호 자동 부여 (00, 01, 02...)
167
165
  - **주제 요약**: 한글, 언더스코어로 구분, 간결하게
168
166
 
169
- ### 저장 워크플로우
170
-
171
- ```typescript
172
- // 1. 넘버링 결정
173
- Bash("ls .claude/brainstorms/ 2>/dev/null | grep -E '^[0-9]+' | wc -l")
174
- const nextNumber = "00" // 결과 기반 계산
175
-
176
- // 2. 폴더 생성 (없으면)
177
- Bash("mkdir -p .claude/brainstorms")
178
-
179
- // 3. 결과 저장
180
- Write({
181
- file_path: `.claude/brainstorms/${nextNumber}.${주제_요약}.md`,
182
- content: 브레인스토밍_결과
183
- })
184
-
185
- // 4. 사용자에게 경로 안내
186
- "브레인스토밍 결과가 저장되었습니다: .claude/brainstorms/00.사용자_참여_향상.md"
187
- ```
188
-
189
- ### 저장 내용
167
+ ### 저장 규칙
190
168
 
191
169
  | 섹션 | 내용 |
192
170
  |------|------|
@@ -202,240 +180,17 @@ Write({
202
180
 
203
181
  <parallel_agent_execution>
204
182
 
205
- ## 병렬 Agent 실행
206
-
207
- ### Recommended Agents
208
-
209
- | Agent | Model | 용도 | 복잡도 |
210
- |-------|-------|------|--------|
211
- | **@researcher** | sonnet | 웹 조사, 외부 문서/API/트렌드 | MEDIUM |
212
- | **@explore** | haiku | 코드베이스 탐색, 현재 구조 분석 | LOW |
213
- | **@analyst** | sonnet | 요구사항 분석, 가정 검증 | MEDIUM |
214
- | **@architect** | opus | 아키텍처 평가, 설계 방향 (READ-ONLY) | HIGH |
215
- | **@designer** | sonnet | UI/UX 아이디어, 디자인 패턴 | MEDIUM |
216
- | **@scientist** | sonnet | 데이터 분석 아이디어, 통계적 접근 | MEDIUM |
217
-
218
- ---
219
-
220
- ### 병렬 수집 패턴
221
-
222
- **에이전트 도구 제약 (@.claude/agents/ 정의 준수):**
223
-
224
- | Agent | Model | 도구 | 역할 |
225
- |-------|-------|------|------|
226
- | researcher | sonnet | WebSearch, WebFetch, Read | 웹 조사 + 출처 수집 |
227
- | explore | haiku | Read, Glob, Grep, **Bash** | 코드베이스 + `gh` CLI |
228
- | main agent | - | MCP 도구들 | Firecrawl/SearXNG/GitHub MCP 직접 실행 |
229
-
230
- **패턴 1: 다각도 자료 수집 (기본 + MCP)**
231
-
232
- ```typescript
233
- // 에이전트 병렬 수집 (subagent는 MCP 사용 불가)
234
- Task({
235
- subagent_type: 'researcher',
236
- model: 'sonnet',
237
- prompt: `
238
- [주제]에 대한 외부 자료 조사:
239
- - 최신 트렌드 및 베스트 프랙티스
240
- - 경쟁사/유사 서비스 사례
241
- - 기술 블로그, 문서, 아티클
242
- `
243
- })
244
-
245
- Task({
246
- subagent_type: 'explore',
247
- model: 'haiku',
248
- prompt: `
249
- 현재 코드베이스에서 [주제] 관련 분석:
250
- - 기존 구현 패턴
251
- - 확장 가능한 포인트
252
- - 제약사항
253
- `
254
- })
255
-
256
- Task({
257
- subagent_type: 'analyst',
258
- model: 'sonnet',
259
- prompt: `
260
- [주제] 요구사항 분석:
261
- - 사용자 니즈
262
- - 비즈니스 목표
263
- - 기술적 제약
264
- `
265
- })
266
-
267
- // ⬆ 위 에이전트들과 동시에, main agent가 MCP 직접 실행:
268
- // firecrawl_search: 주제 관련 심층 검색
269
- firecrawl_search({ query: "[주제] 트렌드 사례", limit: 5 })
270
- // firecrawl_scrape: 핵심 참고 페이지 컨텐츠 추출
271
- firecrawl_scrape({ url: "경쟁사/참고_URL", formats: ["markdown"], onlyMainContent: true })
272
- ```
273
-
274
- **효과:** 3방향 에이전트 + MCP 동시 조사 → 포괄적 정보 수집
275
-
276
- ---
183
+ ## 병렬 에이전트 실행
277
184
 
278
- **패턴 2: 기술 비교 조사**
279
-
280
- ```typescript
281
- // 여러 기술 옵션 동시 조사
282
- Task({
283
- subagent_type: 'researcher',
284
- model: 'sonnet',
285
- prompt: '기술 A (WebSocket) 장단점, 사례, 성능 특성'
286
- })
287
-
288
- Task({
289
- subagent_type: 'researcher',
290
- model: 'sonnet',
291
- prompt: '기술 B (SSE) 장단점, 사례, 성능 특성'
292
- })
293
-
294
- Task({
295
- subagent_type: 'researcher',
296
- model: 'sonnet',
297
- prompt: '기술 C (Long Polling) 장단점, 사례, 성능 특성'
298
- })
299
-
300
- Task({
301
- subagent_type: 'explore',
302
- model: 'haiku',
303
- prompt: '현재 프로젝트 통신 구조 및 요구사항 분석'
304
- })
305
-
306
- // main agent MCP 동시 실행 (가용 시):
307
- firecrawl_search({ query: "WebSocket vs SSE benchmark 2025", limit: 5 })
308
- // GitHub MCP: search_repositories({ query: "websocket sse comparison", sort: "stars" })
309
- ```
310
-
311
- **효과:** 기술 옵션 병렬 조사 + MCP 심층 검색 → 공정한 비교
312
-
313
- ---
314
-
315
- **패턴 3: UX 아이디어 수집**
316
-
317
- ```typescript
318
- // UX 관점 다각도 수집
319
- Task({
320
- subagent_type: 'researcher',
321
- model: 'sonnet',
322
- prompt: `
323
- [UX 주제] 관련 외부 사례:
324
- - 유명 앱/서비스 UX 패턴
325
- - 최신 UX 트렌드 (2024-2025)
326
- - 사용자 리서치 결과
327
- `
328
- })
329
-
330
- Task({
331
- subagent_type: 'designer',
332
- model: 'sonnet',
333
- prompt: `
334
- [UX 주제] 디자인 아이디어:
335
- - 사용자 플로우 개선안
336
- - 마이크로인터랙션 제안
337
- - 접근성 고려사항
338
- `
339
- })
340
-
341
- Task({
342
- subagent_type: 'explore',
343
- model: 'haiku',
344
- prompt: '현재 UI 컴포넌트 및 디자인 시스템 분석'
345
- })
346
- ```
347
-
348
- ---
349
-
350
- **패턴 4: 아키텍처 브레인스토밍**
351
-
352
- ```typescript
353
- // 아키텍처 결정을 위한 심층 분석
354
- Task({
355
- subagent_type: 'architect',
356
- model: 'opus',
357
- prompt: `
358
- [아키텍처 주제] 설계 방향 분석:
359
- - 현재 구조의 장단점
360
- - 확장성, 유지보수성 평가
361
- - 대안 아키텍처 제안
362
- `
363
- })
364
-
365
- Task({
366
- subagent_type: 'researcher',
367
- model: 'sonnet',
368
- prompt: `
369
- [아키텍처 주제] 업계 사례:
370
- - 유사 규모 시스템 아키텍처
371
- - 마이그레이션 사례
372
- - 실패/성공 교훈
373
- `
374
- })
375
-
376
- Task({
377
- subagent_type: 'explore',
378
- model: 'sonnet',
379
- prompt: `
380
- 현재 시스템 심층 분석:
381
- - 모듈 의존성
382
- - 데이터 흐름
383
- - 병목 구간
384
- `
385
- })
386
- ```
387
-
388
- ---
389
-
390
- **패턴 5: 문제 해결 아이디어**
391
-
392
- ```typescript
393
- // 문제 해결을 위한 다각도 접근
394
- Task({
395
- subagent_type: 'analyst',
396
- model: 'sonnet',
397
- prompt: `
398
- [문제] 근본 원인 분석:
399
- - 증상 vs 원인 구분
400
- - 영향 범위 파악
401
- - 가정 검증
402
- `
403
- })
404
-
405
- Task({
406
- subagent_type: 'researcher',
407
- model: 'sonnet',
408
- prompt: `
409
- [문제] 유사 사례 및 해결책:
410
- - 동일 문제 해결 사례
411
- - 베스트 프랙티스
412
- - 피해야 할 안티패턴
413
- `
414
- })
415
-
416
- Task({
417
- subagent_type: 'explore',
418
- model: 'haiku',
419
- prompt: `
420
- [문제] 관련 코드 분석:
421
- - 문제 발생 지점
422
- - 관련 로직
423
- - 수정 영향 범위
424
- `
425
- })
426
- ```
427
-
428
- ---
185
+ @../../instructions/agent-patterns/delegation-patterns.md
186
+ @../../instructions/agent-patterns/parallel-execution.md
187
+ @../../instructions/agent-patterns/model-routing.md
429
188
 
430
- ### Model Routing
189
+ ### Brainstorm 스킬 고유 패턴
431
190
 
432
- | 조사 유형 | 모델 | Agent | 이유 |
433
- |----------|------|-------|------|
434
- | **트렌드/사례** | sonnet | researcher | 외부 정보 종합 |
435
- | **코드 탐색** | haiku | explore | 빠른 구조 파악 |
436
- | **요구사항** | sonnet | analyst | 분석 품질 |
437
- | **아키텍처** | opus | architect | 설계 깊이 |
438
- | **UI/UX** | sonnet | designer | 창의성 + 실용성 |
191
+ - **다채널 수집**: WebSearch + SearXNG + Firecrawl을 병렬로 실행하여 아이디어 소스 수집
192
+ - **멀티 페르소나**: 여러 관점(사용자, 개발자, 비즈니스)에서 동시에 아이디어 평가
193
+ - **검색 신뢰성**: 검색 쿼리에 현재 연도(2026) 포함 필수, 수집 자료별 발행일+소스유형 기재
439
194
 
440
195
  </parallel_agent_execution>
441
196
 
@@ -445,37 +200,32 @@ Task({
445
200
 
446
201
  ## 아이디어 도출 프레임워크
447
202
 
448
- > AI에 최적화된 8가지 브레인스토밍 기법
449
-
450
- ### 기법 선택 가이드
203
+ ### 기법 선택
451
204
 
452
205
  | 상황 | 추천 기법 |
453
206
  |------|----------|
454
- | **신규 기능 아이디어** | Tree of Thoughts, SCAMPER, Multi-Persona |
455
- | **문제 해결** | Reverse Brainstorming, 5 Whys, Tree of Thoughts |
456
- | **요구사항 발굴** | Starbursting (5W1H), How Might We |
457
- | **아이디어 평가** | 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 |
458
211
  | **빠른 발상** | Crazy 8s, SCAMPER |
459
- | **복잡한 의사결정** | Tree of Thoughts, 6 Thinking Hats |
460
212
 
461
- ---
213
+ ### AI 핵심 기법
462
214
 
463
- ### 1. Tree of Thoughts (ToT) 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 질문 생성 | 문제 재정의, 기회 | "어떻게 [목표] 달성?" |
464
226
 
465
- > 여러 해결 경로를 동시에 탐색하고 평가하는 AI 특화 기법
227
+ ### Tree of Thoughts 병렬 패턴
466
228
 
467
- **원리:** 선형적 사고 대신 트리 구조로 여러 아이디어 분기 → 평가 → 유망한 경로 확장
468
-
469
- **AI 구현:**
470
- ```
471
- 단계 1: 문제를 3-5개 하위 문제로 분해
472
- 단계 2: 각 하위 문제에 3-5개 해결 경로 생성 (병렬)
473
- 단계 3: 각 경로 평가 (실현 가능성 1-5, 영향도 1-5)
474
- 단계 4: 상위 경로 선택 및 심화 탐색
475
- 단계 5: 최종 아이디어 종합
476
- ```
477
-
478
- **병렬 에이전트 패턴:**
479
229
  ```typescript
480
230
  // 여러 경로 동시 탐색
481
231
  Task({ subagent_type: 'analyst', prompt: '경로 A: [접근법 1] 심층 분석' })
@@ -484,25 +234,8 @@ Task({ subagent_type: 'analyst', prompt: '경로 C: [접근법 3] 심층 분석'
484
234
  // → 결과 비교 후 유망 경로 선택
485
235
  ```
486
236
 
487
- **적합한 상황:** 복잡한 문제, 여러 해결책 비교, 의사결정
488
-
489
- ---
490
-
491
- ### 2. Multi-Persona Simulation ⭐ AI 핵심
492
-
493
- > 여러 전문가/이해관계자 관점을 시뮬레이션하여 다각도 아이디어 생성
494
-
495
- **페르소나 예시:**
237
+ ### Multi-Persona 병렬 패턴
496
238
 
497
- | 페르소나 | 관점 | 질문 |
498
- |---------|------|------|
499
- | **CEO** | 비즈니스 가치 | ROI는? 시장 기회는? |
500
- | **개발자** | 기술적 실현 | 구현 가능? 복잡도는? |
501
- | **UX 디자이너** | 사용자 경험 | 직관적인가? 접근성은? |
502
- | **고객** | 실제 사용 | 내 문제를 해결하나? |
503
- | **비평가** | 약점/리스크 | 실패 시나리오는? |
504
-
505
- **병렬 에이전트 패턴:**
506
239
  ```typescript
507
240
  // 여러 페르소나 동시 실행
508
241
  Task({ subagent_type: 'analyst', prompt: 'CEO 관점: 비즈니스 가치 분석' })
@@ -512,168 +245,6 @@ Task({ subagent_type: 'analyst', prompt: '고객 관점: 실제 사용 시나리
512
245
  Task({ subagent_type: 'analyst', prompt: '비평가 관점: 약점과 리스크' })
513
246
  ```
514
247
 
515
- **적합한 상황:** 다각도 검토, 이해관계자 분석, 제품 기획
516
-
517
- ---
518
-
519
- ### 3. SCAMPER 기법
520
-
521
- > 7가지 질문으로 체계적 발상
522
-
523
- | 기법 | 질문 | 예시 |
524
- |------|------|------|
525
- | **S**ubstitute | 대체할 수 있는 것? | 이메일 → 푸시 알림 |
526
- | **C**ombine | 결합할 수 있는 것? | 검색 + 추천 |
527
- | **A**dapt | 적용할 수 있는 것? | 다른 앱의 UX 패턴 |
528
- | **M**odify | 수정/확대/축소? | 단계 축소, 기능 확대 |
529
- | **P**ut to other uses | 다른 용도? | 분석 도구 → 마케팅 도구 |
530
- | **E**liminate | 제거할 것? | 불필요한 단계 제거 |
531
- | **R**earrange | 재배열/역순? | 플로우 순서 변경 |
532
-
533
- **AI 적용:** 각 질문에 대해 3개 이상 아이디어 생성
534
-
535
- ---
536
-
537
- ### 4. Starbursting (5W1H)
538
-
539
- > 질문 중심 브레인스토밍으로 요구사항 발굴
540
-
541
- | 질문 | 탐색 영역 | 예시 질문 |
542
- |------|----------|----------|
543
- | **Who** | 사용자/이해관계자 | 누가 사용하는가? 누가 영향받는가? |
544
- | **What** | 기능/목적 | 무엇을 해결하는가? 무엇이 필요한가? |
545
- | **Where** | 적용 범위 | 어디서 사용되는가? 어떤 환경에서? |
546
- | **When** | 시점/조건 | 언제 필요한가? 어떤 상황에서? |
547
- | **Why** | 목적/가치 | 왜 중요한가? 왜 지금인가? |
548
- | **How** | 구현/방법 | 어떻게 구현하는가? 어떻게 측정하는가? |
549
-
550
- **AI 적용:** 각 질문에 대해 5-10개 하위 질문 생성 → 요구사항 도출
551
-
552
- ---
553
-
554
- ### 5. Reverse Brainstorming
555
-
556
- > 역발상으로 새로운 관점 획득
557
-
558
- **워크플로우:**
559
- ```
560
- 단계 1: "어떻게 하면 [문제]를 악화시킬 수 있을까?"
561
- 단계 2: 악화 시나리오 5-10개 생성
562
- 단계 3: 각 시나리오를 역전환
563
- 단계 4: 실행 가능한 아이디어로 정제
564
- ```
565
-
566
- **예시:**
567
- ```
568
- 문제: "사용자 이탈률을 낮추려면?"
569
- ↓ 역전환
570
- "어떻게 하면 사용자를 더 빨리 이탈시킬까?"
571
- - 복잡한 가입 절차 → 역전환: 원클릭 가입
572
- - 느린 로딩 → 역전환: 스켈레톤 UI + 지연 로딩
573
- - 혼란스러운 네비게이션 → 역전환: 명확한 정보 구조
574
- ```
575
-
576
- **적합한 상황:** 막힌 상황 돌파, 새로운 관점, 문제 예방
577
-
578
- ---
579
-
580
- ### 6. 6 Thinking Hats (AI 버전)
581
-
582
- > 6가지 관점으로 체계적 평가 - 병렬 에이전트 활용
583
-
584
- | 모자 | 관점 | AI 에이전트 | 질문 |
585
- |------|------|-----------|------|
586
- | ⚪ 하얀 | 정보/데이터 | analyst | 현재 데이터가 말하는 것? |
587
- | 🔴 빨간 | 감정/직관 | analyst | 사용자가 느끼는 감정? |
588
- | ⚫ 검은 | 비판/리스크 | analyst | 잠재적 문제점? 실패 시나리오? |
589
- | 🟡 노란 | 긍정/이점 | analyst | 기대 효과? 성공 시나리오? |
590
- | 🟢 초록 | 창의/대안 | designer | 새로운 접근 방법? 대안? |
591
- | 🔵 파란 | 프로세스/관리 | planner | 어떻게 진행? 우선순위? |
592
-
593
- **병렬 에이전트 패턴:**
594
- ```typescript
595
- // 6가지 관점 동시 분석
596
- Task({ subagent_type: 'analyst', prompt: '⚪ White Hat: [주제] 관련 데이터/팩트 분석' })
597
- Task({ subagent_type: 'analyst', prompt: '🔴 Red Hat: [주제] 사용자 감정/직관 분석' })
598
- Task({ subagent_type: 'analyst', prompt: '⚫ Black Hat: [주제] 리스크/문제점 분석' })
599
- Task({ subagent_type: 'analyst', prompt: '🟡 Yellow Hat: [주제] 이점/긍정적 효과 분석' })
600
- Task({ subagent_type: 'designer', prompt: '🟢 Green Hat: [주제] 창의적 대안 제시' })
601
- Task({ subagent_type: 'planner', prompt: '🔵 Blue Hat: [주제] 실행 프로세스 설계' })
602
- ```
603
-
604
- ---
605
-
606
- ### 7. Crazy 8s (AI 버전)
607
-
608
- > 8가지 빠른 아이디어 생성
609
-
610
- **원리:** 양(quantity) 우선, 질(quality)은 나중에
611
-
612
- **AI 적용:**
613
- ```
614
- [주제]에 대해 8가지 서로 다른 아이디어를 빠르게 생성:
615
-
616
- 1. 가장 단순한 해결책
617
- 2. 가장 기술적으로 진보된 해결책
618
- 3. 경쟁사라면 어떻게?
619
- 4. 예산이 무제한이라면?
620
- 5. 예산이 0이라면?
621
- 6. 10년 후라면?
622
- 7. 완전히 다른 분야에서 가져온다면?
623
- 8. 가장 미친 아이디어
624
- ```
625
-
626
- **적합한 상황:** 빠른 발상, 초기 아이디어 탐색, 창의적 돌파
627
-
628
- ---
629
-
630
- ### 8. 5 Whys
631
-
632
- > 근본 원인 분석으로 진짜 문제 발견
633
-
634
- **워크플로우:**
635
- ```
636
- 문제: [현상]
637
- Why 1: 왜 [현상]이 발생하는가? → [원인 1]
638
- Why 2: 왜 [원인 1]이 발생하는가? → [원인 2]
639
- Why 3: 왜 [원인 2]이 발생하는가? → [원인 3]
640
- Why 4: 왜 [원인 3]이 발생하는가? → [원인 4]
641
- Why 5: 왜 [원인 4]이 발생하는가? → [근본 원인]
642
- ```
643
-
644
- **예시:**
645
- ```
646
- 문제: 사용자 이탈률이 높다
647
- Why 1: 왜? → 회원가입 완료율이 낮다
648
- Why 2: 왜? → 가입 폼이 너무 길다
649
- Why 3: 왜? → 불필요한 정보를 수집한다
650
- Why 4: 왜? → 요구사항 분석 없이 설계했다
651
- Why 5: 왜? → 사용자 리서치가 없었다
652
- → 근본 원인: 사용자 리서치 부재
653
- ```
654
-
655
- **적합한 상황:** 버그 분석, 문제 진단, 프로세스 개선
656
-
657
- ---
658
-
659
- ### 9. How Might We (HMW)
660
-
661
- > 디자인 씽킹의 핵심 기법
662
-
663
- **질문 생성 패턴:**
664
- ```
665
- - How might we [사용자 문제]를 해결할 수 있을까?
666
- - How might we [목표]를 더 쉽게 달성할 수 있을까?
667
- - How might we [제약]을 기회로 바꿀 수 있을까?
668
- ```
669
-
670
- **예시:**
671
- - HMW 사용자가 3초 안에 원하는 정보를 찾게 할까?
672
- - HMW 신규 사용자의 이탈률을 낮출까?
673
- - HMW 모바일에서 복잡한 작업을 간단하게 만들까?
674
-
675
- **적합한 상황:** 요구사항 발굴, 문제 재정의, 기회 발견
676
-
677
248
  </ideation_framework>
678
249
 
679
250
  ---
@@ -682,98 +253,13 @@ Why 5: 왜? → 사용자 리서치가 없었다
682
253
 
683
254
  ## 결과물 구조
684
255
 
685
- ### 브레인스토밍 결과 형식
686
-
687
- ```markdown
688
- # 브레인스토밍 결과: [주제]
689
-
690
- **생성일:** YYYY-MM-DD
691
- **관련 컨텍스트:** [프로젝트명 또는 관련 파일]
692
-
693
- ---
694
-
695
- ## 📊 수집 자료 요약
696
-
697
- ### 외부 트렌드
698
- - 트렌드 1: [설명]
699
- - 트렌드 2: [설명]
700
-
701
- ### 경쟁사/사례
702
- - 사례 1: [서비스명] - [특징]
703
- - 사례 2: [서비스명] - [특징]
704
-
705
- ### 현재 시스템
706
- - 강점: [목록]
707
- - 개선점: [목록]
708
- - 제약: [목록]
709
-
710
- ---
711
-
712
- ## 💡 아이디어 목록
713
-
714
- ### 카테고리 1: [예: 사용자 경험]
715
-
716
- | ID | 아이디어 | 설명 | 노력 | 영향도 |
717
- |----|---------|------|------|--------|
718
- | 1-1 | [아이디어명] | [설명] | 낮음 | 높음 |
719
- | 1-2 | [아이디어명] | [설명] | 중간 | 중간 |
720
-
721
- ### 카테고리 2: [예: 기술 개선]
722
-
723
- | ID | 아이디어 | 설명 | 노력 | 영향도 |
724
- |----|---------|------|------|--------|
725
- | 2-1 | [아이디어명] | [설명] | 높음 | 높음 |
726
-
727
- ### 카테고리 3: [예: 비즈니스]
728
-
729
- | ID | 아이디어 | 설명 | 노력 | 영향도 |
730
- |----|---------|------|------|--------|
731
- | 3-1 | [아이디어명] | [설명] | 낮음 | 중간 |
732
-
733
- ---
734
-
735
- ## 📈 우선순위 매트릭스
736
-
737
- ```
738
- 높은 영향도
739
-
740
- [Quick │ [Big
741
- Wins] │ Bets]
742
-
743
- ─────────────┼─────────────
744
-
745
- [Fill │ [Money
746
- Ins] │ Pit]
747
-
748
- 낮은 영향도
749
-
750
- 낮은 노력 ◄──────────► 높은 노력
751
- ```
752
-
753
- ### Quick Wins (낮은 노력 + 높은 영향도)
754
- - 1-1: [아이디어명]
755
-
756
- ### Big Bets (높은 노력 + 높은 영향도)
757
- - 2-1: [아이디어명]
758
-
759
- ### Fill Ins (낮은 노력 + 낮은 영향도)
760
- - 3-1: [아이디어명]
761
-
762
- ---
763
-
764
- ## 🎯 추천 방향
765
-
766
- **최우선 추천:** [아이디어 ID] - [이유]
767
-
768
- **다음 단계:**
769
- 1. [구체적 액션 1]
770
- 2. [구체적 액션 2]
771
- 3. [구체적 액션 3]
772
-
773
- **추가 탐색 필요:**
774
- - [불확실한 영역]
775
- - [추가 조사 필요 항목]
776
- ```
256
+ | 섹션 | 내용 |
257
+ |------|------|
258
+ | **메타데이터** | 주제, 생성일, 관련 컨텍스트 |
259
+ | **📊 수집 자료 요약** | 외부 트렌드, 경쟁사/사례, 현재 시스템 (강점/개선/제약) |
260
+ | **💡 아이디어 목록** | 카테고리별 표 (ID, 아이디어, 설명, 노력, 영향도) |
261
+ | **📈 우선순위 매트릭스** | Quick Wins/Big Bets/Fill Ins/Money Pit 분류 |
262
+ | **🎯 추천 방향** | 최우선 추천, 다음 단계 (구체적 액션), 추가 탐색 필요 항목 |
777
263
 
778
264
  </result_structure>
779
265
 
@@ -783,124 +269,31 @@ Why 5: 왜? → 사용자 리서치가 없었다
783
269
 
784
270
  ## 실전 예시
785
271
 
786
- ### 예시 1: 기능 아이디어 브레인스토밍
272
+ ### 핵심 예시: 기능 아이디어 브레인스토밍
787
273
 
788
274
  ```bash
789
275
  사용자: /brainstorm 사용자 참여를 높일 방법
790
276
 
791
- 1. Sequential Thinking (2단계):
792
- thought 1: "사용자 참여 - 넓은 주제, UX/기능/게이미피케이션 다각도 접근"
793
- thought 2: "외부 트렌드 + 경쟁사 + 현재 시스템 동시 조사"
794
-
795
- 2. 병렬 자료 수집:
796
- Task (researcher): "2024-2025 사용자 참여 트렌드, 게이미피케이션 사례"
797
- Task (researcher): "토스, 카카오, 배민 등 참여 유도 기능 분석"
798
- Task (explore): "현재 앱 사용자 플로우, 참여 포인트 분석"
799
-
800
- 3. Sequential Thinking (3-5단계):
801
- thought 3: "수집 결과 - 알림, 리워드, 소셜, 개인화 4가지 축"
802
- thought 4: "SCAMPER 적용: 기존 기능 결합, 새 기능 추가"
803
- thought 5: "우선순위: Quick Wins → Big Bets 순"
804
-
805
- 4. 결과 저장:
806
- → .claude/brainstorms/00.사용자_참여_향상.md
807
-
808
- 5. 결과 요약:
809
- ## 💡 아이디어 목록
810
-
811
- ### 사용자 경험
812
- - 1-1: 진행률 표시 (낮음/높음) - Quick Win
813
- - 1-2: 개인화 대시보드 (중간/높음)
814
-
815
- ### 게이미피케이션
816
- - 2-1: 연속 사용 보상 (낮음/높음) - Quick Win
817
- - 2-2: 레벨 시스템 (높음/중간)
818
-
819
- ### 소셜
820
- - 3-1: 친구 초대 리워드 (중간/높음)
821
-
822
- ## 🎯 추천: 1-1, 2-1 먼저 구현 (Quick Wins)
823
-
824
- 📁 전체 결과: .claude/brainstorms/00.사용자_참여_향상.md
825
- ```
826
-
827
- ### 예시 2: 기술 선택 브레인스토밍
828
-
829
- ```bash
830
- 사용자: /brainstorm 기술: 실시간 통신 방식 선택
831
-
832
- 1. Sequential Thinking (2단계):
833
- thought 1: "기술 비교 - WebSocket, SSE, Polling 등 옵션"
834
- thought 2: "각 기술 병렬 조사 + 현재 요구사항 분석"
835
-
836
- 2. 병렬 자료 수집:
837
- Task (researcher): "WebSocket 장단점, 사용 사례, 스케일링"
838
- Task (researcher): "SSE 장단점, 브라우저 지원, 제약"
839
- Task (researcher): "Long Polling 장단점, 사용 시나리오"
840
- Task (explore): "현재 통신 구조, 요구사항 분석"
841
-
842
- 3. Sequential Thinking (3-5단계):
843
- thought 3: "요구사항: 양방향 통신, 모바일 지원, 중간 규모"
844
- thought 4: "WebSocket이 요구사항에 가장 적합"
845
- thought 5: "Socket.io vs ws 비교: Socket.io 추천 (재연결 자동화)"
277
+ 1. Sequential Thinking (2단계): 주제 분석 → 채널 배분
278
+ 2. 병렬 자료 수집: researcher (트렌드+경쟁사) + explore (현재 플로우) + MCP
279
+ 3. Sequential Thinking (3-5단계): 수집 결과 SCAMPER 적용 우선순위
280
+ 4. 결과 저장: .claude/brainstorms/00.사용자_참여_향상.md
846
281
 
847
- 4. 결과 저장:
848
- .claude/brainstorms/01.실시간_통신_기술_선택.md
282
+ 결과 요약:
283
+ ## 💡 아이디어 목록
284
+ - 1-1: 진행률 표시 (낮음/높음) - Quick Win
285
+ - 2-1: 연속 사용 보상 (낮음/높음) - Quick Win
286
+ - 3-1: 친구 초대 리워드 (중간/높음)
849
287
 
850
- 5. 결과 요약:
851
- ## 📊 기술 비교
852
-
853
- | 기준 | WebSocket | SSE | Polling |
854
- |------|-----------|-----|---------|
855
- | 양방향 | ✅ | ❌ | ⚠️ |
856
- | 실시간성 | ⭐⭐⭐ | ⭐⭐ | ⭐ |
857
- | 복잡도 | 중간 | 낮음 | 낮음 |
858
- | 스케일링 | 중간 | 높음 | 낮음 |
859
-
860
- ## 🎯 추천: WebSocket (Socket.io)
861
- - 이유: 양방향 필요, 재연결 자동화, 생태계 성숙
862
-
863
- 📁 전체 결과: .claude/brainstorms/01.실시간_통신_기술_선택.md
288
+ ## 🎯 추천: 1-1, 2-1 먼저 구현 (Quick Wins)
864
289
  ```
865
290
 
866
- ### 예시 3: UX 개선 브레인스토밍
867
-
868
- ```bash
869
- 사용자: /brainstorm UX: 모바일 결제 플로우 개선
870
-
871
- 1. Sequential Thinking (2단계):
872
- thought 1: "모바일 결제 UX - 전환율 직결, 사용자 리서치 중요"
873
- thought 2: "경쟁사 UX + 베스트 프랙티스 + 현재 플로우 분석"
291
+ ### 기타 예시
874
292
 
875
- 2. 병렬 자료 수집:
876
- Task (researcher): "토스, 카카오페이, Apple Pay UX 분석"
877
- Task (designer): "모바일 결제 UX 베스트 프랙티스, 마이크로인터랙션"
878
- Task (explore): "현재 결제 플로우, 이탈 포인트 분석"
879
-
880
- 3. Sequential Thinking (3-5단계):
881
- thought 3: "현재 이탈 포인트: 주소 입력, 카드 정보, 최종 확인"
882
- thought 4: "HMW: 어떻게 3단계 → 1단계로 줄일 수 있을까?"
883
- thought 5: "저장된 정보 활용, 원터치 결제, 생체인증"
884
-
885
- 4. 결과 저장:
886
- → .claude/brainstorms/02.모바일_결제_UX_개선.md
887
-
888
- 5. 결과 요약:
889
- ## 💡 아이디어 목록
890
-
891
- ### 단계 축소
892
- - 1-1: 기본 배송지 자동 선택 (낮음/높음)
893
- - 1-2: 원터치 결제 (중간/높음)
894
-
895
- ### 신뢰 구축
896
- - 2-1: 단계 인디케이터 (낮음/중간)
897
- - 2-2: 실시간 에러 안내 (낮음/중간)
898
-
899
- ## 🎯 추천: 1-1, 2-1 먼저 (Quick Wins)
900
- 다음: 1-2 원터치 결제 (Big Bet)
901
-
902
- 📁 전체 결과: .claude/brainstorms/02.모바일_결제_UX_개선.md
903
- ```
293
+ | 예시 | 프로세스 | 결과 |
294
+ |------|----------|------|
295
+ | **기술 선택** | 기술 병렬 조사 + 요구사항 분석 → 비교표 | WebSocket (Socket.io) 추천 |
296
+ | **UX 개선** | 경쟁사 UX + 베스트 프랙티스 + 현재 플로우 HMW | Quick Wins (자동 선택, 인디케이터) 우선 |
904
297
 
905
298
  </examples>
906
299
 
@@ -926,6 +319,15 @@ Why 5: 왜? → 사용자 리서치가 없었다
926
319
  ✅ 파일 경로 사용자에게 안내
927
320
  ```
928
321
 
322
+ 신뢰도 검증:
323
+
324
+ ```text
325
+ ✅ 검색 쿼리에 현재 연도 포함 (2026)
326
+ ✅ 수집 자료별 발행일/출처 확인
327
+ ✅ 오래된 정보 (3년 이상) 제외 또는 명시
328
+ ✅ 출처 신뢰도 평가 (공식 문서 > 기술 블로그 > 커뮤니티)
329
+ ```
330
+
929
331
  절대 금지:
930
332
 
931
333
  ```text
@@ -935,13 +337,14 @@ Why 5: 왜? → 사용자 리서치가 없었다
935
337
  ❌ 평가 기준 없이 나열
936
338
  ❌ 다음 단계 없이 종료
937
339
  ❌ 결과 저장 없이 종료
340
+ ❌ 발행일 미확인 정보 기반 추천
938
341
  ```
939
342
 
940
343
  ## 병렬 실행 체크리스트
941
344
 
942
345
  ```text
943
346
  ✅ 다각도 수집: 외부 + 내부 + 분석 + MCP
944
- ✅ researcher: 트렌드, 사례, 베스트 프랙티스
347
+ ✅ researcher: 트렌드, 사례, 베스트 프랙티스 (검색 쿼리에 현재 연도)
945
348
  ✅ explore: 코드베이스, 현재 구조
946
349
  ✅ analyst/designer: 요구사항, UX
947
350
  ✅ main agent: MCP 가용 시 firecrawl_search/scrape 직접 실행