@kood/claude-code 0.2.4 → 0.3.0

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

@@ -1,83 +1,29 @@
 ---
 description: 모든 변경사항 커밋 후 푸시
-allowed-tools: Bash(git:*)
 ---
 
-모든 변경사항을 논리적 단위로 분리하여 전부 커밋 후 푸시.
+# Git All Command
 
-## 실행 흐름
+@git-operator 에이전트를 사용하여 모든 변경사항을 커밋하고 푸시.
 
-```
-1. git status + git diff (병렬 실행)
-2. 논리적 단위로 분리하여 git add + git commit (반복)
-3. git status (완료 확인 - 남은 변경 없어야 함)
-4. git push
-```
+<mode>
 
-## 병렬 실행
+**전체 커밋 모드**
 
-**초기 분석 단계에서 병렬 실행 필수:**
+- **모든 변경사항**을 논리적 단위로 분리하여 **전부 커밋**
+- **반드시 푸시** (git push)
+- **남은 변경사항 없음** (clean working directory) 확인 필수
 
-```bash
-# 동시에 실행 (두 Bash 호출을 하나의 응답에서)
-git status
-git diff
-```
+</mode>
 
-## CRITICAL: 절대 금지
-
-| 금지 항목 |
-|----------|
-| "Generated with Claude Code" 포함 |
-| "🤖" 또는 AI 관련 이모지 |
-| "Co-Authored-By:" 헤더 |
-| AI/봇 작성 표시 일체 |
-| 여러 줄 커밋 메시지 |
-| 커밋 메시지에 마침표(.) |
-| 여러 작업 하나로 퉁치기 |
-| 변경사항 남겨두기 |
-
-## 커밋 규칙
-
-**형식**: `<prefix>: <설명>` (한 줄, 본문/푸터 없음)
-
-**핵심 원칙**: 하나의 커밋 = 하나의 논리적 변경
-
-### Prefix
-
-| Prefix | 용도 |
-|--------|------|
-| feat | 새 기능 |
-| fix | 버그 수정 |
-| refactor | 리팩토링 |
-| style | 코드 스타일 |
-| docs | 문서 수정 |
-| test | 테스트 |
-| chore | 빌드/설정 |
-| perf | 성능 개선 |
-| ci | CI/CD |
-
-### 분리 기준
-
-| 분리 필요 | 묶어도 됨 |
-|----------|----------|
-| 서로 다른 기능 | 동일 기능의 관련 파일들 |
-| 버그 수정 + 새 기능 | 동일 기능의 타입 + 구현 |
-| 코드 변경 + 문서 변경 | |
-| 리팩토링 + 기능 추가 | |
+---
 
-## 예시
+<workflow>
 
-```bash
-# ✅ 올바른
-feat: 사용자 로그인 기능 추가
-fix: 세션 만료 오류 수정
-refactor: 서비스 클래스 구조 개선
+1. 모든 변경사항 분석
+2. 논리적 단위로 그룹핑
+3. 각 그룹별 커밋 (반복)
+4. clean working directory 확인
+5. git push 실행
 
-# ❌ 잘못된
-사용자 인증 기능 추가함     # prefix 없음
-feat: 사용자 인증 추가.     # 마침표
-FEAT: 사용자 인증 추가      # 대문자
-feat(auth): 인증 추가       # scope 불필요
-feat: 로그인, 회원가입, 프로필  # 여러 작업 퉁침
-```
+</workflow>

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

@@ -1,91 +1,59 @@
 ---
 description: 현재 세션에서 수정한 파일만 커밋 후 푸시
-allowed-tools: Bash(git:*)
 ---
 
-이 세션에서 수정한 파일만 논리적 단위로 분리하여 커밋 후 푸시.
+# Git Session Command
 
-## 실행 흐름
+@git-operator 에이전트를 사용하여 현재 세션 파일만 선택적으로 커밋하고 푸시.
 
