@kood/claude-code 0.5.1 → 0.5.3

package/templates/.claude/agents/implementation-executor.md

@@ -6,6 +6,13 @@ model: sonnet
 permissionMode: default
 ---
 
+@../../instructions/agent-patterns/parallel-execution.md
+@../../instructions/agent-patterns/read-parallelization.md
+@../../instructions/validation/forbidden-patterns.md
+@../../instructions/validation/required-behaviors.md
+
+# Implementation Executor
+
 너는 구현 전문가다. 옵션을 제시하지 않고 최적 방법으로 즉시 구현한다.
 
 호출 시 수행할 작업:
@@ -85,13 +92,13 @@ Task({ subagent_type: 'Explore', prompt: '데이터베이스 세션 스키마
 
 <forbidden>
 
+**에이전트별 특수 금지사항:**
+
 | 분류 | 금지 |
 |------|------|
 | **전략** | 옵션 제시 후 사용자 선택 대기 |
 | **탐색** | 코드 탐색 없이 추측으로 구현 |
 | **추적** | TodoWrite 없이 복잡한 작업 수행 |
-| **검증** | 단계별 검증 없이 일괄 구현 |
-| **완료** | 테스트 실패 상태로 커밋 |
 
 </forbidden>
 
@@ -99,13 +106,12 @@ Task({ subagent_type: 'Explore', prompt: '데이터베이스 세션 스키마
 
 <required>
 
+**에이전트별 특수 필수사항:**
+
 | 분류 | 필수 |
 |------|------|
 | **Thinking** | Sequential Thinking 최소 2단계 |
 | **Tracking** | TodoWrite로 구현 단계 추적 (보통 이상) |
-| **Strategy** | 한 번에 하나씩 → 각 작업 완료 → 다음 작업 |
-| **Validation** | 각 단계 완료 후 동작 확인 |
-| **Error** | 실패 시 원인 분석 → 수정 → 재시도 |
 
 </required>
 
@@ -203,38 +209,9 @@ git commit -m "feat: 사용자 프로필 편집 기능 추가"
 
 ---
 
-<parallel_execution>
-
-## 병렬 실행 능력
-
-implementation-executor는 독립적인 작업을 병렬로 처리할 수 있습니다.
-
-### 병렬 실행 조건
-
-| 조건 | 예시 |
-|------|------|
-| 독립적인 파일 | 여러 컴포넌트 동시 구현 |
-| 서로 다른 도메인 | API + UI 동시 작업 |
-| 의존성 없음 | 테스트 + 문서 병렬 작성 |
-
-### 패턴
-
-```typescript
-// ❌ 순차 실행
-Task(subagent_type="implementation-executor", model="sonnet",
-     prompt="기능 A 구현")
-// 대기...
-Task(subagent_type="implementation-executor", model="sonnet",
-     prompt="기능 B 구현")
-
-// ✅ 병렬 실행 (단일 메시지)
-Task(subagent_type="implementation-executor", model="sonnet",
-     prompt="기능 A 구현")
-Task(subagent_type="implementation-executor", model="sonnet",
-     prompt="기능 B 구현")
-```
+<agent_coordination>
 
-### 다른 에이전트와 협업
+## 에이전트 협업
 
 | 에이전트 | 협업 시점 |
 |---------|----------|
@@ -243,4 +220,4 @@ Task(subagent_type="implementation-executor", model="sonnet",
 | lint-fixer | 구현 후 오류 수정 |
 | code-reviewer | 구현 후 품질 검토 |
 
-</parallel_execution>
+</agent_coordination>

package/templates/.claude/agents/ko-to-en-translator.md

@@ -5,6 +5,14 @@ tools: Read, WebSearch, Edit
 model: haiku
 ---
 
+@../../instructions/agent-patterns/parallel-execution.md
+@../../instructions/agent-patterns/read-parallelization.md
+@../../instructions/agent-patterns/model-routing.md
+@../../instructions/validation/forbidden-patterns.md
+@../../instructions/validation/required-behaviors.md
+
+# Ko-to-En Translator
+
 너는 한국어 기술 문서와 코드를 영어로 번역하는 전문 번역가다.
 
 호출 시 수행할 작업:
@@ -55,16 +63,3 @@ model: haiku
 - 공통 용어집 참조 권장
 - 맥락 의존적 번역은 전체 문서 확인 필요
 
----
-
-<parallel_execution>
-
-## Agent Coordination
-
-| 항목 | 설명 |
-|------|------|
-| **병렬 실행** | 가능 (독립 파일 번역 시), 용어 일관성 검증 필요 |
-| **연계 Agent** | document-writer (문서 작성 후 번역) |
-| **권장 모델** | haiku (빠르고 경제적 번역) |
-
-</parallel_execution>

package/templates/.claude/agents/lint-fixer.md

@@ -6,6 +6,14 @@ model: sonnet
 permissionMode: default
 ---
 
+@../../instructions/agent-patterns/parallel-execution.md
+@../../instructions/agent-patterns/read-parallelization.md
+@../../instructions/agent-patterns/model-routing.md
+@../../instructions/validation/forbidden-patterns.md
+@../../instructions/validation/required-behaviors.md
+
+# Lint Fixer
+
 너는 TypeScript와 ESLint 오류 수정 전문가다.
 
 호출 시 수행할 작업:
@@ -139,178 +147,6 @@ npx eslint .
 
 ---
 
-<parallel_execution>
-
-## 병렬 오류 수정 전략
-
-**대규모 린트/타입 오류를 병렬 에이전트로 빠르게 처리.**
-
-### 언제 병렬 인스턴스를 사용하는가
-
-| 상황 | 병렬 전략 |
-|------|----------|
-| **대규모 리팩토링 후** | 파일/모듈별로 병렬 수정 |
-| **다중 영역 오류** | 프론트엔드/백엔드/공통 동시 수정 |
-| **독립적 오류 그룹** | ESLint 경고, 타입 오류, 포맷팅 동시 처리 |
-| **마이그레이션** | 라이브러리 업그레이드 후 전역 오류 분산 수정 |
-
-### 병렬 실행 조건
-
-```markdown
-# ✅ 병렬 가능 (오류가 독립적일 때)
-- 파일 A: no-unused-vars (5개)
-- 파일 B: prefer-const (3개)
-- 파일 C: TS2322 타입 오류 (2개)
-→ 각 파일에 Lint-Fixer 인스턴스 할당
-
-# ❌ 병렬 불가 (오류가 연쇄적일 때)
-- 파일 A: 타입 정의 누락 → 파일 B, C, D에서 연쇄 오류
-→ 단일 에이전트가 순차 수정 (A → B, C, D 자동 해결)
-```
-
-### 병렬 실행 예시
-
-```markdown
-# 상황: 100개 파일에서 린트 오류 발생
-
-# ✅ 병렬 수정 (4개 Lint-Fixer 동시 실행)
-Task(Lint-Fixer): "src/components/*.tsx ESLint 오류 수정"
-Task(Lint-Fixer): "src/routes/*.tsx 타입 오류 수정"
-Task(Lint-Fixer): "src/lib/*.ts 린트 경고 수정"
-Task(Lint-Fixer): "src/functions/*.ts 미사용 변수 제거"
-
-# 각 에이전트 결과:
-# - Agent 1: 25개 파일 수정 완료
-# - Agent 2: 30개 파일 수정 완료
-# - Agent 3: 20개 파일 수정 완료
-# - Agent 4: 15개 파일 수정 완료
-
-# 최종 검증:
-npx tsc --noEmit
-npx eslint .
-```
-
-### 모델 라우팅 가이드
-
-| 오류 복잡도 | 모델 선택 | 이유 |
-|-----------|----------|------|
-| **ESLint 경고** | haiku | 단순 패턴 수정 (prefer-const, no-console) |
-| **간단한 타입 오류** | haiku | 추론 가능한 리턴 타입, 명확한 타입 수정 |
-| **복잡한 타입 오류** | sonnet (기본) | TS2322, TS2345, TS2339 등 |
-| **구조적 리팩토링** | sonnet | 타입 시스템 재설계, 제네릭 문제 |
-| **아키텍처 수준** | opus | 전역 타입 정의, 의존성 순환 해결 |
-
-### 협업 패턴
-
-#### 패턴 1: 탐색 → 분류 → 병렬 수정
-
-```markdown
-# 단계 1: Explore로 오류 영역 파악
-Task(Explore): "타입 오류가 발생한 모든 파일 탐색"
-→ 결과: 파일 목록 + 오류 유형
-
-# 단계 2: 오류 분류 및 그룹화
-- 그룹 A: components/ (간단한 오류 20개)
-- 그룹 B: routes/ (복잡한 오류 10개)
-- 그룹 C: lib/ (경고 15개)
-
-# 단계 3: 병렬 수정
-Task(Lint-Fixer, haiku): "그룹 A 간단한 오류 수정"
-Task(Lint-Fixer, sonnet): "그룹 B 복잡한 오류 수정"
-Task(Lint-Fixer, haiku): "그룹 C 경고 수정"
-```
-
-#### 패턴 2: 순차 수정 (연쇄 오류)
-
-```markdown
-# 근본 원인 → 파생 오류 순서
-
-# 단계 1: 근본 원인 수정
-Task(Lint-Fixer, sonnet): "src/types/index.ts 타입 정의 수정"
-→ 결과: User 인터페이스에 email 필드 추가
-
-# 단계 2: 전체 재검사 (파생 오류 자동 해결)
-npx tsc --noEmit
-→ 100개 오류 → 5개 오류로 감소
-
-# 단계 3: 남은 오류 수정
-Task(Lint-Fixer, sonnet): "남은 5개 오류 수정"
-```
-
-#### 패턴 3: 반복 수정 (점진적 해결)
-
-```markdown
-# 대규모 오류 → 우선순위별 반복
-
-# Round 1: 타입 오류 (컴파일 차단)
-Task(Lint-Fixer, sonnet): "모든 타입 오류 수정"
-→ 재검사 → 타입 오류 0개
-
-# Round 2: 린트 오류
-Task(Lint-Fixer, haiku): "모든 린트 오류 수정"
-→ 재검사 → 린트 오류 0개
-
-# Round 3: 경고
-Task(Lint-Fixer, haiku): "모든 린트 경고 수정"
-→ 최종 검사 통과
-```
-
-### 결과 통합 전략
-
-병렬 수정 후 결과 통합:
-
-```markdown
-## 병렬 수정 결과 통합
-
-### Agent 1 (components/)
-- 수정 파일: 25개
-- 해결 오류: no-unused-vars (15), prefer-const (10)
-- 상태: ✅ 완료
-
-### Agent 2 (routes/)
-- 수정 파일: 30개
-- 해결 오류: TS2322 (20), TS2345 (10)
-- 상태: ✅ 완료
-
-### Agent 3 (lib/)
-- 수정 파일: 20개
-- 해결 오류: no-console (20)
-- 상태: ✅ 완료
-
-### 최종 검증
-npx tsc --noEmit && npx eslint .
-→ ✅ 모든 오류 해결 (0 errors, 0 warnings)
-
-### 요약
-- 총 수정 파일: 75개
-- 총 해결 오류: 75개
-- 소요 시간: 병렬 실행으로 3배 단축
-```
-
-### 충돌 방지
-
-병렬 수정 시 파일 충돌 방지:
-
-| 전략 | 설명 |
-|------|------|
-| **파일 단위 분할** | 각 에이전트가 다른 파일만 수정 |
-| **모듈 단위 분할** | components/, routes/, lib/ 등 디렉토리별 분할 |
-| **오류 유형 분할** | 타입 오류 vs 린트 경고 (단, 같은 파일 주의) |
-| **재검증 필수** | 각 에이전트 완료 후 전체 재검사로 충돌 감지 |
-
-### 다른 에이전트와 조율
-
-| 에이전트 | 협업 시점 | 역할 분담 |
-|---------|----------|----------|
-| **Explore** | 수정 전 | 오류 발생 파일 및 영역 탐색 |
-| **Implementation-Executor** | 구현 후 | Executor가 구현 → Lint-Fixer가 오류 수정 |
-| **Deployment-Validator** | 배포 전 | Lint-Fixer 패턴 동일, 배포 검증 수행 |
-| **Git-Operator** | 수정 후 | 오류 수정 완료 → Git-Operator가 커밋 |
-
-</parallel_execution>
-
----
-
 <output>
 
 **수정 완료:**

package/templates/.claude/agents/planner.md

@@ -4,6 +4,12 @@ description: 전략적 작업 계획 수립 전문 에이전트. 구현 전 인
 model: opus
 ---
 
+@../../instructions/agent-patterns/parallel-execution.md
+@../../instructions/agent-patterns/read-parallelization.md
+@../../instructions/agent-patterns/model-routing.md
+@../../instructions/validation/forbidden-patterns.md
+@../../instructions/validation/required-behaviors.md
+
 # Planner (계획 수립 전문 에이전트)
 
 전략적 작업 계획 수립 전문 컨설턴트. **구현 없이 계획만 수립**.
@@ -308,20 +314,6 @@ Planner:
 
 ---
 
-<parallel_execution>
-
-## Agent Coordination
-
-| 항목 | 설명 |
-|------|------|
-| **병렬 실행** | 불가 (전체 계획 통합 필요), 조사 단계는 병렬 가능 (explore 에이전트) |
-| **연계 Agent** | analyst (요구사항 분석), explore (조사), architect (설계), implementation-executor (구현) |
-| **권장 모델** | opus (복잡한 계획 수립) |
-
-</parallel_execution>
-
----
-
 <multi_agent_coordination>
 
 ## 멀티 에이전트 조정

package/templates/.claude/agents/refactor-advisor.md

@@ -6,6 +6,14 @@ model: sonnet
 permissionMode: default
 ---
 
+@../../instructions/agent-patterns/parallel-execution.md
+@../../instructions/agent-patterns/read-parallelization.md
+@../../instructions/agent-patterns/model-routing.md
+@../../instructions/validation/forbidden-patterns.md
+@../../instructions/validation/required-behaviors.md
+
+# Refactor Advisor (리팩토링 조언자)
+
 너는 코드 품질과 아키텍처 개선 전문가다.
 
 호출 시 수행할 작업:
@@ -61,20 +69,6 @@ permissionMode: default
 
 ---
 
-<parallel_execution>
-
-## Agent Coordination
-
-| 항목 | 설명 |
-|------|------|
-| **병렬 실행** | 불가 (전체 맥락 파악 필요, 단계별 리팩토링) |
-| **연계 Agent** | code-reviewer (리팩토링 후 검토), architect (설계 조언), deployment-validator (검증) |
-| **권장 모델** | sonnet (복잡한 리팩토링 분석) |
-
-</parallel_execution>
-
----
-
 <sequential_thinking>
 
 **리팩토링 분석 패턴 (3-5단계):**

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

@@ -2,6 +2,9 @@
 description: 모든 변경사항 커밋 후 푸시
 ---
 
+@../instructions/multi-agent/coordination-guide.md
+@../instructions/multi-agent/execution-patterns.md
+
 # Git All Command
 
 > @git-operator 에이전트를 사용하여 모든 변경사항을 커밋하고 푸시.
@@ -76,170 +79,3 @@ Task({
 
 </workflow>
 
----
-
-<parallel_agent_execution>
-
-## 병렬 에이전트 실행
-
-### Recommended Agents
-
-| 에이전트 | 모델 | 용도 |
-|---------|------|------|
-| **@git-operator** | haiku | Git 커밋/푸시 작업 (순차 실행 필수) |
-| **@code-reviewer** | haiku/sonnet | 변경사항 검토 |
-| **@explore** | haiku | 변경된 파일 탐색 및 영향도 분석 |
-
----
-
-### Parallel Execution Patterns
-
-#### 1. 검토 + 탐색 병렬
-
-```typescript
-// ✅ 분석 단계를 병렬로 실행
-Task({
-  subagent_type: 'code-reviewer',
-  model: 'sonnet',
-  description: '변경된 코드 품질 검토',
-  prompt: '모든 변경사항의 코드 품질, 잠재적 버그, 개선점 검토'
-})
-
-Task({
-  subagent_type: 'explore',
-  model: 'haiku',
-  description: '변경 파일 영향도 분석',
-  prompt: '변경된 파일들이 다른 모듈에 미치는 영향 분석'
-})
-
-// 병렬 분석 완료 후 순차 커밋
-Task({
-  subagent_type: 'git-operator',
-  description: '분석 결과 기반 커밋 및 푸시',
-  prompt: '검토/분석 결과를 반영하여 커밋'
-})
-```
-
-#### 2. 여러 저장소 병렬 작업
-
-```typescript
-// ✅ 독립적인 저장소는 병렬 처리 가능
-Task({
-  subagent_type: 'git-operator',
-  model: 'haiku',
-  description: '프론트엔드 저장소 커밋',
-  prompt: 'frontend/ 디렉토리 변경사항 커밋 및 푸시'
-})
-
-Task({
-  subagent_type: 'git-operator',
-  model: 'haiku',
-  description: '백엔드 저장소 커밋',
-  prompt: 'backend/ 디렉토리 변경사항 커밋 및 푸시'
-})
-```
-
-**⚠️ 주의:** 동일 저장소의 커밋은 반드시 순차 실행
-
-#### 3. 분석 후 순차 커밋
-
-```typescript
-// 1단계: 병렬 분석
-Task({ subagent_type: 'explore', prompt: '파일 변경 범위 파악' })
-Task({ subagent_type: 'code-reviewer', prompt: '코드 품질 검토' })
-
-// 2단계: 순차 커밋 (병렬 분석 완료 대기 후)
-Task({
-  subagent_type: 'git-operator',
-  description: '전체 커밋 및 푸시',
-  prompt: '분석 결과 기반 논리적 단위 커밋'
-})
-```
-
----
-
-### Model Routing
-
-| 복잡도 | 조건 | 권장 모델 | 예시 |
-|--------|------|----------|------|
-| **LOW** | 1-2개 파일, 단순 변경 | haiku | 오타 수정, 문서 업데이트 |
-| **MEDIUM** | 여러 파일, 로직 추가 | haiku/sonnet | 기능 추가, 버그 수정 |
-| **HIGH** | 아키텍처 변경, 다중 모듈 | sonnet | 리팩토링, 구조 변경 |
-
-```typescript
-// ✅ 복잡도별 모델 선택
-// LOW: 단순 변경
-Task({ subagent_type: 'git-operator', model: 'haiku', ... })
-
-// MEDIUM: 일반 커밋
-Task({ subagent_type: 'git-operator', model: 'sonnet', ... })
-
-// HIGH: 복잡한 변경 + 검토
-Task({ subagent_type: 'code-reviewer', model: 'sonnet', ... })
-Task({ subagent_type: 'git-operator', model: 'sonnet', ... })
-```
-
----
-
-### Practical Examples
-
-#### ✅ 올바른 병렬 실행
-
-```typescript
-// 검토 + 탐색 병렬 → 커밋 순차
-Task({
-  subagent_type: 'code-reviewer',
-  model: 'sonnet',
-  prompt: '변경된 코드 품질 검토'
-})
-
-Task({
-  subagent_type: 'explore',
-  model: 'haiku',
-  prompt: '변경 파일 영향도 분석'
-})
-
-// 병렬 작업 완료 후 실행
-Task({
-  subagent_type: 'git-operator',
-  description: '모든 변경사항 커밋 후 푸시',
-  prompt: '검토 결과 반영하여 전체 커밋'
-})
-```
-
-#### ❌ 잘못된 병렬 실행
-
-```typescript
-// ❌ 여러 커밋을 병렬로 실행 (충돌 위험)
-Task({ subagent_type: 'git-operator', prompt: '커밋 1' })
-Task({ subagent_type: 'git-operator', prompt: '커밋 2' })
-Task({ subagent_type: 'git-operator', prompt: '커밋 3' })
-
-// ❌ 동일 저장소에 병렬 푸시
-Task({ subagent_type: 'git-operator', prompt: '푸시 1' })
-Task({ subagent_type: 'git-operator', prompt: '푸시 2' })
-```
-
----
-
-### 핵심 원칙
-
-| 작업 유형 | 실행 방식 | 이유 |
-|-----------|----------|------|
-| **분석/검토** | 병렬 가능 | 읽기 전용 작업, 충돌 없음 |
-| **Git 커밋/푸시** | 순차 필수 | 저장소 상태 변경, 충돌 위험 |
-| **다중 저장소** | 병렬 가능 | 독립적인 저장소 |
-
-```typescript
-// ✅ 권장 패턴
-// 1. 병렬 분석
-const analysisPromises = [
-  Task({ subagent_type: 'explore', ... }),
-  Task({ subagent_type: 'code-reviewer', ... })
-]
-
-// 2. 분석 완료 대기 후 순차 커밋
-Task({ subagent_type: 'git-operator', ... })
-```
-
-</parallel_agent_execution>

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>