@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,7 @@ 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
10
11
  @../../instructions/validation/forbidden-patterns.md
11
12
  @../../instructions/validation/required-behaviors.md
12
13
 
@@ -138,20 +139,9 @@ $ARGUMENTS 있음 → 다음 단계 진행
138
139
 
139
140
  <sourcing_strategy>
140
141
 
141
- ## 검색 채널: Smart Tier Fallback
142
+ ## 검색 채널
142
143
 
143
- ```
144
- Tier 1 (MCP 도구 있으면 우선):
145
- SearXNG MCP → 246+ 엔진 메타검색
146
- Firecrawl MCP → 웹페이지 → 깨끗한 MD
147
- GitHub MCP → 코드/리포/이슈 검색
148
-
149
- Tier 2 (내장 도구 - 항상 사용 가능):
150
- WebSearch → 기본 웹 검색
151
- WebFetch → 개별 페이지 읽기
152
-
153
- MCP 없으면 → Tier 2만으로 전체 워크플로우 동작
154
- ```
144
+ @reliable-search.md 참조 (Tier 1 MCP 우선, Tier 2 내장 도구 폴백)
155
145
 
156
146
  ### Phase 0: MCP 감지
157
147
 
@@ -174,46 +164,11 @@ MCP 미가용 시 → researcher가 WebSearch + WebFetch로 수행
174
164
 
175
165
  ### Phase 1: 도메인 조사 (3방향 동시)
176
166
 
177
- ```typescript
178
- // 1-A: 업계 통념 수집
179
- Task({
180
- subagent_type: 'researcher',
181
- model: 'sonnet',
182
- prompt: `
183
- [문제 도메인]에서 업계가 당연시하는 통념/관행 조사:
184
- - "원래 이렇게 한다"고 믿는 것들
185
- - 기존 접근법, 표준 프로세스
186
- - 비용 구조, 가격 체계
187
- 출처 URL 필수.
188
- `
189
- })
190
-
191
- // 1-B: 실제 팩트/데이터 수집
192
- Task({
193
- subagent_type: 'researcher',
194
- model: 'sonnet',
195
- prompt: `
196
- [문제 도메인]의 검증 가능한 팩트 조사:
197
- - 실제 비용/원가 데이터 (원자재, 인건비, 구조)
198
- - 벤치마크, 통계, 시장 데이터
199
- - 물리적/기술적 제약 (진짜 한계)
200
- 출처 URL 필수.
201
- `
202
- })
203
-
204
- // 1-C: 혁신 사례 수집
205
- Task({
206
- subagent_type: 'researcher',
207
- model: 'sonnet',
208
- prompt: `
209
- [문제 도메인]에서 기존 가정을 깨뜨린 혁신 사례:
210
- - 가격/비용을 파괴적으로 낮춘 사례
211
- - 업계 통념을 뒤엎은 기업/프로젝트
212
- - First Principles 접근을 적용한 사례
213
- 출처 URL 필수.
214
- `
215
- })
216
- ```
167
+ | 에이전트 | 타입 | 목표 | 출처 요구사항 |
168
+ |----------|------|------|-------------|
169
+ | 1-A | researcher | 업계 통념/관행: "원래 이렇게", 기존 접근법, 비용 구조 | URL + 발행일 + 소스유형 필수, 현재 연도 포함 |
170
+ | 1-B | researcher | 실제 팩트/데이터: 원가, 벤치마크, 물리적 제약 | URL + 발행일 필수, 최신 데이터 우선 (12개월 이내) |
171
+ | 1-C | researcher | 혁신 사례: 가정을 깨뜨린 기업/프로젝트 | URL + 발행일 필수 |
217
172
 
218
173
  **효과:** 통념 + 팩트 + 사례 3방향 → Phase 2에서 가정 vs 진실 대조 가능
219
174
 