-```
-1. git status + git diff (병렬 실행)
-2. 대화 맥락에서 이 세션에 수정한 파일 목록 파악
-3. 해당 파일만 논리적 단위로 git add + git commit (반복)
-4. git status (완료 확인)
-5. git push
-```
+<mode>
 
-## 세션 파일 판별
+**세션 커밋 모드**
 
-**대화 맥락에서 Edit/Write 도구로 수정한 파일만 대상**
+- **현재 세션 관련 파일만** 선택적 커밋
+- **반드시 푸시** (git push)
 
-- 이 세션에서 직접 수정하지 않은 파일은 절대 stage하지 않음
-- 다른 변경사항은 unstaged 상태로 유지
+</mode>
 
-## 병렬 실행
-
-**초기 분석 단계에서 병렬 실행 필수:**
+---
 
-```bash
-# 동시에 실행 (두 Bash 호출을 하나의 응답에서)
-git status
-git diff
-```
+<selection_criteria>
 
-## CRITICAL: 절대 금지
+| 포함 | 제외 |
+|------|------|
+| 현재 세션 관련 파일 | 이전 세션의 미완성 작업 |
+| 방금 전 작업한 파일 | 자동 생성 파일 (lock, cache) |
+| 관련 기능의 파일들 | 무관한 변경사항 |
 
-| 금지 항목 |
-|----------|
-| "Generated with Claude Code" 포함 |
-| "🤖" 또는 AI 관련 이모지 |
-| "Co-Authored-By:" 헤더 |
-| AI/봇 작성 표시 일체 |
-| 여러 줄 커밋 메시지 |
-| 커밋 메시지에 마침표(.) |
-| 여러 작업 하나로 퉁치기 |
-| 세션에서 수정하지 않은 파일 커밋 |
+</selection_criteria>
 
-## 커밋 규칙
+---
 
-**형식**: `<prefix>: <설명>` (한 줄, 본문/푸터 없음)
+<workflow>
 
-**핵심 원칙**: 하나의 커밋 = 하나의 논리적 변경
+1. 모든 변경사항 분석
+2. **현재 세션 관련 파일만 선택**
+3. 논리적 단위로 그룹핑
+4. 각 그룹별 커밋
+5. git push 실행
 
-### Prefix
+</workflow>
 
-| Prefix | 용도 |
-|--------|------|
-| feat | 새 기능 |
-| fix | 버그 수정 |
-| refactor | 리팩토링 |
-| style | 코드 스타일 |
-| docs | 문서 수정 |
-| test | 테스트 |
-| chore | 빌드/설정 |
-| perf | 성능 개선 |
-| ci | CI/CD |
+---
 
-### 분리 기준
+<example>
 
