@kood/claude-code 0.5.0 → 0.5.3

package/templates/.claude/commands/git-session.md

@@ -2,6 +2,9 @@
 description: 현재 세션에서 수정한 파일만 커밋 후 푸시
 ---
 
+@../instructions/multi-agent/coordination-guide.md
+@../instructions/multi-agent/execution-patterns.md
+
 # Git Session Command
 
 > @git-operator 에이전트를 사용하여 현재 세션 파일만 선택적으로 커밋하고 푸시.
@@ -106,74 +109,3 @@ git push
 
 </example>
 
----
-
-<parallel_agent_execution>
-
-## Recommended Agents
-
-| Agent | Model | Purpose |
-|-------|-------|---------|
-| **@git-operator** | haiku | Git 커밋/푸시 작업 (필수) |
-| **@code-reviewer** | haiku/sonnet | 세션 변경사항 검토 |
-| **@explore** | haiku | 세션 파일 탐색 |
-
----
-
-## Parallel Execution Patterns
-
-| Pattern | Description |
-|---------|-------------|
-| **검토 + 탐색 병렬** | @code-reviewer와 @explore 동시 실행 |
-| **분석 후 순차 커밋** | 병렬 분석 → 순차 git 작업 |
-
-**❌ Git 커밋은 순차 실행:**
-- git-session은 단일 커밋 흐름
-- 병렬화 불필요
-
----
-
-## Model Routing
-
-| Complexity | Model | Scenario |
-|------------|-------|----------|
-| **LOW** | haiku | 단순 세션 커밋 (1-3 files) |
-| **MEDIUM** | haiku/sonnet | 일반 세션 커밋 (4-10 files) |
-
----
-
-## Practical Examples
-
-```typescript
-// ✅ 검토 + 탐색 병렬
-Task({
-  subagent_type: 'code-reviewer',
-  model: 'haiku',
-  prompt: '세션 변경사항 검토'
-})
-Task({
-  subagent_type: 'explore',
-  model: 'haiku',
-  prompt: '세션 파일 목록 확인'
-})
-
-// 분석 완료 후 순차 커밋
-Task({
-  subagent_type: 'git-operator',
-  model: 'haiku',
-  prompt: `
-    세션 커밋 모드:
-    - 현재 세션 관련 파일만 선택적 커밋
-    - 반드시 푸시 (git push)
-  `
-})
-```
-
-```typescript
-// ❌ Git 커밋 병렬화 시도
-// git-session은 단일 커밋이므로 병렬화 불필요
-Task({ subagent_type: 'git-operator', prompt: '파일 A 커밋' })
-Task({ subagent_type: 'git-operator', prompt: '파일 B 커밋' })  // 불필요
-```
-
-</parallel_agent_execution>

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

@@ -4,6 +4,9 @@ allowed-tools: Task
 argument-hint: [파일/디렉토리 경로...]
 ---
 
+@../instructions/multi-agent/coordination-guide.md
+@../instructions/multi-agent/execution-patterns.md
+
 # Lint Fix Command
 
 > @lint-fixer 에이전트를 사용하여 tsc/eslint 오류를 자동으로 수정.
