@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,10 @@ 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/phase-based-execution.md
12
+ @../../instructions/context-optimization/sub-agent-distribution.md
13
+ @../../instructions/validation/scope-completeness.md
10
14
  @../../instructions/validation/forbidden-patterns.md
11
15
  @../../instructions/validation/required-behaviors.md
12
16
 
@@ -56,997 +60,19 @@ Task({
56
60
 
57
61
  <parallel_agent_execution>
58
62
 
59
- ## 병렬 Agent 실행
63
+ ## 병렬 에이전트 실행
60
64
 
61
- ### Recommended Agents
62
-
63
- | Agent | Model | 용도 | 복잡도 |
64
- |-------|-------|------|--------|
65
- | **@planner** | opus | 계획 수립, 체계적 분석 | HIGH |
66
- | **@explore** | haiku/sonnet | 코드베이스 탐색, 구조 파악 | LOW-MEDIUM |
67
- | **@architect** | sonnet/opus | 아키텍처 분석, 설계 검토 (READ-ONLY) | MEDIUM-HIGH |
68
- | **@analyst** | sonnet | 요구사항 분석, 기술 조사, 가정 검증 | MEDIUM |
69
- | **@critic** | opus | 계획 리뷰, OKAY/REJECT 판정 | HIGH |
70
- | **@researcher** | sonnet | 외부 문서/API/라이브러리 조사 | MEDIUM |
71
- | **@scientist** | sonnet | 데이터 분석 프로젝트 계획, 통계 연구 | MEDIUM |
72
-
73
- ---
74
-
75
- ### Parallel Execution Patterns
76
-
77
- ### Read 도구 병렬화
78
-
79
- **프로젝트 분석 시 파일 병렬 읽기:**
80
-
81
- ```typescript
82
- // ❌ 순차 읽기 (느림)
83
- Read({ file_path: "src/file1.ts" })
84
- // 대기...
85
- Read({ file_path: "src/file2.ts" })
86
-
87
- // ✅ 병렬 읽기 (빠름)
88
- Read({ file_path: "src/file1.ts" })
89
- Read({ file_path: "src/file2.ts" })
90
- Read({ file_path: "src/file3.ts" })
91
- Read({ file_path: "docs/api.md" })
92
- ```
93
-
94
- **복잡한 탐색은 explore 에이전트 활용:**
95
-
96
- ```typescript
97
- // 여러 영역 동시 탐색
98
- Task(subagent_type="explore", model="haiku",
99
- prompt="영역 1 파일 구조 및 패턴 분석")
100
- Task(subagent_type="explore", model="haiku",
101
- prompt="영역 2 의존성 및 관계 분석")
102
- ```
103
-
104
- ---
105
-
106
- **1. 탐색 + 분석 병렬**
107
-
108
- 복잡한 시스템에서 여러 영역을 동시에 조사할 때 사용:
109
-
110
- ```typescript
111
- // 프론트엔드 + 백엔드 동시 탐색
112
- Task({
113
- subagent_type: 'explore',
114
- model: 'haiku',
115
- prompt: '프론트엔드 인증 UI 및 상태 관리 구조 분석'
116
- })
117
-
118
- Task({
119
- subagent_type: 'explore',
120
- model: 'haiku',
121
- prompt: '백엔드 인증 API 엔드포인트 및 미들웨어 분석'
122
- })
123
-
124
- Task({
125
- subagent_type: 'architect',
126
- model: 'sonnet',
127
- prompt: '현재 인증 아키텍처 평가 및 개선점 도출'
128
- })
129
- ```
130
-
131
- **2. 여러 영역 계획 병렬**
132
-
133
- 독립적인 모듈/시스템을 각각 계획할 때:
134
-
135
- ```typescript
136
- // 여러 모듈 리팩토링 계획 동시 수립
137
- Task({
138
- subagent_type: 'planner',
139
- model: 'opus',
140
- prompt: 'User 모듈 리팩토링 상세 계획 수립'
141
- })
142
-
143
- Task({
144
- subagent_type: 'planner',
145
- model: 'opus',
146
- prompt: 'Payment 모듈 리팩토링 상세 계획 수립'
147
- })
148
-
149
- Task({
150
- subagent_type: 'planner',
151
- model: 'sonnet',
152
- prompt: 'Notification 모듈 리팩토링 상세 계획 수립'
153
- })
154
- ```
155
-
156
- **3. 조사 병렬화**
157
-
158
- 기술 스택 선정, 라이브러리 비교 시:
159
-
160
- ```typescript
161
- // 여러 솔루션 동시 조사
162
- Task({
163
- subagent_type: 'analyst',
164
- model: 'sonnet',
165
- prompt: 'WebSocket 라이브러리 조사 (Socket.io, ws, uWebSockets)'
166
- })
167
-
168
- Task({
169
- subagent_type: 'analyst',
170
- model: 'sonnet',
171
- prompt: 'SSE 구현 방식 조사 (EventSource, fetch streams)'
172
- })
173
-
174
- Task({
175
- subagent_type: 'analyst',
176
- model: 'sonnet',
177
- prompt: '폴링 방식 조사 (short/long polling 패턴)'
178
- })
179
- ```
180
-
181
- **4. 다중 대안 병렬 분석**
182
-
183
- 여러 옵션을 동시에 평가하여 비교:
184
-
185
- ```typescript
186
- // Option A, B, C를 각각 다른 analyst에게 동시 분석
187
- Task({
188
- subagent_type: 'analyst',
189
- model: 'sonnet',
190
- description: 'Option A 분석',
191
- prompt: `
192
- 상태 관리 옵션 A (Zustand) 분석:
193
- - 학습 곡선, 번들 크기, 성능
194
- - TanStack Router 통합
195
- - 장단점, 리스크
196
- `
197
- })
198
-
199
- Task({
200
- subagent_type: 'analyst',
201
- model: 'sonnet',
202
- description: 'Option B 분석',
203
- prompt: `
204
- 상태 관리 옵션 B (Jotai) 분석:
205
- - 원자적 상태, 리렌더 최적화
206
- - TanStack Router 통합
207
- - 장단점, 리스크
208
- `
209
- })
210
-
211
- Task({
212
- subagent_type: 'analyst',
213
- model: 'sonnet',
214
- description: 'Option C 분석',
215
- prompt: `
216
- 상태 관리 옵션 C (Context API) 분석:
217
- - 빌트인, 별도 의존성 없음
218
- - 성능 이슈, 최적화 방법
219
- - 장단점, 리스크
220
- `
221
- })
222
-
223
- // → 결과 비교 후 최적 옵션 추천
224
- ```
225
-
226
- **5. 기술 스택 조사 동시 실행**
227
-
228
- 프레임워크, 라이브러리, 인프라를 병렬 조사:
229
-
230
- ```typescript
231
- // 신규 프로젝트 기술 스택 조사
232
- Task({
233
- subagent_type: 'analyst',
234
- model: 'sonnet',
235
- description: '프레임워크 조사',
236
- prompt: `
237
- 프론트엔드 프레임워크 비교:
238
- - Next.js, Remix, TanStack Start
239
- - SSR/SSG 지원, 라우팅, 성능
240
- - 생태계, 유지보수성
241
- `
242
- })
243
-
244
- Task({
245
- subagent_type: 'analyst',
246
- model: 'sonnet',
247
- description: '데이터베이스 조사',
248
- prompt: `
249
- 데이터베이스 옵션 비교:
250
- - PostgreSQL, MySQL, Prisma (ORM)
251
- - 스키마 설계, 마이그레이션
252
- - 스케일링, 백업 전략
253
- `
254
- })
255
-
256
- Task({
257
- subagent_type: 'analyst',
258
- model: 'sonnet',
259
- description: '인프라 조사',
260
- prompt: `
261
- 배포 인프라 비교:
262
- - Vercel, Cloudflare, AWS
263
- - CI/CD, 모니터링, 비용
264
- - 제약사항, 확장성
265
- `
266
- })
267
-
268
- // → 통합 기술 스택 제안
269
- ```
270
-
271
- **6. 리스크 평가 병렬화**
272
-
273
- 기술적, 일정, 비용, 인력 리스크를 동시 평가:
274
-
275
- ```typescript
276
- // 마이그레이션 프로젝트 리스크 평가
277
- Task({
278
- subagent_type: 'analyst',
279
- model: 'sonnet',
280
- description: '기술적 리스크',
281
- prompt: `
282
- 레거시 → 현대 스택 마이그레이션 기술 리스크:
283
- - 호환성 문제
284
- - 데이터 마이그레이션
285
- - 의존성 충돌
286
- `
287
- })
288
-
289
- Task({
290
- subagent_type: 'planner',
291
- model: 'opus',
292
- description: '일정 리스크',
293
- prompt: `
294
- 마이그레이션 일정 리스크:
295
- - 병목 구간 예측
296
- - 불확실성 요소
297
- - 완충 시간 필요성
298
- `
299
- })
300
-
301
- Task({
302
- subagent_type: 'analyst',
303
- model: 'sonnet',
304
- description: '비용 리스크',
305
- prompt: `
306
- 마이그레이션 비용 리스크:
307
- - 인프라 전환 비용
308
- - 예상 외 비용 요소
309
- - ROI 분석
310
- `
311
- })
312
-
313
- Task({
314
- subagent_type: 'planner',
315
- model: 'sonnet',
316
- description: '인력 리스크',
317
- prompt: `
318
- 마이그레이션 인력 리스크:
319
- - 기술 스택 학습 시간
320
- - 외부 전문가 필요성
321
- - 팀 역량 갭
322
- `
323
- })
324
-
325
- // → 종합 리스크 보고서 생성
326
- ```
327
-
328
- **7. 아키텍처 다이어그램 + 기술 문서 동시 생성**
329
-
330
- 설계와 문서화를 병렬 처리:
331
-
332
- ```typescript
333
- // 계획 수립 중 문서화 동시 진행
334
- Task({
335
- subagent_type: 'architect',
336
- model: 'opus',
337
- description: '아키텍처 설계',
338
- prompt: `
339
- 마이크로서비스 아키텍처 설계:
340
- - 서비스 분리 전략
341
- - API Gateway, 인증, DB
342
- - Mermaid 다이어그램 작성
343
- `
344
- })
345
-
346
- Task({
347
- subagent_type: 'planner',
348
- model: 'sonnet',
349
- description: '기술 문서 초안',
350
- prompt: `
351
- 기술 문서 초안 작성:
352
- - 서비스 책임 정의
353
- - 통신 프로토콜
354
- - 배포 전략
355
- `
356
- })
357
-
358
- Task({
359
- subagent_type: 'analyst',
360
- model: 'sonnet',
361
- description: '보안 요구사항',
362
- prompt: `
363
- 보안 요구사항 분석:
364
- - 인증/인가 방식
365
- - 데이터 암호화
366
- - 감사 로그
367
- `
368
- })
369
-
370
- // → 아키텍처 문서 + 다이어그램 + 보안 가이드
371
- ```
372
-
373
- **8. 다중 관점 검증 (병렬 평가)**
374
-
375
- 보안, 성능, 확장성, 유지보수성을 동시 검토:
376
-
377
- ```typescript
378
- // 계획된 접근 방식을 여러 관점에서 평가
379
- Task({
380
- subagent_type: 'analyst',
381
- model: 'opus',
382
- description: '보안 관점 검증',
383
- prompt: `
384
- 계획된 접근 방식 보안 검증:
385
- - 인증/인가 취약점
386
- - 데이터 노출 위험
387
- - 보안 베스트 프랙티스 준수
388
- `
389
- })
390
-
391
- Task({
392
- subagent_type: 'analyst',
393
- model: 'opus',
394
- description: '성능 관점 검증',
395
- prompt: `
396
- 계획된 접근 방식 성능 검증:
397
- - 병목 구간 예측
398
- - 스케일링 전략
399
- - 캐싱, 최적화 방안
400
- `
401
- })
402
-
403
- Task({
404
- subagent_type: 'architect',
405
- model: 'opus',
406
- description: '확장성 검증',
407
- prompt: `
408
- 계획된 접근 방식 확장성 검증:
409
- - 수평/수직 확장 가능성
410
- - 모듈화, 느슨한 결합
411
- - 향후 변경 용이성
412
- `
413
- })
414
-
415
- Task({
416
- subagent_type: 'analyst',
417
- model: 'sonnet',
418
- description: '유지보수성 검증',
419
- prompt: `
420
- 계획된 접근 방식 유지보수성 검증:
421
- - 코드 복잡도
422
- - 테스트 가능성
423
- - 문서화 전략
424
- `
425
- })
426
-
427
- // → 통합 검증 보고서 생성
428
- ```
429
-
430
- **패턴 9: 계획 문서 병렬 작성 (Plan 특화)**
431
-
432
- 옵션 선택 후 여러 문서를 동시에 작성:
433
-
434
- ```typescript
435
- // 옵션 선택 후 5개 문서 동시 작성
436
- Task({
437
- subagent_type: 'document-writer',
438
- model: 'haiku',
439
- description: 'OVERVIEW.md 작성',
440
- prompt: `
441
- OVERVIEW.md 작성:
442
- - 개요 (목표, 범위)
443
- - 현재 상태 분석
444
- - 선택된 옵션 및 이유
445
- `
446
- })
447
-
448
- Task({
449
- subagent_type: 'document-writer',
450
- model: 'haiku',
451
- description: 'OPTIONS.md 작성',
452
- prompt: `
453
- OPTIONS.md 작성:
454
- - 모든 옵션 비교표 (1, 2, 3)
455
- - 장단점, 영향 범위
456
- - 추천 옵션 및 근거
457
- `
458
- })
459
-
460
- Task({
461
- subagent_type: 'document-writer',
462
- model: 'sonnet',
463
- description: 'IMPLEMENTATION.md 작성',
464
- prompt: `
465
- IMPLEMENTATION.md 작성:
466
- - 구현 단계 (1단계, 2단계, ...)
467
- - 각 단계별 작업 체크리스트
468
- - 변경 파일 목록
469
- `
470
- })
471
-
472
- Task({
473
- subagent_type: 'document-writer',
474
- model: 'haiku',
475
- description: 'RISKS.md 작성',
476
- prompt: `
477
- RISKS.md 작성:
478
- - 기술적 리스크
479
- - 일정 리스크
480
- - 완화 방안
481
- `
482
- })
483
-
484
- Task({
485
- subagent_type: 'document-writer',
486
- model: 'haiku',
487
- description: 'REFERENCES.md 작성',
488
- prompt: `
489
- REFERENCES.md 작성:
490
- - 코드베이스 분석 결과
491
- - 관련 문서 링크
492
- - 참고 자료
493
- `
494
- })
495
-
496
- // → 5개 문서 병렬 생성으로 빠르게 계획 문서화
497
- ```
498
-
499
- **모델 선택:**
500
- - IMPLEMENTATION.md는 복잡하므로 sonnet
501
- - 나머지는 haiku로 충분
502
-
503
- ---
504
-
505
- **패턴 10: 계획 수립 후 검증 (critic)**
506
-
507
- 계획 완료 후 별도 에이전트로 검증:
508
-
509
- ```typescript
510
- // ✅ 계획 수립 후 검증
511
- Task({
512
- subagent_type: 'planner',
513
- model: 'opus',
514
- prompt: '인증 시스템 재설계 계획 수립'
515
- })
516
- // 계획 완료 후
517
- Task({
518
- subagent_type: 'critic',
519
- model: 'opus',
520
- prompt: '.claude/plan/00.인증_시스템/IMPLEMENTATION.md 계획 검증 - OKAY/REJECT 판정'
521
- })
522
- ```
523
-
524
- **패턴 11: 기술 조사 병렬 (researcher)**
525
-
526
- 외부 문서 조사와 내부 분석을 병렬 실행:
527
-
528
- ```typescript
529
- // ✅ 기술 조사 + 내부 분석 병렬
530
- Task({
531
- subagent_type: 'researcher',
532
- model: 'sonnet',
533
- prompt: 'WebSocket vs SSE 공식 문서 및 성능 비교 조사'
534
- })
535
- Task({
536
- subagent_type: 'analyst',
537
- model: 'sonnet',
538
- prompt: '현재 프로젝트에서 실시간 통신 요구사항 분석'
539
- })
540
- ```
541
-
542
- ---
543
-
544
- ### Model Routing
545
-
546
- | 복잡도 | 조건 | 권장 Model | Agent | 예시 |
547
- |--------|------|-----------|-------|------|
548
- | **LOW** | 단순 탐색, 파일 목록 | haiku | explore | 파일 구조 파악, 간단한 조사 |
549
- | **MEDIUM** | 일반 분석, 기술 조사 | sonnet | analyst, planner | 요구사항 분석, 옵션 비교 |
550
- | **HIGH** | 복잡한 설계, 아키텍처 | opus | planner, architect | 시스템 재설계, 아키텍처 결정 |
551
-
552
- **Model 선택 가이드:**
553
-
554
- ```text
555
- ✅ haiku:
556
- - 빠른 탐색, 파일 목록, 구조 파악
557
- - 간단한 조사, 문서 초안
558
- - 병렬 실행 시 비용 최적화
559
-
560
- ✅ sonnet:
561
- - 일반 분석, 코드 리뷰, 패턴 도출
562
- - 요구사항 분석, 기술 조사
563
- - 옵션 비교, 리스크 평가
564
- - 균형잡힌 품질/비용
565
-
566
- ✅ opus:
567
- - 복잡한 설계, 아키텍처 결정
568
- - 체계적 계획, 전략 수립
569
- - 다중 관점 검증 (보안, 성능)
570
- - 최고 품질 필요 시
571
- ```
572
-
573
- **Agent별 모델 추천:**
574
-
575
- | Agent | 기본 모델 | 복잡한 경우 | 이유 |
576
- |-------|----------|------------|------|
577
- | **explore** | haiku | sonnet | 탐색은 빠르게, 복잡한 분석은 sonnet |
578
- | **analyst** | sonnet | opus | 일반 조사는 sonnet, 전략적 결정은 opus |
579
- | **planner** | opus | opus | 계획은 항상 고품질 |
580
- | **architect** | sonnet | opus | 일반 분석은 sonnet, 설계는 opus |
581
- | **critic** | opus | opus | 계획 검증은 높은 품질 필요 |
582
- | **researcher** | sonnet | sonnet | 외부 조사는 sonnet으로 충분 |
583
-
584
- ---
585
-
586
- ### Practical Examples
587
-
588
- **예시 1: 인증 시스템 재설계 (탐색 + 아키텍처 병렬)**
589
-
590
- ```typescript
591
- // 1단계: 현재 상태 탐색 (병렬)
592
- Task({
593
- subagent_type: 'explore',
594
- model: 'haiku',
595
- description: '인증 UI 분석',
596
- prompt: '로그인/회원가입 UI, 폼 검증, 에러 처리 분석'
597
- })
598
-
599
- Task({
600
- subagent_type: 'explore',
601
- model: 'sonnet',
602
- description: '인증 API 분석',
603
- prompt: 'API 엔드포인트, 미들웨어, 토큰 관리 방식 분석'
604
- })
605
-
606
- Task({
607
- subagent_type: 'explore',
608
- model: 'haiku',
609
- description: 'DB 스키마 분석',
610
- prompt: 'User 테이블, 세션 테이블, 관계 분석'
611
- })
612
-
613
- // 2단계: 요구사항 및 아키텍처 분석 (병렬)
614
- Task({
615
- subagent_type: 'analyst',
616
- model: 'sonnet',
617
- description: '요구사항 분석',
618
- prompt: `
619
- 인증 시스템 요구사항 분석:
620
- - 가정 검증 (소셜 로그인, 2FA, 비밀번호 재설정)
621
- - 엣지 케이스 (세션 만료, 동시 로그인)
622
- - 보안 요구사항
623
- `
624
- })
625
-
626
- Task({
627
- subagent_type: 'architect',
628
- model: 'opus',
629
- description: '인증 아키텍처 평가',
630
- prompt: `
631
- 탐색 결과 기반으로:
632
- 1. 현재 아키텍처 문제점 도출
633
- 2. 개선 방향 제시
634
- 3. 마이그레이션 전략 수립
635
- `
636
- })
637
-
638
- // → 결과 취합 후 옵션 제시
639
- ```
640
-
641
- **예시 2: 여러 모듈 리팩토링 계획 (계획 병렬)**
642
-
643
- ```typescript
644
- // 독립적인 모듈들을 동시에 계획
645
- Task({
646
- subagent_type: 'planner',
647
- model: 'opus',
648
- description: 'User 모듈 계획',
649
- prompt: `
650
- User 모듈 리팩토링:
651
- - 복잡도 감소
652
- - 타입 안정성 향상
653
- - 테스트 커버리지 증대
654
- `
655
- })
656
-
657
- Task({
658
- subagent_type: 'planner',
659
- model: 'opus',
660
- description: 'Payment 모듈 계획',
661
- prompt: `
662
- Payment 모듈 리팩토링:
663
- - 트랜잭션 안정성
664
- - 에러 핸들링 개선
665
- - 로깅 강화
666
- `
667
- })
668
-
669
- Task({
670
- subagent_type: 'planner',
671
- model: 'sonnet',
672
- description: 'Notification 모듈 계획',
673
- prompt: `
674
- Notification 모듈 리팩토링:
675
- - 템플릿 구조화
676
- - 다국어 지원
677
- - 전송 실패 재시도
678
- `
679
- })
680
-
681
- // → 각 모듈별 .claude/plan/00.User_모듈/, 01.Payment_모듈/ 문서 생성
682
- ```
683
-
684
- **예시 3: 실시간 기능 기술 조사 (조사 병렬)**
685
-
686
- ```typescript
687
- // 여러 기술 스택 동시 조사
688
- Task({
689
- subagent_type: 'analyst',
690
- model: 'sonnet',
691
- description: 'WebSocket 조사',
692
- prompt: `
693
- WebSocket 구현 조사:
694
- - Socket.io vs ws vs uWebSockets
695
- - 스케일링 방안
696
- - 장단점 분석
697
- `
698
- })
699
-
700
- Task({
701
- subagent_type: 'analyst',
702
- model: 'sonnet',
703
- description: 'SSE 조사',
704
- prompt: `
705
- Server-Sent Events 조사:
706
- - 브라우저 호환성
707
- - 재연결 처리
708
- - 제약사항
709
- `
710
- })
711
-
712
- Task({
713
- subagent_type: 'analyst',
714
- model: 'haiku',
715
- description: '폴링 조사',
716
- prompt: `
717
- 폴링 방식 조사:
718
- - Short vs Long polling
719
- - 리소스 사용량
720
- - 적용 시나리오
721
- `
722
- })
723
-
724
- // → 결과 비교 후 기술 스택 추천
725
- ```
726
-
727
- **예시 4: 신규 프로젝트 계획 (기술 스택 + 아키텍처 병렬)**
728
-
729
- ```typescript
730
- // 신규 프로젝트 초기 계획 수립
731
- Task({
732
- subagent_type: 'analyst',
733
- model: 'sonnet',
734
- description: '요구사항 분석',
735
- prompt: `
736
- 신규 프로젝트 요구사항 분석:
737
- - 핵심 기능 정의
738
- - 비기능 요구사항 (성능, 보안, 확장성)
739
- - 제약사항 및 우선순위
740
- `
741
- })
742
-
743
- Task({
744
- subagent_type: 'analyst',
745
- model: 'sonnet',
746
- description: '기술 스택 조사',
747
- prompt: `
748
- 기술 스택 비교 분석:
749
- - 프론트엔드 (React 기반 프레임워크)
750
- - 백엔드 (Node.js vs Python)
751
- - 데이터베이스 (SQL vs NoSQL)
752
- - 인프라 (클라우드 옵션)
753
- `
754
- })
755
-
756
- Task({
757
- subagent_type: 'architect',
758
- model: 'opus',
759
- description: '아키텍처 설계',
760
- prompt: `
761
- 시스템 아키텍처 초안:
762
- - 레이어 분리 전략
763
- - API 설계 원칙
764
- - 데이터 흐름
765
- - Mermaid 다이어그램
766
- `
767
- })
768
-
769
- Task({
770
- subagent_type: 'planner',
771
- model: 'opus',
772
- description: '프로젝트 일정 수립',
773
- prompt: `
774
- 프로젝트 일정 계획:
775
- - MVP 범위 정의
776
- - 단계별 마일스톤
777
- - 리스크 및 완충 시간
778
- `
779
- })
780
-
781
- // → 종합 프로젝트 계획서 생성
782
- ```
783
-
784
- **예시 5: 레거시 마이그레이션 (리스크 평가 + 전략 수립)**
785
-
786
- ```typescript
787
- // 레거시 시스템 → 현대 스택 마이그레이션 계획
788
- Task({
789
- subagent_type: 'explore',
790
- model: 'haiku',
791
- description: '레거시 구조 분석',
792
- prompt: '레거시 시스템 구조, 의존성, 기술 스택 파악'
793
- })
794
-
795
- Task({
796
- subagent_type: 'analyst',
797
- model: 'sonnet',
798
- description: '기술적 리스크',
799
- prompt: `
800
- 마이그레이션 기술 리스크:
801
- - 호환성 문제
802
- - 데이터 무결성
803
- - 의존성 충돌
804
- `
805
- })
806
-
807
- Task({
808
- subagent_type: 'planner',
809
- model: 'opus',
810
- description: '일정 리스크',
811
- prompt: `
812
- 마이그레이션 일정 리스크:
813
- - 병목 구간
814
- - 예상 외 지연 요인
815
- - 완충 시간 확보
816
- `
817
- })
818
-
819
- Task({
820
- subagent_type: 'architect',
821
- model: 'opus',
822
- description: '마이그레이션 전략',
823
- prompt: `
824
- 단계적 마이그레이션 전략:
825
- - Strangler Fig 패턴
826
- - 점진적 전환 계획
827
- - 롤백 시나리오
828
- `
829
- })
830
-
831
- // → 마이그레이션 로드맵 생성
832
- ```
833
-
834
- **예시 6: 성능 최적화 계획 (다중 관점 분석)**
835
-
836
- ```typescript
837
- // 성능 문제 분석 및 개선 계획
838
- Task({
839
- subagent_type: 'explore',
840
- model: 'haiku',
841
- description: '성능 병목 탐색',
842
- prompt: '느린 페이지, API 엔드포인트, DB 쿼리 식별'
843
- })
844
-
845
- Task({
846
- subagent_type: 'analyst',
847
- model: 'sonnet',
848
- description: '프론트엔드 성능',
849
- prompt: `
850
- 프론트엔드 성능 분석:
851
- - 번들 크기, 불필요한 리렌더
852
- - 이미지 최적화, 코드 스플리팅
853
- - 개선 방안
854
- `
855
- })
856
-
857
- Task({
858
- subagent_type: 'analyst',
859
- model: 'sonnet',
860
- description: '백엔드 성능',
861
- prompt: `
862
- 백엔드 성능 분석:
863
- - DB 쿼리 최적화 (N+1 문제)
864
- - 캐싱 전략
865
- - API 응답 시간 개선
866
- `
867
- })
868
-
869
- Task({
870
- subagent_type: 'architect',
871
- model: 'opus',
872
- description: '인프라 최적화',
873
- prompt: `
874
- 인프라 최적화 전략:
875
- - CDN, 로드 밸런싱
876
- - 스케일링 전략
877
- - 모니터링 및 알림
878
- `
879
- })
880
-
881
- // → 통합 성능 최적화 계획
882
- ```
883
-
884
- **예시 7: 보안 강화 계획 (다중 관점 검증)**
885
-
886
- ```typescript
887
- // 보안 취약점 분석 및 강화 계획
888
- Task({
889
- subagent_type: 'analyst',
890
- model: 'opus',
891
- description: '인증/인가 보안',
892
- prompt: `
893
- 인증/인가 보안 검토:
894
- - 세션 관리 취약점
895
- - 권한 상승 위험
896
- - 개선 방안
897
- `
898
- })
899
-
900
- Task({
901
- subagent_type: 'analyst',
902
- model: 'opus',
903
- description: 'API 보안',
904
- prompt: `
905
- API 보안 검토:
906
- - SQL Injection, XSS, CSRF
907
- - 입력 검증, 출력 인코딩
908
- - Rate Limiting
909
- `
910
- })
911
-
912
- Task({
913
- subagent_type: 'analyst',
914
- model: 'sonnet',
915
- description: '데이터 보안',
916
- prompt: `
917
- 데이터 보안 검토:
918
- - 민감 정보 암호화
919
- - 접근 제어, 감사 로그
920
- - GDPR 준수
921
- `
922
- })
923
-
924
- Task({
925
- subagent_type: 'architect',
926
- model: 'opus',
927
- description: '인프라 보안',
928
- prompt: `
929
- 인프라 보안 검토:
930
- - 네트워크 분리, 방화벽
931
- - 의존성 취약점 스캔
932
- - 모니터링 및 경고
933
- `
934
- })
935
-
936
- // → 보안 강화 로드맵 생성
937
- ```
938
-
939
- **예시 8: 대규모 리팩토링 (모듈별 병렬 계획)**
940
-
941
- ```typescript
942
- // 여러 모듈을 동시에 분석하고 계획 수립
943
- Task({
944
- subagent_type: 'analyst',
945
- model: 'sonnet',
946
- description: 'User 모듈 분석',
947
- prompt: `
948
- User 모듈 현황 분석:
949
- - 복잡도, 의존성
950
- - 테스트 커버리지
951
- - 리팩토링 우선순위
952
- `
953
- })
954
-
955
- Task({
956
- subagent_type: 'analyst',
957
- model: 'sonnet',
958
- description: 'Payment 모듈 분석',
959
- prompt: `
960
- Payment 모듈 현황 분석:
961
- - 트랜잭션 안정성
962
- - 에러 핸들링 품질
963
- - 개선 필요 항목
964
- `
965
- })
966
-
967
- Task({
968
- subagent_type: 'analyst',
969
- model: 'sonnet',
970
- description: 'Notification 모듈 분석',
971
- prompt: `
972
- Notification 모듈 현황 분석:
973
- - 템플릿 구조
974
- - 다국어 지원 현황
975
- - 개선 필요 항목
976
- `
977
- })
978
-
979
- Task({
980
- subagent_type: 'planner',
981
- model: 'opus',
982
- description: '통합 리팩토링 계획',
983
- prompt: `
984
- 모듈별 분석 결과 기반 통합 계획:
985
- - 우선순위 및 일정
986
- - 의존성 관리
987
- - 단계별 마일스톤
988
- `
989
- })
990
-
991
- // → 모듈별 리팩토링 계획 + 통합 로드맵
992
- ```
993
-
994
- ---
995
-
996
- ### 병렬 실행 시 고려사항
997
-
998
- ```text
999
- ✅ DO:
1000
- - 독립적인 작업만 병렬 실행 (의존성 없는 경우)
1001
- - 결과 취합 후 통합 분석 수행
1002
- - 모델 선택 시 복잡도 고려 (haiku/sonnet/opus)
1003
- - 병렬 실행 수는 3-5개 권장 (너무 많으면 복잡)
1004
- - 각 에이전트에게 명확한 범위 전달
1005
- - 다중 관점 검증 시 병렬 활용 (보안/성능/확장성)
1006
- - 기술 스택 조사 시 병렬 조사 후 비교
1007
-
1008
- ❌ DON'T:
1009
- - 순차 의존성이 있는 작업 병렬화 금지
1010
- - 결과 취합 없이 개별 결과만 사용
1011
- - 모든 작업에 opus 사용 (비용/시간 낭비)
1012
- - 병렬 실행 수 너무 많음 (5개 초과)
1013
- - 같은 영역을 중복 분석
1014
- ```
65
+ @../../instructions/agent-patterns/delegation-patterns.md
66
+ @../../instructions/agent-patterns/parallel-execution.md
67
+ @../../instructions/agent-patterns/model-routing.md
1015
68
 
1016
- ---
69
+ ### Plan 스킬 고유 패턴
1017
70
 
1018
- ### 병렬 에이전트 체크리스트
71
+ **옵션 도출 병렬화**: 여러 접근 방법을 동시에 분석할 때, 각 옵션을 별도 에이전트에게 위임하여 병렬로 평가
1019
72
 
1020
- 계획 수립 확인:
73
+ **문서 병렬 생성**: OVERVIEW.md, OPTIONS.md, IMPLEMENTATION.md, RISKS.md, REFERENCES.md를 동시에 작성할 때 document-writer 에이전트 병렬 활용
1021
74
 
1022
- ```text
1023
- ✅ 탐색 단계
1024
- [ ] 여러 영역 동시 탐색 가능? → explore (haiku) 병렬 실행
1025
- [ ] 요구사항 불명확? → analyst (sonnet) 병렬 분석
1026
-
1027
- ✅ 분석 단계
1028
- [ ] 다중 옵션 비교 필요? → analyst (sonnet) 병렬 평가
1029
- [ ] 기술 스택 조사 필요? → analyst (sonnet) 병렬 조사
1030
- [ ] 리스크 평가 필요? → analyst + planner 병렬 평가
1031
-
1032
- ✅ 설계 단계
1033
- [ ] 아키텍처 + 문서화? → architect + planner 병렬
1034
- [ ] 여러 모듈 설계? → planner (opus) 병렬 수립
1035
-
1036
- ✅ 검증 단계
1037
- [ ] 다중 관점 검증? → analyst/architect (opus) 병렬 검토
1038
- [ ] 보안/성능/확장성 검토? → 각 관점별 병렬 실행
1039
-
1040
- ✅ 모델 선택
1041
- [ ] 복잡도 LOW → haiku
1042
- [ ] 복잡도 MEDIUM → sonnet
1043
- [ ] 복잡도 HIGH → opus
1044
-
1045
- ✅ 병렬 실행 수
1046
- [ ] 3-5개 권장
1047
- [ ] 독립성 확인
1048
- [ ] 결과 통합 계획
1049
- ```
75
+ **Critic 검증**: 계획 완성 후 critic 에이전트로 명확성, 완전성, 검증 가능성 평가
1050
76
 
1051
77
  </parallel_agent_execution>
1052
78