-| 분리 필요 | 묶어도 됨 |
-|----------|----------|
-| 서로 다른 기능 | 동일 기능의 관련 파일들 |
-| 버그 수정 + 새 기능 | 동일 기능의 타입 + 구현 |
-| 코드 변경 + 문서 변경 | |
-| 리팩토링 + 기능 추가 | |
+```bash
+# 상황: 로그인 기능 작업 중, 이전 프로필 기능은 미완성
 
-## 예시
+git status
+# modified: src/auth/login.ts (현재 세션)
+# modified: src/auth/logout.ts (현재 세션)
+# modified: src/profile/edit.ts (이전 세션)
 
-```bash
-# ✅ 올바른
-feat: 사용자 로그인 기능 추가
-fix: 세션 만료 오류 수정
-refactor: 서비스 클래스 구조 개선
-
-# ❌ 잘못된
-사용자 인증 기능 추가함     # prefix 없음
-feat: 사용자 인증 추가.     # 마침표
-FEAT: 사용자 인증 추가      # 대문자
-feat(auth): 인증 추가       # scope 불필요
-feat: 로그인, 회원가입, 프로필  # 여러 작업 퉁침
+# ✅ 로그인 관련만 커밋
+git add src/auth/login.ts src/auth/logout.ts && git commit -m "feat: 로그인/로그아웃 기능 추가"
+git push
 ```
+
+</example>

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

@@ -1,86 +1,37 @@
 ---
 description: Git 상태 확인 및 커밋 작업
-allowed-tools: Bash(git:*)
 argument-hint: [push|pull|커밋 지시사항...]
 ---
 
-Git 상태 확인 후 아래 규칙에 따라 작업 진행.
+# Git Command
 
-**지시사항**: $ARGUMENTS
+@git-operator 에이전트를 사용하여 Git 작업 수행.
 
-## 실행 흐름
+<mode>
 
-```
-$ARGUMENTS 있음 → 해당 지시 우선 수행
-$ARGUMENTS 없음 → 기본 동작:
-  1. git status + git diff (병렬 실행)
-  2. 논리적 단위로 분리하여 git add + git commit
-  3. git status (완료 확인)
-```
+**기본 모드**: 선택적 커밋
 
-## 병렬 실행
+- 일부 변경사항만 커밋 가능
+- 푸시는 선택적 (명시 시에만)
 
-**초기 분석 단계에서 병렬 실행 필수:**
+</mode>
 
-```bash
-# 동시에 실행 (두 Bash 호출을 하나의 응답에서)
-git status
-git diff
-```
-
-## CRITICAL: 절대 금지
-
-| 금지 항목 |
-|----------|
-| "Generated with Claude Code" 포함 |
-| "🤖" 또는 AI 관련 이모지 |
-| "Co-Authored-By:" 헤더 |
-| AI/봇 작성 표시 일체 |
-| 여러 줄 커밋 메시지 |
-| 커밋 메시지에 마침표(.) |
-| 여러 작업 하나로 퉁치기 |
-
-## 커밋 규칙
-
-**형식**: `<prefix>: <설명>` (한 줄, 본문/푸터 없음)
-
-**핵심 원칙**: 하나의 커밋 = 하나의 논리적 변경
-
-### Prefix
+---
 
-| Prefix | 용도 |
-|--------|------|
-| feat | 새 기능 |
-| fix | 버그 수정 |
-| refactor | 리팩토링 |
-| style | 코드 스타일 |
-| docs | 문서 수정 |
-| test | 테스트 |
-| chore | 빌드/설정 |
-| perf | 성능 개선 |
-| ci | CI/CD |
+<arguments>
 
-### 분리 기준
+**$ARGUMENTS 있음**: 해당 지시사항 우선 수행
 
-| 분리 필요 | 묶어도 됨 |
-|----------|----------|
-| 서로 다른 기능 | 동일 기능의 관련 파일들 |
-| 버그 수정 + 새 기능 | 동일 기능의 타입 + 구현 |
-| 코드 변경 + 문서 변경 | |
-| 리팩토링 + 기능 추가 | |
+| 예시 | 동작 |
+|------|------|
+| `push` | 커밋 후 푸시 |
+| `pull` | git pull 먼저 실행 |
+| `로그인 기능만` | 해당 파일만 커밋 |
 
-## 예시
+**$ARGUMENTS 없음**: 기본 동작
 
-```bash
-# ✅ 올바른
-feat: 사용자 로그인 기능 추가
-fix: 세션 만료 오류 수정
-refactor: 서비스 클래스 구조 개선
+1. git status, git diff 분석
+2. 논리적 단위로 그룹핑
+3. 선택적 커밋
 
