@kood/claude-code 0.7.0 → 0.7.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kood/claude-code",
-  "version": "0.7.0",
+  "version": "0.7.1",
   "description": "Claude Code documentation installer for projects",
   "type": "module",
   "bin": "./dist/index.js",

package/templates/.claude/commands/lint-fix.md

@@ -134,6 +134,26 @@ argument-hint: [파일/디렉토리 경로...]
 
 <parallel_execution_critical>
 
+### ⚠️ Agent Teams 우선 원칙
+
+> **복잡한 병렬 작업 시 Agent Teams를 기본으로 사용**
+> - Agent Teams 가용 → TeamCreate → 팀원 spawn → 병렬 협업
+> - Agent Teams 미가용 → Task 병렬 호출 (폴백)
+
+**Agent Teams 모드 (기본)**:
+```typescript
+TeamCreate({ team_name: "lint-fix-team", description: "린트 오류 병렬 수정" })
+Task(subagent_type="lint-fixer", team_name="lint-fix-team", name="fixer-1", ...)
+Task(subagent_type="lint-fixer", team_name="lint-fix-team", name="fixer-2", ...)
+```
+
+**수명주기 관리:**
+- 팀원 태스크 완료 → 즉시 `shutdown_request` 전송
+- 종료 후 `TaskList`로 다음 태스크 확인
+- 모든 작업 완료 → `TeamDelete`로 팀 해산
+
+---
+
 ## ⚠️ CRITICAL: 병렬 검사 필수
 
 **tsc와 eslint는 반드시 단일 메시지에서 병렬로 실행해야 합니다.**

package/templates/.claude/commands/pre-deploy.md

@@ -99,6 +99,26 @@ argument-hint: [파일/디렉토리 경로...]
 
 <parallel_execution_critical>
 
+### ⚠️ Agent Teams 우선 원칙
+
+> **복잡한 병렬 작업 시 Agent Teams를 기본으로 사용**
+> - Agent Teams 가용 → TeamCreate → 팀원 spawn → 병렬 협업
+> - Agent Teams 미가용 → Task 병렬 호출 (폴백)
+
+**Agent Teams 모드 (기본)**:
+```typescript
+TeamCreate({ team_name: "pre-deploy-team", description: "배포 전 검증" })
+Task(subagent_type="deployment-validator", team_name="pre-deploy-team", name="validator", ...)
+Task(subagent_type="security-reviewer", team_name="pre-deploy-team", name="security", ...)
+```
+
+**수명주기 관리:**
+- 팀원 태스크 완료 → 즉시 `shutdown_request` 전송
+- 종료 후 `TaskList`로 다음 태스크 확인
+- 모든 작업 완료 → `TeamDelete`로 팀 해산
+
+---
+
 ## ⚠️ CRITICAL: 병렬 검사 필수
 
 **typecheck와 lint는 반드시 단일 메시지에서 병렬로 실행해야 합니다.**

package/templates/.claude/commands/version-update.md

@@ -66,6 +66,26 @@ argument-hint: <new-version | +1 | +minor | +major>
 
 <parallel_execution_critical>
 
+### ⚠️ Agent Teams 우선 원칙
+
+> **복잡한 병렬 작업 시 Agent Teams를 기본으로 사용**
+> - Agent Teams 가용 → TeamCreate → 팀원 spawn → 병렬 협업
+> - Agent Teams 미가용 → Task 병렬 호출 (폴백)
+
+**Agent Teams 모드 (기본)**:
+```typescript
+TeamCreate({ team_name: "version-update-team", description: "버전 업데이트 작업" })
+Task(subagent_type="document-writer", team_name="version-update-team", name="changelog", ...)
+Task(subagent_type="document-writer", team_name="version-update-team", name="readme", ...)
+```
+
+**수명주기 관리:**
+- 팀원 태스크 완료 → 즉시 `shutdown_request` 전송
+- 종료 후 `TaskList`로 다음 태스크 확인
+- 모든 작업 완료 → `TeamDelete`로 팀 해산
+
+---
+
 ## ⚠️ CRITICAL: 병렬 작업 패턴
 
 ### 병렬 실행 가능 작업

package/templates/.claude/skills/brainstorm/SKILL.md

@@ -181,6 +181,25 @@ Sequential Thinking (2단계):
 
 <parallel_agent_execution>
 