@@ -221,52 +176,13 @@ Task({
221
176
 
222
177
  ### Phase 3: 대안 경로 탐색 (3방향 동시)
223
178
 
224
- ```typescript
225
- // Phase 2에서 도출된 기본 진리를 바탕으로
226
- // 3개 대안 경로를 병렬 분석
227
-
228
- // 3-A: 경로 A 분석
229
- Task({
230
- subagent_type: 'analyst',
231
- model: 'sonnet',
232
- prompt: `
233
- [기본 진리 목록] 바탕으로 경로 A 분석:
234
- 접근법: [경로 A 설명]
235
- - 실현 가능성 (1-5)
236
- - 영향도 (1-5)
237
- - 필요 자원
238
- - 최대 리스크
239
- `
240
- })
241
-
242
- // 3-B: 경로 B 분석
243
- Task({
244
- subagent_type: 'analyst',
245
- model: 'sonnet',
246
- prompt: `
247
- [기본 진리 목록] 바탕으로 경로 B 분석:
248
- 접근법: [경로 B 설명]
249
- - 실현 가능성 (1-5)
250
- - 영향도 (1-5)
251
- - 필요 자원
252
- - 최대 리스크
253
- `
254
- })
255
-
256
- // 3-C: 경로 C 분석
257
- Task({
258
- subagent_type: 'analyst',
259
- model: 'sonnet',
260
- prompt: `
261
- [기본 진리 목록] 바탕으로 경로 C 분석:
262
- 접근법: [경로 C 설명]
263
- - 실현 가능성 (1-5)
264
- - 영향도 (1-5)
265
- - 필요 자원
266
- - 최대 리스크
267
- `
268
- })
269
- ```
179
+ Phase 2에서 도출된 기본 진리를 바탕으로 3개 대안 경로를 병렬 분석
180
+
181
+ | 에이전트 | 타입 | 평가 기준 |
182
+ |----------|------|----------|
183
+ | 3-A | analyst | 경로 A: 실현 가능성(1-5), 영향도(1-5), 필요 자원, 리스크 |
184
+ | 3-B | analyst | 경로 B: 실현 가능성(1-5), 영향도(1-5), 필요 자원, 리스크 |
185
+ | 3-C | analyst | 경로 C: 실현 가능성(1-5), 영향도(1-5), 필요 자원, 리스크 |
270
186
 
271
187
  ---
272
188
 
@@ -344,22 +260,10 @@ Phase 2에서 확정된:
344
260
 
345
261
  ## Phase 4: 실행 + 리스크
346
262
 
347
- ### Inversion (Charlie Munger 역전 사고)
348
-
349
- ```
350
- 1. " 해결책을 실행할 때, 어떻게 하면 확실히 실패할 있을까?"
351
- 2. 실패 시나리오 5-7개 도출
352
- 3. 각 시나리오 → 예방 전략 매핑
353
- ```
354
-
355
- ### Pre-mortem
356
-
357
- ```
358
- 1. "6개월 후, 이 프로젝트가 완전히 실패했다. 왜 실패했는가?"
359
- 2. 가장 가능성 높은 실패 원인 3개 도출
360
- 3. 각 원인 → 사전 대응 전략
361
- 4. "내가 똑같은 실수를 할 수 있는 순간"까지 구체적으로 정리
362
- ```
263
+ | 사고법 | 핵심 질문 | 프로세스 |
264
+ |--------|----------|----------|
265
+ | **Inversion** | "어떻게 확실히 실패할까?" | 실패 시나리오 5-7개 → 예방 전략 매핑 |
266
+ | **Pre-mortem** | "6개월 실패했다면 왜?" | 실패 원인 3개 사전 대응 + "내가 실수할 순간" 구체화 |
363
267
 
364
268
  </phase_details>
365
269
 
@@ -369,27 +273,11 @@ Phase 2에서 확정된:
369
273
 
370
274
  ## 결과 저장
371
275
 
372
- ### 폴더 구조
373
-
374
- ```
375
- .claude/first-principles/
376
- ├── 00.SaaS_가격_혁신.md
377
- ├── 01.서버_비용_절감.md
378
- └── ...
379
- ```
380
-
381
- ### 파일명 형식
382
-
383
- `[넘버링].[문제_요약].md`
384
-
385
- ### 저장 워크플로우
386
-
387
- ```
388
- 1. 넘버링 결정: ls .claude/first-principles/ | wc -l
389
- 2. 폴더 생성: mkdir -p .claude/first-principles
390
- 3. 결과 저장: Write(...)
391
- 4. 사용자에게 경로 안내
392
- ```
276
+ | 항목 | 규칙 |
277
+ |------|------|
278
+ | **경로** | `.claude/first-principles/[넘버링].[문제_요약].md` |
279
+ | **넘버링** | `ls .claude/first-principles/ \| wc -l` 결과 |
280
+ | **워크플로우** | 폴더 생성 → Write → 사용자 경로 안내 |
393
281
 
394
282
  </document_storage>
395
283
 
@@ -399,99 +287,14 @@ Phase 2에서 확정된:
399
287
 
400
288
  ## 결과물 구조
401
289
 
402
- ```markdown
403
- # 제1원칙 분석: [문제]
404
-
405
- **생성일:** YYYY-MM-DD
406
- **문제:** [원본 문제 설명]
407
-
408
- ---
409
-
410
- ## 1. 도메인 현황
411
-
412
- ### 업계 통념
413
- - [통념 1]: [설명] — 출처: [URL]
414
- - [통념 2]: [설명] — 출처: [URL]
415
-
416
- ### 실제 팩트
417
- - [팩트 1]: [데이터] — 출처: [URL]
418
- - [팩트 2]: [데이터] — 출처: [URL]
419
-
420
- ### 혁신 사례
421
- - [사례 1]: [기업/프로젝트] — 어떤 가정을 깨뜨렸는가
422
- - [사례 2]: [기업/프로젝트] — 어떤 가정을 깨뜨렸는가
423
-
424
- ---
425
-
426
- ## 2. 가정 해체 매트릭스
427
-
428
- | # | 가정 | 소크라테스 질문 결과 | 분류 | 근거 |
429
- |---|------|---------------------|------|------|
430
- | 1 | "OO은 비싸다" | 원자재 비용 X$ (팩트) | B (관행) | LME 가격 확인 |
431
- | 2 | "OO은 불가능" | 물리 법칙 Y에 의해 | A (제약) | 열역학 법칙 |
432
- | 3 | "OO이 필요하다" | 미검증 → 추가 조사 | C→B | 대안 Z 존재 확인 |
433
-
434
- **A (기본 진리):** [목록]
435
- **B (제거된 관행):** [목록]
436
-
437
- ---
438
-
439
- ## 3. 본질 재설계
440
-
441
- ### 기존 vs 제1원칙 비교
442
-
443
- | 구분 | 기존 방식 (유추) | 제1원칙 방식 |
444
- |------|-----------------|-------------|
445
- | **접근법** | [남들 따라하기] | [기본 진리에서 출발] |
446
- | **비용 구조** | [기존 비용] | [제1원칙 비용] |
447
- | **핵심 차이** | [관행 기반] | [물리적 제약만 존중] |
448
-
449
- ### 대안 경로 평가
450
-
451
- | 경로 | 설명 | 실현성 | 영향도 | 추천 |
452
- |------|------|--------|--------|------|
453
- | A | [설명] | 4/5 | 5/5 | 최우선 |
454
- | B | [설명] | 3/5 | 4/5 | 대안 |
455
- | C | [설명] | 5/5 | 3/5 | 보조 |
456
-
457
- ### 최종 해결책
458
- [선택된 경로 상세 설명]
459
-
460
- ---
461
-
462
- ## 4. 실행 계획 + 리스크 매트릭스
463
-
464
- ### 단계별 액션 플랜
465
-
466
- | 단계 | 액션 | 기간 | 체크포인트 |
467
- |------|------|------|-----------|
468
- | 1 | [구체 액션] | [기간] | [확인 사항] |
469
- | 2 | [구체 액션] | [기간] | [확인 사항] |
470
-
471
- ### Inversion: 실패 시나리오
472
-
473
- | # | "어떻게 실패할까?" | 발생 확률 | 영향도 | 예방 전략 |
474
- |---|-------------------|----------|--------|----------|
475
- | 1 | [실패 시나리오] | 높음 | 치명적 | [예방책] |
476
- | 2 | [실패 시나리오] | 중간 | 높음 | [예방책] |
477
-
478
- ### Pre-mortem: "6개월 후 실패했다면?"
479
-
480
- 1. **실패 원인 1:** [설명] → 대응: [전략]
481
- 2. **실패 원인 2:** [설명] → 대응: [전략]
482
- 3. **실패 원인 3:** [설명] → 대응: [전략]
483
-
484
- ### 내가 실수할 수 있는 순간
485
-
486
- - [순간 1]: [상황] → 경고 신호: [신호]
487
- - [순간 2]: [상황] → 경고 신호: [신호]
488
-
489
- ---
490
-
491
- ## 출처
492
- - [제목](URL)
493
- - [제목](URL)
494
- ```
290
+ | 섹션 | 내용 |
291
+ |------|------|
292
+ | **헤더** | 생성일, 문제 설명 |
293
+ | **1. 도메인 현황** | 업계 통념, 실제 팩트, 혁신 사례 (출처 URL 필수) |
294
+ | **2. 가정 해체 매트릭스** | 가정 목록 + 소크라테스 질문 + A/B/C 분류 + 근거 |
295
+ | **3. 본질 재설계** | 기존 vs 제1원칙 비교, 대안 경로 평가, 최종 해결책 |
296
+ | **4. 실행 + 리스크** | 단계별 액션, Inversion 실패 시나리오, Pre-mortem, 실수 가능 순간 |
297
+ | **출처** | 모든 참조 URL 목록 |
495
298
 
496
299
  </result_structure>
497
300
 
@@ -499,7 +302,7 @@ Phase 2에서 확정된:
499
302
 
500
303
  <examples>
501
304
 
502
- ## 예시 1: 비용 혁신
305
+ ## 핵심 예시: 비용 혁신
503
306
 
504
307
  ```bash
505
308
  사용자: /elon-musk SaaS 인프라 비용이 매출의 40%
@@ -507,7 +310,7 @@ Phase 2에서 확정된:
507
310
  Phase 0: MCP 감지 (ToolSearch)
508
311
  Phase 1: 병렬 researcher x3:
509
312
  1-A: "SaaS 인프라 업계 통념 — 클라우드 비용 구조, 표준 접근법"
510
- 1-B: "실제 컴퓨팅 원가 — 전력, 하드웨어, 네트워크 단가 팩트"
313
+ 1-B: "실제 컴퓨팅 원가 — 전력, 하드웨어, 네트워크 단가 팩트 (12개월 이내)"
511
314
  1-C: "인프라 비용을 파괴적으로 절감한 사례 — Cloudflare Workers, Fly.io"
512
315
 
513
316
  Phase 2: Sequential Thinking (가정 해체):
@@ -527,59 +330,10 @@ Phase 4: Inversion + Pre-mortem
527
330
  저장: .claude/first-principles/00.SaaS_인프라_비용_혁신.md
528
331
  ```
529
332
 
530
- ---
333
+ ## 기타 사례
531
334
 
532
- ## 예시 2: 전략적 의사결정
533
-
534
- ```bash
535
- 사용자: /elon-musk 고객 이탈률이 높은데 기존 리텐션 전략이 안 먹힘
536
-
537
- Phase 1: 병렬 researcher x3:
538
- 1-A: "SaaS 리텐션 업계 통념 — 이메일 캠페인, 할인, 온보딩 개선"
539
- 1-B: "고객 이탈 실제 원인 데이터 — 학술 연구, 실증 데이터"
540
- 1-C: "이탈률을 극적으로 낮춘 혁신 사례 — Slack, Notion, Figma"
541
-
542
- Phase 2: Sequential Thinking:
543
- 가정 1: "이탈 원인은 가격" → C→B — 실제: 대부분 가치 인식 부족
544
- 가정 2: "온보딩 개선이 답" → B (관행) — 이미 기능은 충분, 습관 형성 미흡
545
- 가정 3: "이메일 리마인더가 효과" → B — 열람률 2%, 실질 효과 미미
546
- 가정 4: "사용자는 기능이 많으면 좋아한다" → C→B — 복잡도가 오히려 이탈 유발
547
-
548
- Phase 3: 병렬 analyst:
549
- 경로 A: "핵심 1가지 습관 형성에 집중 (Slack의 메시지 7개 법칙)"
550
- 경로 B: "커뮤니티 기반 네트워크 효과 (이탈 비용 자연 증가)"
551
- 경로 C: "AI 기반 개인화 여정 (사용 패턴별 맞춤 경험)"
552
-
553
- Phase 4: Inversion
554
- 실패: "습관 형성 강요가 사용자 반감 유발" → 점진적 넛지
555
- 실패: "커뮤니티가 안 만들어짐" → 시드 유저 확보 전략 선행
556
-
557
- 저장: .claude/first-principles/01.고객_이탈_리텐션_혁신.md
558
- ```
559
-
560
- ---
561
-
562
- ## 예시 3: 기술 문제
563
-
564
- ```bash
565
- 사용자: /elon-musk 모바일 앱 로딩이 느린데 최적화 한계에 도달
566
-
567
- Phase 1: 병렬 researcher x3:
568
- 1-A: "모바일 앱 성능 업계 통념 — 이미지 최적화, 코드 스플리팅, CDN"
569
- 1-B: "모바일 네트워크 물리적 제약 — 3G/4G/5G 레이턴시, 대역폭 데이터"
570
- 1-C: "극적 성능 개선 사례 — Instagram Lite, Facebook Lite, Shopify"
571
-
572
- Phase 2: Sequential Thinking:
573
- 가정 1: "서버 응답 속도가 병목" → C→검증 — 실제: 클라이언트 렌더링 시간
574
- 가정 2: "번들 크기를 줄이면 해결" → B — 이미 최적화됨, 진짜 병목은 파싱
575
- 가정 3: "네트워크는 개선 불가" → A (제약) — 물리: 무선 레이턴시 30-100ms
576
-
577
- Phase 3: 재설계
578
- "네트워크 요청 자체를 제거" → 오프라인 퍼스트 아키텍처
579
- "파싱 시간 제거" → 서버 사이드 렌더링 or 정적 생성
580
-
581
- 저장: .claude/first-principles/02.모바일_앱_성능_혁신.md
582
- ```
335
+ - **전략적 의사결정**: 고객 이탈 → 가격 vs 습관 형성 vs 커뮤니티 네트워크 효과 분석
336
+ - **기술 문제**: 모바일 성능 → 번들 최적화 vs 오프라인 퍼스트 vs SSR
583
337
 
584
338
  </examples>
585
339
 
@@ -589,32 +343,25 @@ Phase 3: 재설계
589
343
 
590
344
  ## 검증 체크리스트
591
345
 
592
- 실행 확인:
593
-
594
- ```text
595
- ARGUMENT 확인 (없으면 질문)
596
- Phase 0: MCP 가용성 감지
597
- Phase 1: 병렬 researcher 3방향 수집 (통념 + 팩트 + 사례)
598
- Phase 2: Sequential Thinking 최소 3단계 (소크라테스 질문)
599
- Phase 2: 가정을 A/B/C로 분류 (최소 5개)
600
- Phase 3: 병렬 analyst로 대안 경로 3개+ 탐색
601
- Phase 3: "기존 vs 제1원칙" 비교 테이블
602
- ✅ Phase 4: Inversion 실패 시나리오 3개+
603
- Phase 4: Pre-mortem + "실수할 수 있는 순간"
604
- ✅ .claude/first-principles/ 폴더에 결과 저장
605
- 모든 팩트에 출처 URL 첨부
606
- ```
607
-
608
- 절대 금지:
609
-
610
- ```text
611
- ARGUMENT 없이 분석 시작
612
- ❌ 도메인 조사 없이 가정 해체
613
- ❌ A/B/C 분류 없이 재설계
614
- ❌ Inversion 없이 실행 계획 제시
615
- ❌ 출처 없는 팩트 주장
616
- ❌ 유추적 사고로 답변 (남들 사례 복사)
617
- ❌ 결과 저장 없이 종료
618
- ```
346
+ | 항목 | 필수 |
347
+ |------|------|
348
+ | **ARGUMENT** | 없으면 즉시 질문 |
349
+ | **Phase 0** | MCP 가용성 감지 |
350
+ | **Phase 1** | researcher x3 (통념 + 팩트 + 사례), 출처 등급(S/A/B/C) 표기 |
351
+ | **Phase 2** | Sequential Thinking 3단계+, A/B/C 분류 5개+, 핵심 팩트 교차검증 2개+ |
352
+ | **Phase 3** | analyst x3, "기존 vs 제1원칙" 비교 테이블 |
353
+ | **Phase 4** | Inversion 3개+, Pre-mortem, "실수 가능 순간" |
354
+ | **저장** | .claude/first-principles/ |
355
+ | **출처** | 모든 팩트 URL + 발행일 + 소스유형 |
356
+
357
+ | 금지 | |
358
+ |------|------|
359
+ | | ARGUMENT 없이 분석 시작 |
360
+ | ❌ | 도메인 조사 없이 가정 해체 |
361
+ | ❌ | A/B/C 분류 없이 재설계 |
362
+ | ❌ | Inversion 없이 실행 계획 |
363
+ | ❌ | 출처 없는 팩트 주장 |
364
+ | ❌ | 유추적 사고 (남들 사례 복사) |
365
+ | | 결과 저장 없이 종료 |
619
366
 
620
367
  </validation>