-# ❌ 잘못된
-사용자 인증 기능 추가함     # prefix 없음
-feat: 사용자 인증 추가.     # 마침표
-FEAT: 사용자 인증 추가      # 대문자
-feat(auth): 인증 추가       # scope 불필요
-feat: 로그인, 회원가입, 프로필  # 여러 작업 퉁침
-```
+</arguments>

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

@@ -6,103 +6,186 @@ argument-hint: [파일/디렉토리 경로...]
 
 # Lint Fix Command
 
-tsc와 eslint 오류를 검사하고 하나씩 꼼꼼히 수정하는 커맨드.
+> tsc/eslint 오류를 Sequential Thinking으로 분석하여 하나씩 수정
 
-## CRITICAL: 필수 요구사항
+---
+
+<forbidden>
+
+| 분류 | 금지 |
+|------|------|
+| **회피** | `any` 타입, `@ts-ignore`, `eslint-disable` 남발 |
+| **전략** | 여러 오류 동시 수정, 오류 메시지만 보고 급하게 수정 |
+| **분석** | Sequential Thinking 없이 수정 |
+
+</forbidden>
 
-| 요구사항 | 설명 |
-|----------|------|
-| **Ultrathink** | 깊은 사고로 오류 분석. 급하게 수정하지 않음 |
-| **Sequential Thinking** | `mcp__sequential-thinking__sequentialthinking` 도구 필수 사용 |
-| **하나씩 수정** | 한 번에 하나의 오류만 집중. 여러 오류 동시 수정 금지 |
+---
+
+<agent_usage>
+
+## @lint-fixer Agent 활용
 
-## 실행 흐름
+**언제 사용:**
+- 10개 이상 오류
+- 복잡한 타입 오류 다수
+- 백그라운드에서 자동 수정 원할 때
 
+**호출 방법:**
+```bash
+@lint-fixer
+# 또는 자연어
+"lint 오류 자동으로 수정해줘"
 ```
-1. tsc --noEmit 실행 → 타입 오류 수집
-2. eslint 실행 → 린트 오류 수집
-3. 오류 목록 정리 → TodoWrite로 추적
-4. 각 오류마다:
-   a. Sequential Thinking으로 원인 분석 (최소 3단계)
-   b. 오류의 근본 원인 파악
-   c. 안전한 수정 방안 도출
-   d. 수정 적용
-   e. 수정 후 해당 파일 재검사
-5. 모든 오류 수정 완료 후 전체 재검사
+
+**장점:**
+- 간단한 오류는 즉시 수정 (Sequential Thinking 불필요)
+- 복잡한 오류만 Sequential Thinking 사용 (효율적)
+- 독립적 context에서 실행 (메인 작업 병렬 가능)
+
+**직접 수정 vs Agent:**
+
+| 상황 | 권장 방법 |
+|------|----------|
+| 1-5개 오류, 간단 | 직접 수정 (command) |
+| 10개 이상 오류 | @lint-fixer |
+| 복잡한 타입 오류 다수 | @lint-fixer |
+| 빠른 수정 필요 | 직접 수정 |
+| 백그라운드 실행 | @lint-fixer |
+
+</agent_usage>
+
+---
+
+<required>
+
+| 분류 | 필수 |
+|------|------|
+| **Thinking** | Sequential Thinking 3-5단계 (각 오류마다) |
+| **Tracking** | TodoWrite로 오류 목록 추적 |
+| **Strategy** | 하나씩 수정 → 재검사 → 다음 오류 |
+| **Validation** | 각 파일 수정 후 해당 파일 재검사 |
+| **Parallel** | 5개 이상 독립 오류 → Task 도구로 병렬 분석 |
+
+</required>
+
+---
+
+<workflow>
+
+1. **검사**
+   ```bash
+   npx tsc --noEmit
+   npx eslint .
+   ```
+
+2. **TodoWrite 생성**
+   - 오류 목록 정리
+
+3. **순차 수정** (각 오류마다)
+   - Sequential Thinking 3-5단계
+   - 수정 적용
+   - 해당 파일 재검사
+   - TodoWrite 업데이트 (completed)
+
+4. **전체 재검사**
+
+</workflow>
+
+---
+
+<sequential_thinking>
+
+**각 오류마다 필수:**
+
+| 단계 | 내용 |
+|------|------|
+| 1 | 오류 메시지 분석 및 이해 |
+| 2 | 관련 코드 컨텍스트 파악 |
+| 3 | 근본 원인 식별 |
+| 4 | 수정 방안 검토 (여러 옵션 고려) |
+| 5 | 최적 수정 방안 선택 및 적용 |
+
+**파라미터:**
+
+```typescript
+{
+  thought: "현재 사고 내용",
+  nextThoughtNeeded: true | false,
+  thoughtNumber: 1, // 현재 단계
+  totalThoughts: 5  // 예상 총 단계 (동적 조정 가능)
+}
 ```
 
-## Sequential Thinking 사용법
+</sequential_thinking>
 
-**각 오류마다 반드시 Sequential Thinking 실행:**
+---
+
+<parallel_strategy>
+
+**5개 이상 오류 시:**
 
 ```