+### ⚠️ Agent Teams 우선 원칙
+
+> **복잡한 병렬 작업 시 Agent Teams를 기본으로 사용**
+> - Agent Teams 가용 → TeamCreate → 팀원 spawn → 병렬 협업
+> - Agent Teams 미가용 → Task 병렬 호출 (폴백)
+
+**Agent Teams 모드 (기본)**:
+```typescript
+TeamCreate({ team_name: "brainstorm-team", description: "브레인스토밍" })
+Task(subagent_type="researcher", team_name="brainstorm-team", name="researcher", ...)
+```
+
+**수명주기 관리:**
+- 팀원 태스크 완료 → 즉시 `shutdown_request` 전송
+- 종료 후 `TaskList`로 다음 태스크 확인
+- 모든 작업 완료 → `TeamDelete`로 팀 해산
+
+---
+
 ## 병렬 에이전트 실행
 
 @../../instructions/agent-patterns/delegation-patterns.md

package/templates/.claude/skills/bug-fix/SKILL.md

@@ -335,6 +335,25 @@ npm run build
 
 <parallel_agent_execution>
 
+### ⚠️ Agent Teams 우선 원칙
+
+> **복잡한 병렬 작업 시 Agent Teams를 기본으로 사용**
+> - Agent Teams 가용 → TeamCreate → 팀원 spawn → 병렬 협업
+> - Agent Teams 미가용 → Task 병렬 호출 (폴백)
+
+**Agent Teams 모드 (기본)**:
+```typescript
+TeamCreate({ team_name: "bugfix-team", description: "버그 수정" })
+Task(subagent_type="explore", team_name="bugfix-team", name="analyzer", ...)
+```
+
+**수명주기 관리:**
+- 팀원 태스크 완료 → 즉시 `shutdown_request` 전송
+- 종료 후 `TaskList`로 다음 태스크 확인
+- 모든 작업 완료 → `TeamDelete`로 팀 해산
+
+---
+
 ## Parallel Agent Execution
 
 @../../instructions/agent-patterns/delegation-patterns.md

package/templates/.claude/skills/docs-creator/SKILL.md

@@ -35,6 +35,25 @@ metadata:
 
 <parallel_agent_execution>
 
+### ⚠️ Agent Teams 우선 원칙
+
+> **복잡한 병렬 작업 시 Agent Teams를 기본으로 사용**
+> - Agent Teams 가용 → TeamCreate → 팀원 spawn → 병렬 협업
+> - Agent Teams 미가용 → Task 병렬 호출 (폴백)
+
+**Agent Teams 모드 (기본)**:
+```typescript
+TeamCreate({ team_name: "docs-team", description: "문서 작성" })
+Task(subagent_type="document-writer", team_name="docs-team", name="writer", ...)
+```
+
+**수명주기 관리:**
+- 팀원 태스크 완료 → 즉시 `shutdown_request` 전송
+- 종료 후 `TaskList`로 다음 태스크 확인
+- 모든 작업 완료 → `TeamDelete`로 팀 해산
+
+---
+
 ## 핵심 원칙
 
 | 원칙 | 방법 | 효과 |

package/templates/.claude/skills/docs-fetch/SKILL.md

@@ -337,6 +337,25 @@ docs/library/{name}/
 
 <parallel_agent_execution>
 
+### ⚠️ Agent Teams 우선 원칙
+
+> **복잡한 병렬 작업 시 Agent Teams를 기본으로 사용**
+> - Agent Teams 가용 → TeamCreate → 팀원 spawn → 병렬 협업
+> - Agent Teams 미가용 → Task 병렬 호출 (폴백)
+
+**Agent Teams 모드 (기본)**:
+```typescript
+TeamCreate({ team_name: "docs-fetch-team", description: "문서 수집" })
+Task(subagent_type="researcher", team_name="docs-fetch-team", name="researcher", ...)
+```
+
+**수명주기 관리:**
+- 팀원 태스크 완료 → 즉시 `shutdown_request` 전송
+- 종료 후 `TaskList`로 다음 태스크 확인
+- 모든 작업 완료 → `TeamDelete`로 팀 해산
+
+---
+
 ## Agent 활용 패턴
 
 | Phase | Agent | Model | 용도 |