@@ -115,88 +118,6 @@ Task({
 
 ---
 
-<parallel_agent_execution>
-
-## 병렬 에이전트 실행
-
-**Recommended Agents:**
-
-| Agent | Model | 용도 |
-|-------|-------|------|
-| @lint-fixer | haiku/sonnet | 오류 수정 |
-| @explore | haiku | 관련 파일 탐색 |
-| @code-reviewer | haiku | 수정 후 검증 |
-
-**Parallel Execution Patterns:**
-
-1. **파일별 병렬 수정:** 각 파일마다 별도 lint-fixer
-2. **오류 타입별 병렬:** 타입 오류와 린트 오류 동시 수정
-3. **수정 + 검증 병렬:** 여러 파일 동시 수정 후 검증
-
-**Model Routing:**
-
-| 복잡도 | 오류 범위 | 모델 |
-|--------|----------|------|
-| LOW | 단순 오류 (1-5개) | haiku |
-| MEDIUM | 일반 오류 (6-20개) | sonnet |
-| HIGH | 복잡한 오류 (타입 추론) | sonnet/opus |
-
-**Practical Examples:**
-
-```typescript
-// ✅ 파일별 병렬 수정
-Task({
-  subagent_type: 'lint-fixer',
-  model: 'haiku',
-  prompt: 'src/utils/format.ts 린트 오류 수정'
-})
-Task({
-  subagent_type: 'lint-fixer',
-  model: 'haiku',
-  prompt: 'src/components/Button.tsx 린트 오류 수정'
-})
-
-// ✅ 타입 + 린트 병렬
-Task({
-  subagent_type: 'lint-fixer',
-  model: 'sonnet',
-  prompt: '타입 오류 수정'
-})
-Task({
-  subagent_type: 'lint-fixer',
-  model: 'haiku',
-  prompt: 'ESLint 오류 수정'
-})
-
-// ✅ 수정 + 검증 병렬
-Task({
-  subagent_type: 'lint-fixer',
-  model: 'haiku',
-  prompt: 'src/utils/*.ts 파일들 린트 오류 수정'
-})
-Task({
-  subagent_type: 'code-reviewer',
-  model: 'haiku',
-  prompt: '수정된 파일들 코드 품질 검증'
-})
-
-// ✅ 탐색 + 수정 병렬
-Task({
-  subagent_type: 'explore',
-  model: 'haiku',
-  prompt: '타입 정의 파일 위치 탐색'
-})
-Task({
-  subagent_type: 'lint-fixer',
-  model: 'sonnet',
-  prompt: '타입 오류 수정'
-})
-```
-
-</parallel_agent_execution>
-
----
-
 <required>
 
 | 분류 | 필수 |
@@ -234,6 +155,122 @@ Task({
 
 ---
 
+<parallel_execution_critical>
+
+## ⚠️ CRITICAL: 병렬 검사 필수
+
+**tsc와 eslint는 반드시 단일 메시지에서 병렬로 실행해야 합니다.**
+
+### 올바른 실행 방법
+
+```typescript
+// ✅ 단일 메시지에서 2개 Bash 동시 호출
+Bash({ command: "npx tsc --noEmit", description: "TypeScript type check" })
+Bash({ command: "npx eslint .", description: "ESLint check" })
+```
+
+**이렇게 하면:**
+- 2개의 검사가 동시에 실행됨
+- 총 실행 시간 = max(tsc 시간, eslint 시간)
+- 순차 실행 대비 약 50% 시간 단축
+
+### 잘못된 실행 방법
+
+```typescript
+// ❌ 순차 실행 (느림)
+Bash({ command: "npx tsc --noEmit", description: "..." })
+// 대기...
+Bash({ command: "npx eslint .", description: "..." })
+```
+
+**이렇게 하면:**
+- tsc 완료 후 eslint 시작
+- 총 실행 시간 = tsc 시간 + eslint 시간
+- 불필요한 대기 시간 발생
+
+### 병렬 검사 체크리스트
+
+작업 시작 전 확인:
+
+- [ ] tsc와 eslint를 단일 메시지에서 호출하는가?
+- [ ] 2개의 Bash 도구를 연속으로 작성했는가?
+- [ ] 중간에 대기나 다른 작업이 없는가?
+
+**모든 항목이 체크되어야 올바른 병렬 실행입니다.**
+
+### 파일별 병렬 수정 패턴
+
+**독립적인 파일의 오류는 병렬 수정 가능:**
+
+```typescript
+// ✅ 서로 다른 파일 동시 수정
+Task({ subagent_type: 'lint-fixer', model: 'haiku',
+       prompt: 'src/utils/format.ts 린트 오류 수정' })
+Task({ subagent_type: 'lint-fixer', model: 'haiku',
+       prompt: 'src/components/Button.tsx 린트 오류 수정' })
+
+// ❌ 같은 파일 동시 수정 (충돌 위험)
+Task({ prompt: 'src/utils/format.ts 타입 오류 수정' })
+Task({ prompt: 'src/utils/format.ts 린트 오류 수정' })
+```
+
+**규칙:**
+- 독립 파일 → 병렬 수정 가능
+- 동일 파일 → 순차 수정 필수
+- 타입 정의 공유 → 순차 수정 필수
+
+### 실제 실행 워크플로우
+
+**Step 1: 병렬 검사 (필수)**
+
+```typescript
+// 커맨드 시작 시 즉시 실행
+Bash({
+  command: "npx tsc --noEmit",
+  description: "TypeScript type check"
+})
+Bash({
+  command: "npx eslint .",
+  description: "ESLint check"
+})
+```
+
+**Step 2: 오류 분석 및 그룹핑**
+
+- 간단한 오류: 즉시 수정 (Sequential Thinking 불필요)
+- 복잡한 오류: Sequential Thinking 3-5단계로 분석
+
+**Step 3: 독립 파일 병렬 수정**
+
+```typescript
+// 서로 다른 파일의 간단한 오류
+Edit({ file_path: "src/utils/format.ts", ... })  // 파일 1
+Edit({ file_path: "src/components/Button.tsx", ... })  // 파일 2
+```
+
+**Step 4: 재검사**
+
+```typescript
+// 수정된 파일들 병렬 재검사
+Bash({
+  command: "npx tsc --noEmit src/utils/format.ts",
+  description: "Verify format.ts fixes"
+})
+Bash({
+  command: "npx tsc --noEmit src/components/Button.tsx",
+  description: "Verify Button.tsx fixes"
+})
+```
+
+**전체 실행 시간:**
+- 순차: 검사(4초) + 수정1(2초) + 재검사1(1초) + 수정2(2초) + 재검사2(1초) = 10초
+- 병렬: 검사(2초) + 수정1,2 병렬(2초) + 재검사(1초) = 5초
+- **개선: 50% 시간 단축**
+
+</parallel_execution_critical>
+
+---
+
 <sequential_thinking>
 
 **각 오류마다 필수:**

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

@@ -3,7 +3,8 @@ description: 프로젝트 분석 후 ESLint flat config 설정
 allowed-tools: Read, Write, Edit, Glob, Bash, mcp__sequential-thinking__sequentialthinking
 ---
 
-@../instructions/sequential-thinking-guide.md
+@../instructions/multi-agent/coordination-guide.md
+@../instructions/multi-agent/execution-patterns.md
 
 # Lint Init Command
 
@@ -256,59 +257,6 @@ npm install -D eslint @eslint/js globals @typescript-eslint/parser @typescript-e
 
 ---
 
-<parallel_agent_execution>
-
-## 병렬 Agent 실행
-
-### Recommended Agents
-
-| Agent | Model | 역할 |
-|-------|-------|------|
-| **@implementation-executor** | sonnet | ESLint 설정 구현 |
-| **@explore** | haiku | 프로젝트 구조 탐색 |
-| **@analyst** | sonnet | 프로젝트 패턴 분석 |
-
-### Parallel Execution Patterns
-
-| 패턴 | 병렬 작업 | 효과 |
-|------|-----------|------|
-| **탐색 + 분석** | explore (haiku) + analyst (sonnet) | 프로젝트 이해 속도 향상 |
-| **설정 + 문서** | implementation-executor + document-writer | 구현과 문서화 동시 진행 |
-
-### Model Routing
-
-| 복잡도 | 모델 | 조건 |
-|--------|------|------|
-| **LOW** | haiku / sonnet | 기본 JS/TS 프로젝트, 단일 프레임워크 |
-| **MEDIUM** | sonnet | 커스텀 룰 설정, 여러 프레임워크 혼재 |
-| **HIGH** | opus | 복잡한 모노레포, 레거시 마이그레이션 |
-
-### Practical Examples
-
-```typescript
-// ✅ 탐색 + 분석 병렬
-Task(subagent_type="explore", model="haiku",
-     prompt="프로젝트 파일 구조 파악 (package.json, tsconfig.json, src/)")
-
-Task(subagent_type="analyst", model="sonnet",
-     prompt="코드 패턴 및 스타일 분석 (import 방식, 파일명 컨벤션)")
-
-// ✅ 설정 + 문서 병렬
-Task(subagent_type="implementation-executor", model="sonnet",
-     prompt="ESLint flat config 생성 (TypeScript + React)")
-
-Task(subagent_type="document-writer", model="haiku",
-     prompt="린트 설정 가이드 작성 (패키지 설치 명령어, 사용법)")
-
-// ✅ 복잡한 마이그레이션
-Task(subagent_type="implementation-executor", model="opus",
-     prompt=".eslintrc.json → flat config 변환 (커스텀 룰 200+ 보존)")
-```
-
-</parallel_agent_execution>
-
----
-
 <validation>
 
 ## 검증 단계

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

@@ -4,6 +4,9 @@ allowed-tools: Bash(tsc:*, npx:*, yarn:*, npm:*, pnpm:*), Read, Edit, mcp__seque
 argument-hint: [파일/디렉토리 경로...]
 ---
 
+@../instructions/multi-agent/coordination-guide.md
+@../instructions/multi-agent/execution-patterns.md
+
 # Pre-Deploy Command
 
 > 배포 전 typecheck/lint/build를 Sequential Thinking으로 검증하고 수정
@@ -59,88 +62,6 @@ argument-hint: [파일/디렉토리 경로...]
 
 ---
 
-<parallel_agent_execution>
-
-## 병렬 Agent 실행
-
-**권장 Agent:**
-
-| Agent | 모델 | 용도 |
-|-------|------|------|
-| @deployment-validator | sonnet/opus | 전체 검증 자동화 (typecheck + lint + build) |
-| @lint-fixer | haiku/sonnet | 린트 오류 자동 수정 |
-| @code-reviewer | sonnet | 배포 전 코드 품질 리뷰 |
-
-**병렬 실행 패턴:**
-
-| 작업 유형 | 실행 방식 | 이유 |
-|----------|----------|------|
-| typecheck + lint 검사 | ✅ 병렬 가능 | 읽기 전용, 파일 충돌 없음 |
-| 오류 수정 | ❌ 순차 실행 | 동일 파일 동시 수정 방지 |
-| 검증 + 문서화 | ✅ 병렬 가능 | validator + document-writer 독립적 |
-| build + test | ❌ 순차 실행 | build 완료 후 test 실행 |
-
-**모델 라우팅:**
-
-| 복잡도 | 모델 | 사용 시나리오 |
-|--------|------|-------------|
-| LOW | haiku | 간단한 린트 오류, 단순 검증 |
-| MEDIUM | sonnet | 일반적인 typecheck/lint 검증, 수정 |
-| HIGH | opus | 복잡한 타입 오류, 아키텍처 영향 분석 |
-
-**실전 예시:**
-
-```typescript
-// ✅ 병렬 검사 (읽기 전용)
-Task({
-  subagent_type: "deployment-validator",
-  model: "sonnet",
-  prompt: "typecheck 실행 및 검증"
-})
-Task({
-  subagent_type: "deployment-validator",
-  model: "sonnet",
-  prompt: "lint 실행 및 검증"
-})
-
-// ✅ 검증 + 문서화 병렬
-Task({
-  subagent_type: "deployment-validator",
-  model: "sonnet",
-  prompt: "배포 전 전체 검증"
-})
-Task({
-  subagent_type: "document-writer",
-  model: "haiku",
-  prompt: "CHANGELOG.md 업데이트"
-})
-
-// ❌ 수정 작업은 순차 실행 (충돌 방지)
-// 잘못된 예시:
-Task({ prompt: "src/utils/calc.ts 타입 오류 수정" })
-Task({ prompt: "src/utils/calc.ts 린트 오류 수정" })
-// → 동일 파일 동시 수정으로 충돌 발생
-
-// ✅ 올바른 순차 실행:
-// 1. typecheck + lint 병렬 검사
-// 2. 오류 목록 파악
-// 3. 파일별 순차 수정
-// 4. build 실행
-```
-
-**Agent 조합 권장:**
-
-| 목표 | Agent 조합 | 실행 방식 |
-|------|-----------|----------|
-| 빠른 검증 | @deployment-validator (haiku) | 단독 실행 |
-| 전체 검증 + 수정 | @deployment-validator (sonnet) → @lint-fixer (haiku) | 순차 |
-| 배포 준비 | @deployment-validator (sonnet) + @code-reviewer (sonnet) | 병렬 |
-| 자동화된 CI | @deployment-validator (opus) | 단독 실행 |
-
-</parallel_agent_execution>
-
----
-
 <required>
 
 | 분류 | 필수 |
@@ -188,6 +109,146 @@ Task({ prompt: "src/utils/calc.ts 린트 오류 수정" })
 
 ---
 
+<parallel_execution_critical>
+
+## ⚠️ CRITICAL: 병렬 검사 필수
+
+**typecheck와 lint는 반드시 단일 메시지에서 병렬로 실행해야 합니다.**
+
+### 올바른 실행 방법
+
+```typescript
+// ✅ 단일 메시지에서 2개 Bash 동시 호출
+Bash({ command: "npx tsc --noEmit", description: "TypeScript type check" })
+Bash({ command: "npx eslint .", description: "ESLint check" })
+```
+
+**이렇게 하면:**
+- typecheck와 lint가 동시에 실행됨
+- 총 실행 시간 = max(typecheck 시간, lint 시간)
+- 순차 실행 대비 약 50% 시간 단축
+
+### 잘못된 실행 방법
+
+```typescript
+// ❌ 순차 실행 (느림)
+Bash({ command: "npx tsc --noEmit", description: "..." })
+// 대기...
+Bash({ command: "npx eslint .", description: "..." })
+```
+
+**이렇게 하면:**
+- typecheck 완료 후 lint 시작
+- 총 실행 시간 = typecheck 시간 + lint 시간
+- 불필요한 대기 시간 발생
+
+### 병렬 검사 체크리스트
+
+배포 전 확인:
+
+- [ ] typecheck와 lint를 단일 메시지에서 호출하는가?
+- [ ] 2개의 Bash 도구를 연속으로 작성했는가?
+- [ ] 중간에 대기나 분석이 없는가?
+- [ ] 오류 수정은 순차로 진행하는가?
+- [ ] build는 오류 수정 완료 후 실행하는가?
+
+**모든 항목이 체크되어야 올바른 배포 준비입니다.**
+
+### 검증 + 문서화 병렬 패턴
+
+**검증과 문서화는 독립적이므로 병렬 가능:**
+
+```typescript
+// ✅ 검증 + 문서 업데이트 병렬
+Task({ subagent_type: 'deployment-validator', model: 'sonnet',
+       prompt: 'typecheck + lint + build 전체 검증' })
+Task({ subagent_type: 'document-writer', model: 'haiku',
+       prompt: 'CHANGELOG.md 업데이트' })
+
+// ✅ 여러 관점의 코드 리뷰 병렬
+Task({ subagent_type: 'code-reviewer', model: 'opus',
+       prompt: '보안 검토 (SQL Injection, XSS, CSRF)' })
+Task({ subagent_type: 'code-reviewer', model: 'opus',
+       prompt: '성능 검토 (N+1 쿼리, 메모이제이션)' })
+Task({ subagent_type: 'code-reviewer', model: 'opus',
+       prompt: '접근성 검토 (ARIA, 키보드 네비게이션)' })
+```
+
+**규칙:**
+- 검사 단계 → 병렬 실행
+- 오류 수정 → 순차 실행 (파일 충돌 방지)
+- 검증 + 문서화 → 병렬 가능
+- build → 오류 수정 완료 후
+
+### 실제 배포 준비 워크플로우
+
+**Step 1: 병렬 검사 (필수)**
+
+```typescript
+// 배포 준비 시작 시 즉시 실행
+Bash({
+  command: "npx tsc --noEmit",
+  description: "TypeScript type check"
+})
+Bash({
+  command: "npx eslint .",
+  description: "ESLint check"
+})
+```
+
+**Step 2: 오류 수정 (순차)**
+
+- 오류가 있으면 하나씩 수정
+- 각 수정 후 해당 파일만 재검사
+
+**Step 3: 전체 재검사**
+
+```typescript
+// 모든 수정 완료 후 전체 검사
+Bash({
+  command: "npx tsc --noEmit",
+  description: "Final type check"
+})
+Bash({
+  command: "npx eslint .",
+  description: "Final lint check"
+})
+```
+
+**Step 4: Build**
+
+```bash
+npm run build  # 또는 yarn build, pnpm build
+```
+
+**Step 5: 검증 + 문서화 (병렬)**
+
+```typescript
+// build 성공 후 병렬 작업
+Task({
+  subagent_type: 'code-reviewer',
+  model: 'opus',
+  description: '배포 전 최종 코드 리뷰',
+  prompt: '보안, 성능, 접근성 종합 검토'
+})
+Task({
+  subagent_type: 'document-writer',
+  model: 'haiku',
+  description: 'CHANGELOG 업데이트',
+  prompt: '배포 버전 변경사항 문서화'
+})
+```
+
+**전체 실행 시간:**
+- 순차: 검사1(3초) + 검사2(2초) + 수정(5초) + 재검사1(3초) + 재검사2(2초) + build(10초) = 25초
+- 병렬: 검사(3초) + 수정(5초) + 재검사(3초) + build(10초) = 21초
+- **개선: 16% 시간 단축** (검사 단계만 병렬화 시)
+- 검증+문서화까지 병렬화 시 추가 30% 단축 가능
+
+</parallel_execution_critical>
+
+---
+
 <sequential_thinking>
 
 **각 오류마다 필수:**