-오류 분석 시:
-- thoughtNumber: 1 → 오류 메시지 분석 및 이해
-- thoughtNumber: 2 → 관련 코드 컨텍스트 파악
-- thoughtNumber: 3 → 근본 원인 식별
-- thoughtNumber: 4 → 수정 방안 검토 (여러 옵션 고려)
-- thoughtNumber: 5 → 최적 수정 방안 선택 및 적용
+1. 독립적 오류 그룹 식별
+2. Task 도구로 병렬 분석 (단일 메시지에 다중 Task 호출)
+3. 분석 결과 취합 후 순차 수정
 ```
 
-**Sequential Thinking 파라미터:**
+**규칙:**
 
-| 파라미터 | 설명 |
-|----------|------|
-| `thought` | 현재 사고 내용 |
-| `nextThoughtNeeded` | 추가 분석 필요 여부 |
-| `thoughtNumber` | 현재 단계 번호 |
-| `totalThoughts` | 예상 총 단계 (동적 조정 가능) |
+| 규칙 | 설명 |
+|------|------|
+| 독립성 확인 | 같은 파일/연관 타입 → 순차 처리 |
+| 분석만 병렬 | 수정 적용은 항상 순차 |
+| 결과 검증 | 충돌 시 Sequential Thinking으로 해결 |
+
+**subagent_type:**
+
+| 유형 | 용도 |
+|------|------|
+| `Explore` | 오류 관련 코드 컨텍스트 탐색 |
+| `general-purpose` | 복잡한 타입 오류 심층 분석 |
+
+</parallel_strategy>
+
+---
+
+<commands>
 
-## 오류 검사 명령어
+**검사:**
 
-**타입 검사 (tsc):**
 ```bash
-# npm/yarn/pnpm 프로젝트
+# TypeScript (전체)
 npx tsc --noEmit
 
-# 특정 파일만
+# TypeScript (특정 파일)
 npx tsc --noEmit $ARGUMENTS
-```
 
-**린트 검사 (eslint):**
-```bash
-# 전체 프로젝트
+# ESLint (전체)
 npx eslint .
 
-# 특정 파일/디렉토리
+# ESLint (특정 파일/디렉토리)
 npx eslint $ARGUMENTS
 ```
 
-## 수정 원칙
-
-### DO
+**인수 처리:**
 
-- 오류 메시지를 정확히 이해
-- 관련 코드 전체를 파악
-- 타입 정의, 인터페이스 확인
-- 수정 전후 비교 분석
-- 수정이 다른 곳에 영향 주는지 확인
-
-### DON'T
+| 인수 | 동작 |
+|------|------|
+| 없음 | 전체 프로젝트 검사 |
+| 파일 경로 | 해당 파일만 |
+| 디렉토리 | 해당 디렉토리만 |
 
-- 오류 메시지만 보고 급하게 수정
-- `any` 타입으로 회피
-- `// @ts-ignore` 추가
-- `eslint-disable` 남용
-- 여러 오류 한 번에 수정
+</commands>
 
-## 오류 우선순위
+---
 