package/templates/.claude/skills/docs-refactor/SKILL.md

@@ -39,6 +39,25 @@ metadata:
 
 <parallel_agent_execution>
 
+### ⚠️ Agent Teams 우선 원칙
+
+> **복잡한 병렬 작업 시 Agent Teams를 기본으로 사용**
+> - Agent Teams 가용 → TeamCreate → 팀원 spawn → 병렬 협업
+> - Agent Teams 미가용 → Task 병렬 호출 (폴백)
+
+**Agent Teams 모드 (기본)**:
+```typescript
+TeamCreate({ team_name: "docs-refactor-team", description: "문서 리팩토링" })
+Task(subagent_type="document-writer", team_name="docs-refactor-team", name="writer", ...)
+```
+
+**수명주기 관리:**
+- 팀원 태스크 완료 → 즉시 `shutdown_request` 전송
+- 종료 후 `TaskList`로 다음 태스크 확인
+- 모든 작업 완료 → `TeamDelete`로 팀 해산
+
+---
+
 @../docs-creator/SKILL.md#parallel_agent_execution
 
 **리팩토링 특화:**

package/templates/.claude/skills/elon-musk/SKILL.md

@@ -161,6 +161,25 @@ MCP 미가용 시 → researcher가 WebSearch + WebFetch로 수행
 
 <parallel_agent_execution>
 
+### ⚠️ Agent Teams 우선 원칙
+
+> **복잡한 병렬 작업 시 Agent Teams를 기본으로 사용**
+> - Agent Teams 가용 → TeamCreate → 팀원 spawn → 병렬 협업
+> - Agent Teams 미가용 → Task 병렬 호출 (폴백)
+
+**Agent Teams 모드 (기본)**:
+```typescript
+TeamCreate({ team_name: "first-principles-team", description: "제1원칙 분석" })
+Task(subagent_type="researcher", team_name="first-principles-team", name="researcher", ...)
+```
+
+**수명주기 관리:**
+- 팀원 태스크 완료 → 즉시 `shutdown_request` 전송
+- 종료 후 `TaskList`로 다음 태스크 확인
+- 모든 작업 완료 → `TeamDelete`로 팀 해산
+
+---
+
 ## 병렬 Agent 실행
 
 ### Phase 1: 도메인 조사 (3방향 동시)

package/templates/.claude/skills/execute/SKILL.md

@@ -44,6 +44,25 @@ user-invocable: true
 
 <parallel_agent_execution>
 
+### ⚠️ Agent Teams 우선 원칙
+
+> **복잡한 병렬 작업 시 Agent Teams를 기본으로 사용**
+> - Agent Teams 가용 → TeamCreate → 팀원 spawn → 병렬 협업
+> - Agent Teams 미가용 → Task 병렬 호출 (폴백)
+
+**Agent Teams 모드 (기본)**:
+```typescript
+TeamCreate({ team_name: "execute-team", description: "즉시 구현" })
+Task(subagent_type="implementation-executor", team_name="execute-team", name="executor", ...)
+```
+
+**수명주기 관리:**
+- 팀원 태스크 완료 → 즉시 `shutdown_request` 전송
+- 종료 후 `TaskList`로 다음 태스크 확인
+- 모든 작업 완료 → `TeamDelete`로 팀 해산
+
+---
+
 ## 병렬 에이전트 실행
 
 @../../instructions/agent-patterns/delegation-patterns.md

package/templates/.claude/skills/feedback/SKILL.md

