@kood/claude-code 0.7.1 → 0.7.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.
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@kood/claude-code",
3
- "version": "0.7.1",
3
+ "version": "0.7.2",
4
4
  "description": "Claude Code documentation installer for projects",
5
5
  "type": "module",
6
6
  "bin": "./dist/index.js",
@@ -4,6 +4,48 @@
4
4
 
5
5
  ---
6
6
 
7
+ <mandatory_rules>
8
+
9
+ ## ⚠️ 필수 사용 규칙
10
+
11
+ > **이 규칙은 선택이 아닌 필수입니다. 위반 시 workflow 실패로 간주합니다.**
12
+
13
+ | 조건 | 행동 | 위반 시 |
14
+ |------|------|--------|
15
+ | **3개+ 병렬 에이전트 필요** | Agent Teams **필수** 사용 | ❌ 스킬 실행 중단 |
16
+ | **팀원 간 소통/조율 필요** | Agent Teams **필수** 사용 | ❌ 스킬 실행 중단 |
17
+ | **Agent Teams 미가용** | Task 병렬 호출 (폴백) | ✅ 허용 |
18
+ | **단순 작업 (1-2 에이전트)** | Task 직접 호출 | ✅ 허용 |
19
+
20
+ ### 필수 패턴
21
+
22
+ ```typescript
23
+ // ✅ 3개+ 에이전트 → Agent Teams 필수
24
+ TeamCreate({ team_name: "skill-team", description: "..." })
25
+ Task({ subagent_type: "...", team_name: "skill-team", name: "worker-1", ... })
26
+ Task({ subagent_type: "...", team_name: "skill-team", name: "worker-2", ... })
27
+ Task({ subagent_type: "...", team_name: "skill-team", name: "worker-3", ... })
28
+
29
+ // ❌ 금지: 3개+ 에이전트를 Agent Teams 없이 호출
30
+ Task({ subagent_type: "...", ... })
31
+ Task({ subagent_type: "...", ... })
32
+ Task({ subagent_type: "...", ... }) // Agent Teams 미사용 → 위반
33
+ ```
34
+
35
+ ### 수명주기 필수 관리
36
+
37
+ | 단계 | 필수 행동 |
38
+ |------|----------|
39
+ | **시작** | `TeamCreate` → 팀원 spawn |
40
+ | **완료** | 팀원별 `shutdown_request` 전송 |
41
+ | **해산** | 모든 팀원 종료 확인 → `TeamDelete` |
42
+
43
+ **팀 정리 없이 스킬 종료 금지.**
44
+
45
+ </mandatory_rules>
46
+
47
+ ---
48
+
7
49
  <availability_check>
8
50
 
9
51
  ## 환경 확인
@@ -358,6 +358,8 @@ Task({ subagent_type: 'analyst', prompt: '비평가 관점: 약점과 리스크'
358
358
  ❌ 다음 단계 없이 종료
359
359
  ❌ 결과 저장 없이 종료
360
360
  ❌ 발행일 미확인 정보 기반 추천
361
+ ❌ 3개+ 에이전트 시 Agent Teams 미사용 (가용 환경)
362
+ ❌ 팀 정리(shutdown → TeamDelete) 없이 종료
361
363
  ```
362
364
 
363
365
  ## 병렬 실행 체크리스트
@@ -749,6 +749,8 @@ Skill({
749
749
  ❌ 장단점 없이 옵션만 나열
750
750
  ❌ 단일 파일로 문서 생성 (여러 파일로 분리 필수)
751
751
  ❌ 문서 생성 후 "구현을 시작할까요?" 물어보기 (즉시 진행)
752
+ ❌ 3개+ 에이전트 시 Agent Teams 미사용 (가용 환경)
753
+ ❌ 팀 정리(shutdown → TeamDelete) 없이 종료
752
754
  ```
753
755
 
754
756
  </validation>
@@ -78,6 +78,38 @@ Phase 0에서 자동 분류 → 채널 조합 결정:
78
78
 
79
79
  ---
80
80
 
81
+ <parallel_agent_execution>
82
+
83
+ ### ⚠️ Agent Teams 필수 원칙
84
+
85
+ > **3개+ 병렬 에이전트 사용 시 Agent Teams 필수** (가용 환경에서)
86
+ > - Agent Teams 가용 → `TeamCreate` → 팀원 spawn → 병렬 협업
87
+ > - Agent Teams 미가용 → Task 병렬 호출 (폴백)
88
+
89
+ **기본 실행 패턴 (standard/deep):**
90
+ ```typescript
91
+ // Phase 0: 팀 생성 (standard: 3-4명, deep: 4-6명)
92
+ TeamCreate({ team_name: "research-team", description: "자료 조사" })
93
+
94
+ // Phase 2: 팀원 스폰 (병렬)
95
+ Task({ subagent_type: "researcher", team_name: "research-team", name: "r1", prompt: "기술 A 조사..." })
96
+ Task({ subagent_type: "researcher", team_name: "research-team", name: "r2", prompt: "기술 B 조사..." })
97
+ Task({ subagent_type: "researcher", team_name: "research-team", name: "r3", prompt: "비교 분석..." })
98
+ Task({ subagent_type: "explore", team_name: "research-team", name: "explorer", model: "haiku", prompt: "gh search..." })
99
+ ```
100
+
101
+ **수명주기 관리 (필수):**
102
+ | 단계 | 행동 |
103
+ |------|------|
104
+ | 완료 | 팀원별 `shutdown_request` 전송 |
105
+ | 해산 | `TeamDelete`로 팀 정리 |
106
+
107
+ **quick 모드 예외:** 2명 이하 → Task 직접 호출 허용
108
+
109
+ </parallel_agent_execution>
110
+
111
+ ---
112
+
81
113
  <sourcing_strategy>
82
114
 
83
115
  @../../instructions/sourcing/reliable-search.md
@@ -253,6 +285,6 @@ gRPC가 처리량/레이턴시 우위(HTTP/2)이나 브라우저 미지원.
253
285
  | **리포트** | Exec Summary 250-400자, 출처, 비교 테이블, 권장사항, 참고자료, 메타데이터 |
254
286
  | **저장** | .claude/research/ 저장, 터미널 출력, 경로 안내 |
255
287
 
256
- **절대 금지:** 출처 없는 주장 / 단일 소스 리포트 / Exec Summary 누락 / 권장사항 누락 / 저장 안 함 / 라이브러리 주제 (→ docs-fetch) / **연도 없는 검색** / **출처 등급 미표기**
288
+ **절대 금지:** 출처 없는 주장 / 단일 소스 리포트 / Exec Summary 누락 / 권장사항 누락 / 저장 안 함 / 라이브러리 주제 (→ docs-fetch) / **연도 없는 검색** / **출처 등급 미표기** / **3개+ 에이전트 시 Agent Teams 미사용** (가용 환경) / **팀 정리 없이 종료**
257
289
 
258
290
  </validation>