-| 우선순위 | 유형 |
-|----------|------|
-| 1 | 타입 오류 (컴파일 차단) |
-| 2 | 린트 오류 (error 레벨) |
-| 3 | 린트 경고 (warning 레벨) |
+<examples>
 
-## 예시 워크플로우
+**Example 1: Sequential Thinking 워크플로우**
 
 ```
-1. "npx tsc --noEmit" 실행
+1. npx tsc --noEmit 실행
    → TS2322: Type 'string' is not assignable to type 'number'
 
 2. Sequential Thinking 시작:
@@ -114,57 +197,31 @@ npx eslint $ARGUMENTS
 
 3. Edit으로 수정 적용
 
-4. 해당 파일 재검사
-   → 오류 해결 확인
+4. npx tsc --noEmit $FILE 재검사 → 해결 확인
 
-5. 다음 오류로 이동
+5. TodoWrite 업데이트 (completed) → 다음 오류
 ```
 
-## 병렬 처리 전략
-
-**다수 오류 발견 시 Task 도구로 병렬 분석:**
+**Example 2: 병렬 처리 (5개 이상 오류)**
 
 ```
-오류가 5개 이상일 때:
-1. 오류 목록 수집 후 독립적인 오류 그룹 식별
-2. Task 도구로 각 파일/오류 그룹을 병렬 분석
-3. 분석 결과 취합 후 순차적으로 수정 적용
-```
+독립적 파일 3개의 오류 발견:
 
-**Task 도구 활용 예시:**
-
-```
-# 독립적인 파일들의 오류를 병렬로 분석
-Task 1: "src/utils/api.ts의 TS2322 오류 분석 - 타입 불일치 원인과 수정 방안 제시"
-Task 2: "src/components/Form.tsx의 ESLint no-unused-vars 분석 - 사용되지 않는 변수 식별"
-Task 3: "src/hooks/useAuth.ts의 TS2532 오류 분석 - undefined 체크 필요 위치 파악"
+Task 1: "src/utils/api.ts의 TS2322 분석 - 타입 불일치 원인과 수정 방안"
+Task 2: "src/components/Form.tsx의 ESLint no-unused-vars 분석"
+Task 3: "src/hooks/useAuth.ts의 TS2532 분석 - undefined 체크 위치"
 
-→ 3개 Task 병렬 실행 (단일 메시지에 다중 Task 호출)
+→ 3개 Task 병렬 실행 (단일 메시지)
 → 결과 취합 후 Sequential Thinking으로 수정 순서 결정
-→ 순차적으로 수정 적용
+→ 순차 수정 적용
 ```
 
-**병렬 처리 규칙:**
-
-| 규칙 | 설명 |
-|------|------|
-| 독립성 확인 | 같은 파일/연관 타입의 오류는 순차 처리 |
-| 분석만 병렬 | 수정 적용은 항상 순차적으로 |
-| 결과 검증 | 병렬 분석 결과 충돌 시 Sequential Thinking으로 해결 |
-
-**subagent_type 선택:**
+**Example 3: 우선순위**
 
-| 유형 | 용도 |
-|------|------|
-| `Explore` | 오류 관련 코드 컨텍스트 탐색 |
-| `general-purpose` | 복잡한 타입 오류 심층 분석 |
-
-## 인수 처리
-
-| 인수 | 동작 |
-|------|------|
-| 없음 | 전체 프로젝트 검사 |
-| 파일 경로 | 해당 파일만 검사 |
-| 디렉토리 | 해당 디렉토리만 검사 |
+| 우선순위 | 유형 | 예시 |
+|----------|------|------|
+| 1 | 타입 오류 (컴파일 차단) | TS2322, TS2345 |
+| 2 | 린트 오류 (error 레벨) | no-unused-vars |
+| 3 | 린트 경고 (warning 레벨) | prefer-const |
 
-**인수**: $ARGUMENTS
+</examples>