@@ -289,6 +289,25 @@ Task({
 
 <parallel_agent_execution>
 
+### ⚠️ Agent Teams 우선 원칙
+
+> **복잡한 병렬 작업 시 Agent Teams를 기본으로 사용**
+> - Agent Teams 가용 → TeamCreate → 팀원 spawn → 병렬 협업
+> - Agent Teams 미가용 → Task 병렬 호출 (폴백)
+
+**Agent Teams 모드 (기본)**:
+```typescript
+TeamCreate({ team_name: "feedback-team", description: "피드백 처리" })
+Task(subagent_type="implementation-executor", team_name="feedback-team", name="executor", ...)
+```
+
+**수명주기 관리:**
+- 팀원 태스크 완료 → 즉시 `shutdown_request` 전송
+- 종료 후 `TaskList`로 다음 태스크 확인
+- 모든 작업 완료 → `TeamDelete`로 팀 해산
+
+---
+
 ## Parallel Agent Execution
 
 ### Model Routing

package/templates/.claude/skills/figma-to-code/SKILL.md

@@ -39,6 +39,25 @@ ui-only: true
 
 <parallel_agent_execution>
 
+### ⚠️ Agent Teams 우선 원칙
+
+> **복잡한 병렬 작업 시 Agent Teams를 기본으로 사용**
+> - Agent Teams 가용 → TeamCreate → 팀원 spawn → 병렬 협업
+> - Agent Teams 미가용 → Task 병렬 호출 (폴백)
+
+**Agent Teams 모드 (기본)**:
+```typescript
+TeamCreate({ team_name: "figma-team", description: "Figma to Code 변환" })
+Task(subagent_type="designer", team_name="figma-team", name="designer", ...)
+```
+
+**수명주기 관리:**
+- 팀원 태스크 완료 → 즉시 `shutdown_request` 전송
+- 종료 후 `TaskList`로 다음 태스크 확인
+- 모든 작업 완료 → `TeamDelete`로 팀 해산
+
+---
+
 ## ULTRAWORK MODE (병렬 에이전트 실행)
 
 ### 기본 원칙

package/templates/.claude/skills/global-uiux-design/SKILL.md

@@ -30,6 +30,25 @@ ui-only: true
 
 <parallel_agent_execution>
 
+### ⚠️ Agent Teams 우선 원칙
+
+> **복잡한 병렬 작업 시 Agent Teams를 기본으로 사용**
+> - Agent Teams 가용 → TeamCreate → 팀원 spawn → 병렬 협업
+> - Agent Teams 미가용 → Task 병렬 호출 (폴백)
+
+**Agent Teams 모드 (기본)**:
+```typescript
+TeamCreate({ team_name: "global-uiux-team", description: "Global UI/UX 디자인" })
+Task(subagent_type="designer", team_name="global-uiux-team", name="designer", ...)
+```
+
+**수명주기 관리:**
+- 팀원 태스크 완료 → 즉시 `shutdown_request` 전송
+- 종료 후 `TaskList`로 다음 태스크 확인
+- 모든 작업 완료 → `TeamDelete`로 팀 해산
+
+---
+
 ## 병렬 에이전트 실행 (Global UX 특화)
 
 ### 핵심 원칙

package/templates/.claude/skills/korea-uiux-design/SKILL.md

@@ -30,6 +30,25 @@ ui-only: true
 
 <parallel_agent_execution>
 
+### ⚠️ Agent Teams 우선 원칙
+
+> **복잡한 병렬 작업 시 Agent Teams를 기본으로 사용**
+> - Agent Teams 가용 → TeamCreate → 팀원 spawn → 병렬 협업
+> - Agent Teams 미가용 → Task 병렬 호출 (폴백)
+
+**Agent Teams 모드 (기본)**:
+```typescript
+TeamCreate({ team_name: "korea-uiux-team", description: "한국형 UI/UX 디자인" })
+Task(subagent_type="designer", team_name="korea-uiux-team", name="designer", ...)
+```
+
+**수명주기 관리:**
+- 팀원 태스크 완료 → 즉시 `shutdown_request` 전송
+- 종료 후 `TaskList`로 다음 태스크 확인
+- 모든 작업 완료 → `TeamDelete`로 팀 해산
+
+---
+
 ## 한국형 UI/UX 병렬 에이전트 실행
 
 ### 핵심 원칙

package/templates/.claude/skills/nextjs-react-best-practices/SKILL.md

@@ -39,6 +39,25 @@ Vercel에서 관리하는 React와 Next.js 애플리케이션 종합 성능 최
 
 <parallel_agent_execution>
 
+### ⚠️ Agent Teams 우선 원칙
+
+> **복잡한 병렬 작업 시 Agent Teams를 기본으로 사용**
+> - Agent Teams 가용 → TeamCreate → 팀원 spawn → 병렬 협업
+> - Agent Teams 미가용 → Task 병렬 호출 (폴백)
+
+**Agent Teams 모드 (기본)**:
+```typescript
+TeamCreate({ team_name: "nextjs-team", description: "Next.js 최적화" })
+Task(subagent_type="general-purpose", team_name="nextjs-team", name="optimizer", ...)
+```
+
+**수명주기 관리:**
+- 팀원 태스크 완료 → 즉시 `shutdown_request` 전송
+- 종료 후 `TaskList`로 다음 태스크 확인
+- 모든 작업 완료 → `TeamDelete`로 팀 해산
+
+---
+
 ## 병렬 에이전트 실행 (ULTRAWORK MODE)
 
 ### 기본 원칙

package/templates/.claude/skills/plan/SKILL.md

@@ -61,6 +61,25 @@ Task({
 
 <parallel_agent_execution>
 
+### ⚠️ Agent Teams 우선 원칙
+
+> **복잡한 병렬 작업 시 Agent Teams를 기본으로 사용**
+> - Agent Teams 가용 → TeamCreate → 팀원 spawn → 병렬 협업
+> - Agent Teams 미가용 → Task 병렬 호출 (폴백)
+
+**Agent Teams 모드 (기본)**:
+```typescript
+TeamCreate({ team_name: "plan-team", description: "계획 수립" })
+Task(subagent_type="planner", team_name="plan-team", name="planner", ...)
+```
+
+**수명주기 관리:**
+- 팀원 태스크 완료 → 즉시 `shutdown_request` 전송
+- 종료 후 `TaskList`로 다음 태스크 확인
+- 모든 작업 완료 → `TeamDelete`로 팀 해산
+
+---
+
 ## 병렬 에이전트 실행
 
 @../../instructions/agent-patterns/delegation-patterns.md

package/templates/.claude/skills/prd/SKILL.md

@@ -117,6 +117,25 @@ user-invocable: true
 
 <parallel_agent_execution>
 
+### ⚠️ Agent Teams 우선 원칙
+
+> **복잡한 병렬 작업 시 Agent Teams를 기본으로 사용**
+> - Agent Teams 가용 → TeamCreate → 팀원 spawn → 병렬 협업
+> - Agent Teams 미가용 → Task 병렬 호출 (폴백)
+
+**Agent Teams 모드 (기본)**:
+```typescript
+TeamCreate({ team_name: "prd-team", description: "PRD 작성" })
+Task(subagent_type="analyst", team_name="prd-team", name="analyst", ...)
+```
+
+**수명주기 관리:**
+- 팀원 태스크 완료 → 즉시 `shutdown_request` 전송
+- 종료 후 `TaskList`로 다음 태스크 확인
+- 모든 작업 완료 → `TeamDelete`로 팀 해산
+
+---
+
 ## 병렬 Agent 실행
 
 ### Agent & Model Routing

package/templates/.claude/skills/project-optimizer/SKILL.md

@@ -41,6 +41,25 @@ metadata:
 
 <parallel_agent_execution>
 
+### ⚠️ Agent Teams 우선 원칙
+
+> **복잡한 병렬 작업 시 Agent Teams를 기본으로 사용**
+> - Agent Teams 가용 → TeamCreate → 팀원 spawn → 병렬 협업
+> - Agent Teams 미가용 → Task 병렬 호출 (폴백)
+
+**Agent Teams 모드 (기본)**:
+```typescript
+TeamCreate({ team_name: "optimizer-team", description: "프로젝트 최적화" })
+Task(subagent_type="analyst", team_name="optimizer-team", name="analyst", ...)
+```
+
+**수명주기 관리:**
+- 팀원 태스크 완료 → 즉시 `shutdown_request` 전송
+- 종료 후 `TaskList`로 다음 태스크 확인
+- 모든 작업 완료 → `TeamDelete`로 팀 해산
+
+---
+
 ## 병렬 에이전트 실행
 
 ### 기본 원칙

package/templates/.claude/skills/refactor/SKILL.md

@@ -150,6 +150,25 @@ $ARGUMENTS 있음 → 다음 단계 진행
 
 <parallel_agent_execution>
 
+### ⚠️ Agent Teams 우선 원칙
+
+> **복잡한 병렬 작업 시 Agent Teams를 기본으로 사용**
+> - Agent Teams 가용 → TeamCreate → 팀원 spawn → 병렬 협업
+> - Agent Teams 미가용 → Task 병렬 호출 (폴백)
+
+**Agent Teams 모드 (기본)**:
+```typescript
+TeamCreate({ team_name: "refactor-team", description: "리팩토링" })
+Task(subagent_type="refactor-advisor", team_name="refactor-team", name="advisor", ...)
+```
+
+**수명주기 관리:**
+- 팀원 태스크 완료 → 즉시 `shutdown_request` 전송
+- 종료 후 `TaskList`로 다음 태스크 확인
+- 모든 작업 완료 → `TeamDelete`로 팀 해산
+
+---
+
 ## 병렬 에이전트 실행
 
 @../../instructions/agent-patterns/delegation-patterns.md

package/templates/.claude/skills/sql-optimizer/SKILL.md

@@ -263,6 +263,25 @@ thought 5: "추천: 옵션 B - ORM 최적화 + Partial Index
 
 <parallel_agent_execution>
 
+### ⚠️ Agent Teams 우선 원칙
+
+> **복잡한 병렬 작업 시 Agent Teams를 기본으로 사용**
+> - Agent Teams 가용 → TeamCreate → 팀원 spawn → 병렬 협업
+> - Agent Teams 미가용 → Task 병렬 호출 (폴백)
+
+**Agent Teams 모드 (기본)**:
+```typescript
+TeamCreate({ team_name: "sql-team", description: "SQL 최적화" })
+Task(subagent_type="architect", team_name="sql-team", name="architect", ...)
+```
+
+**수명주기 관리:**
+- 팀원 태스크 완료 → 즉시 `shutdown_request` 전송
+- 종료 후 `TaskList`로 다음 태스크 확인
+- 모든 작업 완료 → `TeamDelete`로 팀 해산
+
+---
+
 ## 병렬 에이전트 실행
 
 ```typescript

package/templates/.claude/skills/tanstack-start-react-best-practices/SKILL.md

@@ -40,6 +40,25 @@ React 19와 TanStack Start v1 애플리케이션 성능 최적화 가이드. 8
 
 <parallel_agent_execution>
 
+### ⚠️ Agent Teams 우선 원칙
+
+> **복잡한 병렬 작업 시 Agent Teams를 기본으로 사용**
+> - Agent Teams 가용 → TeamCreate → 팀원 spawn → 병렬 협업
+> - Agent Teams 미가용 → Task 병렬 호출 (폴백)
+
+**Agent Teams 모드 (기본)**:
+```typescript
+TeamCreate({ team_name: "tanstack-team", description: "TanStack Start 최적화" })
+Task(subagent_type="general-purpose", team_name="tanstack-team", name="optimizer", ...)
+```
+
+**수명주기 관리:**
+- 팀원 태스크 완료 → 즉시 `shutdown_request` 전송
+- 종료 후 `TaskList`로 다음 태스크 확인
+- 모든 작업 완료 → `TeamDelete`로 팀 해산
+
+---
+
 ## 병렬 에이전트 실행
 
 **ULTRAWORK MODE:** TanStack Start 최적화 작업 시 여러 규칙을 동시에 적용하여 5-15배 성능 향상.

package/templates/.claude/skills/tauri-react-best-practices/SKILL.md

@@ -43,6 +43,25 @@ Tauri v2 + React 19 데스크톱/모바일 애플리케이션 성능 및 보안
 
 <parallel_agent_execution>
 
+### ⚠️ Agent Teams 우선 원칙
+
+> **복잡한 병렬 작업 시 Agent Teams를 기본으로 사용**
+> - Agent Teams 가용 → TeamCreate → 팀원 spawn → 병렬 협업
+> - Agent Teams 미가용 → Task 병렬 호출 (폴백)
+
+**Agent Teams 모드 (기본)**:
+```typescript
+TeamCreate({ team_name: "tauri-team", description: "Tauri + React 최적화" })
+Task(subagent_type="general-purpose", team_name="tauri-team", name="optimizer", ...)
+```
+
+**수명주기 관리:**
+- 팀원 태스크 완료 → 즉시 `shutdown_request` 전송
+- 종료 후 `TaskList`로 다음 태스크 확인
+- 모든 작업 완료 → `TeamDelete`로 팀 해산
+
+---
+
 ## 병렬 에이전트 실행
 
 **ULTRAWORK MODE:** Tauri + React 최적화 작업 시 여러 규칙을 동시에 적용.