@kood/claude-code 0.7.10 → 0.7.12

package/templates/.claude/agents/codex.md

@@ -1,28 +1,21 @@
 ---
 name: codex
 description: OpenAI Codex MCP 연동 에이전트. 꼼꼼한 구현, 코드 리뷰, 엣지케이스 검증 담당. Agent Teams에서 Team Lead 역할 우선.
-tools: Read, Write, Edit, Grep, Glob, Bash, mcp__codex__codex, mcp__codex__review
+tools: Read, Write, Edit, Grep, Glob, Bash, mcp__codex__codex, mcp__codex__codex_reply, mcp__codex__codex_review
 model: sonnet
 permissionMode: default
 maxTurns: 50
 ---
 
-@../../instructions/agent-patterns/parallel-execution.md
-@../../instructions/agent-patterns/read-parallelization.md
 @../../instructions/agent-patterns/agent-teams-usage.md
 @../../instructions/validation/forbidden-patterns.md
 @../../instructions/validation/required-behaviors.md
 
 # Codex Agent
 
-OpenAI Codex MCP를 통해 Claude와 페어 프로그래밍하는 에이전트.
+codex-mcp로 Codex CLI 호출. Claude와 페어 프로그래밍.
 
-**역할:**
-- **Agent Teams Team Lead** (기본)
-- 꼼꼼한 코드 구현 (엣지케이스, 타입 안정성)
-- 코드 리뷰 (버그, 보안, 성능)
-- 테스트 작성 및 검증
-- Claude 설계 구현 및 검증
+**역할:** Agent Teams **Team Lead**, 구현, 리뷰, 테스트
 
 ---
 
@@ -30,42 +23,19 @@ OpenAI Codex MCP를 통해 Claude와 페어 프로그래밍하는 에이전트.
 
 ## Team Lead 역할
 
-> **Agent Teams 모드에서 Codex가 Team Lead를 맡는 것이 기본**
-
 | 역할 | 이유 |
 |------|------|
-| **태스크 분해** | 꼼꼼한 작업 분할, 누락 방지 |
-| **품질 게이트** | 코드 품질/테스트 통과 검증 |
-| **진행 관리** | 팀원 진척 추적, 병목 감지 |
-| **충돌 조율** | 파일 충돌 사전 방지 |
-
-### Team Lead 워크플로우
+| 태스크 분해 | 꼼꼼한 분할 |
+| 품질 게이트 | 코드/테스트 검증 |
+| 충돌 조율 | 파일 충돌 방지 |
 
 ```typescript
-// 1. 팀 생성 (Codex Lead)
-TeamCreate({
-  team_name: "project-team",
-  description: "작업 설명",
-  agent_type: "codex"
-})
-
-// 2. Claude 팀원 스폰
-Task({
-  subagent_type: 'implementation-executor',
-  team_name: 'project-team',
-  name: 'claude-impl',
-  prompt: '창의적 설계 + 구현'
-})
-
-// 3. 태스크 관리
-TaskCreate({ subject: "API 구현", ... })
-TaskUpdate({ id: "task-1", status: "completed" })
-
-// 4. 품질 검증
-mcp__codex__review({ target: "uncommitted" })
-
-// 5. 팀 정리
-SendMessage({ type: 'shutdown_request', recipient: 'claude-impl' })
+TeamCreate({ team_name: "project", agent_type: "codex" })
+Task({ subagent_type: 'implementation-executor', team_name: 'project', name: 'impl', prompt: '...' })
+// 품질 검증
+mcp__codex__codex_review({ uncommitted: true })
+// 정리
+SendMessage({ type: 'shutdown_request', recipient: 'impl' })
 TeamDelete()
 ```
 
@@ -73,53 +43,28 @@ TeamDelete()
 
 ---
 
-<codex_mcp_usage>
+<tools>
 
-## Codex MCP 도구 사용
+## MCP 도구
 
-### 코드 생성/수정
+| 도구 | 용도 |
+|------|------|
+| `codex` | 새 태스크 (세션 생성) |
+| `codex_reply` | 멀티턴 대화 |
+| `codex_review` | 코드 리뷰 (uncommitted/branch/commit) |
 
 ```typescript
-mcp__codex__codex({
-  prompt: `
-    구현 요구사항:
-    - [상세 요구사항]
-
-    품질 기준:
-    - 모든 엣지케이스 처리
-    - 타입 안정성 보장
-    - 에러 핸들링 포함
-  `,
-  working_directory: "/path/to/project"
-})
-```
+// 구현
+const r = mcp__codex__codex({ prompt: "기능 구현", working_directory: cwd })
 
-### 코드 리뷰
+// 후속 작업
+mcp__codex__codex_reply({ thread_id: r.thread_id, prompt: "테스트 추가" })
 
-```typescript
-mcp__codex__review({
-  target: "uncommitted",  // 또는 "branch:feature", "commit:abc123"
-  focus: ["security", "performance", "bugs", "edge-cases"]
-})
+// 리뷰
+mcp__codex__codex_review({ uncommitted: true })
 ```
 
-</codex_mcp_usage>
-
----
-
-<strengths>
-
-## 강점 영역
-
-| 영역 | 활용 |
-|------|------|
-| **정밀 구현** | 복잡한 알고리즘, 비즈니스 로직 |
-| **엣지케이스** | null, undefined, 빈 배열, 경계값 |
-| **코드 리뷰** | 버그, 보안 취약점, 성능 이슈 |
-| **테스트** | 단위 테스트, 통합 테스트, 엣지케이스 테스트 |
-| **디버깅** | 버그 원인 분석, 재현, 수정 |
-
-</strengths>
+</tools>
 
 ---
 
@@ -127,207 +72,32 @@ mcp__codex__review({
 
 ## 작업 흐름
 
-### 1. 구현 작업
-
-```bash
-# 요구사항 분석
-Read: 관련 파일 파악
-
-# Codex MCP로 구현
-mcp__codex__codex:
-  prompt: "구현 요구사항 + 품질 기준"
-
-# 결과 검증
-Bash: npm test
-Read: 생성된 코드 확인
-
-# 필요 시 수정
-Edit: 미세 조정
-```
-
-### 2. 리뷰 작업
-
-```bash
-# 변경사항 확인
-Bash: git diff
+**구현:** Read → codex → Bash(테스트) → Edit(미세 조정)
 
-# Codex 리뷰
-mcp__codex__review:
-  target: "uncommitted"
-  focus: ["security", "bugs", "edge-cases"]
-
-# 리뷰 결과 정리
-→ 치명적/경고/제안 분류
-→ 구체적 수정 방법 제시
-```
-
-### 3. Claude 설계 구현
-
-```bash
-# Claude 설계 문서 확인
-Read: 설계 문서/인터페이스 정의
-
-# 설계 기반 구현
-mcp__codex__codex:
-  prompt: `
-    Claude 설계 기반 구현:
-    [설계 내용]
-
-    구현 요구사항:
-    - 인터페이스 준수
-    - 타입 안정성
-    - 테스트 포함
-  `
-
-# 구현 결과 검증
-Bash: npm run typecheck && npm test
-```
+**리뷰:** codex_review → 치명적/경고/제안 분류
 
 </workflow>
 
 ---
 
-<output_format>
-
-## 출력 형식
-
-### 구현 완료
-
-```markdown
-## 구현 완료
-
-**생성/수정 파일:**
-- src/auth/AuthService.ts (신규)
-- src/auth/TokenManager.ts (신규)
-- tests/auth.test.ts (신규)
-
-**주요 구현:**
-- JWT 토큰 생성/검증
-- 리프레시 토큰 로직
-- 에러 핸들링
-
-**엣지케이스 처리:**
-- 만료된 토큰 → 자동 갱신 시도
-- 잘못된 토큰 → 401 반환
-- 리프레시 토큰 만료 → 재로그인 유도
-
-**테스트 결과:**
-✅ 15 tests passed
-```
-
-### 리뷰 완료
-
-```markdown
-## 코드 리뷰 결과
-
-**검토 파일:**
-- src/api/users.ts
-- src/components/UserForm.tsx
+<rules>
 
-### 치명적 (필수 수정)
-
-#### 1. src/api/users.ts:15 - SQL Injection 취약점
-**문제:** 사용자 입력 직접 쿼리에 삽입
-**수정:** Prepared statement 사용
-```typescript
-// Before
-const query = `SELECT * FROM users WHERE id = ${userId}`
-
-// After
-const query = `SELECT * FROM users WHERE id = ?`
-await db.query(query, [userId])
-```
-
-### 경고 (권장)
-
-#### 2. src/components/UserForm.tsx:28 - Null 체크 누락
-...
-
-### 제안 (선택)
-...
-
-**요약:** 치명적 1개, 경고 2개, 제안 1개
-```
-
-</output_format>
-
----
-
-<collaboration>
-
-## Claude와 협업
-
-| 상황 | Codex 역할 |
-|------|------------|
-| **Claude 설계 후** | 설계 기반 구현, 엣지케이스 추가 |
-| **Claude 구현 후** | 코드 리뷰, 개선점 제안 |
-| **병렬 작업** | 백엔드/테스트/리뷰 담당 |
-| **의견 분기** | 꼼꼼한 관점에서 의견 제시 |
-
-### 협업 시 주의사항
-
-- Claude 설계 의도 존중
-- 변경 시 이유 명확히 설명
-- 충돌 발생 시 양쪽 장단점 제시
-- 최종 결정은 사용자에게 위임
-
-</collaboration>
-
----
-
-<forbidden>
-
-## 금지 사항
-
-| 분류 | 금지 |
+| 필수 | 금지 |
 |------|------|
-| **MCP** | MCP 없이 Codex 기능 시뮬레이션 |
-| **범위** | Claude 담당 영역 침범 |
-| **결정** | 충돌 시 임의 결정 (사용자 선택 유도) |
-| **검증** | 테스트 없이 구현 완료 선언 |
+| codex MCP 도구 사용 | MCP 없이 시뮬레이션 |
+| 구현 후 테스트 실행 | 테스트 없이 완료 |
+| 경계 조건 처리 | Claude 영역 침범 |
 
-</forbidden>
+</rules>
 
 ---
 
-<required>
-
-## 필수 사항
+<errors>
 
-| 분류 | 필수 |
+| 에러 | 대응 |
 |------|------|
-| **MCP** | mcp__codex__codex 또는 review 사용 |
-| **검증** | 구현 후 테스트/타입체크 실행 |
-| **엣지케이스** | 모든 경계 조건 처리 |
-| **출력** | 구조화된 결과 보고 |
-
-</required>
-
----
-
-<error_handling>
-
-## 에러 처리
-
-| 에러 | 원인 | 대응 |
-|------|------|------|
-| MCP 연결 실패 | Codex 서버 미설정 | 설정 안내 메시지 반환 |
-| API 타임아웃 | 네트워크/부하 | 재시도 (최대 2회) |
-| 구현 실패 | 요구사항 불명확 | 명확화 요청 |
-
-### MCP 미설정 시 응답
-
-```markdown
-## Codex MCP 연결 필요
-
-Codex MCP가 설정되지 않았습니다.
-
-**설정 방법:**
-```bash
-claude mcp add codex -- codex mcp-server
-```
-
-설정 후 다시 시도해주세요.
-```
+| 401 | `codex login` 안내 |
+| 세션 not found | 새 codex 세션 |
+| 동시 요청 | 이전 요청 완료 대기 |
 
-</error_handling>
+</errors>

package/templates/.claude/commands/cancel-ralph.md

@@ -0,0 +1,18 @@
+---
+description: "Cancel active Ralph Loop"
+allowed-tools: ["Bash(test -f .claude/ralph-loop.local.md:*)", "Bash(rm .claude/ralph-loop.local.md)", "Read(.claude/ralph-loop.local.md)"]
+hide-from-slash-command-tool: "true"
+---
+
+# Cancel Ralph
+
+To cancel the Ralph loop:
+
+1. Check if `.claude/ralph-loop.local.md` exists using Bash: `test -f .claude/ralph-loop.local.md && echo "EXISTS" || echo "NOT_FOUND"`
+
+2. **If NOT_FOUND**: Say "No active Ralph loop found."
+
+3. **If EXISTS**:
+   - Read `.claude/ralph-loop.local.md` to get the current iteration number from the `iteration:` field
+   - Remove the file using Bash: `rm .claude/ralph-loop.local.md`
+   - Report: "Cancelled Ralph loop (was at iteration N)" where N is the iteration value

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

@@ -14,11 +14,11 @@ description: 모든 변경사항 커밋 후 푸시
 
 | 스크립트 | 용도 |
 |----------|------|
-| `.claude/scripts/git/git-info.sh` | 상태 + diff 요약 출력 |
-| `.claude/scripts/git/git-commit.sh "msg" [files]` | Co-Authored-By 포함 커밋 |
-| `.claude/scripts/git/git-push.sh` | 안전한 푸시 |
-| `.claude/scripts/git/git-all.sh "msg"` | add all + commit + push (단순 케이스) |
-| `.claude/scripts/git/git-clean-check.sh` | clean 여부 확인 |
+| `${CLAUDE_SCRIPTS_ROOT}/git/git-info.sh` | 상태 + diff 요약 출력 |
+| `${CLAUDE_SCRIPTS_ROOT}/git/git-commit.sh "msg" [files]` | Co-Authored-By 포함 커밋 |
+| `${CLAUDE_SCRIPTS_ROOT}/git/git-push.sh` | 안전한 푸시 |
+| `${CLAUDE_SCRIPTS_ROOT}/git/git-all.sh "msg"` | add all + commit + push (단순 케이스) |
+| `${CLAUDE_SCRIPTS_ROOT}/git/git-clean-check.sh` | clean 여부 확인 |
 
 </scripts>
 
@@ -32,25 +32,25 @@ description: 모든 변경사항 커밋 후 푸시
 
 ```bash
 # 1. 상태 확인
-.claude/scripts/git/git-info.sh
+${CLAUDE_SCRIPTS_ROOT}/git/git-info.sh
 
 # 2. 모든 변경사항 커밋 + 푸시
-.claude/scripts/git/git-all.sh "feat: 기능 추가"
+${CLAUDE_SCRIPTS_ROOT}/git/git-all.sh "feat: 기능 추가"
 ```
 
 ### 복잡한 케이스 (논리적 분리 필요)
 
 ```bash
 # 1. 상태 확인
-.claude/scripts/git/git-info.sh
+${CLAUDE_SCRIPTS_ROOT}/git/git-info.sh
 
 # 2. 그룹별 커밋
-.claude/scripts/git/git-commit.sh "feat: A 기능" src/a.ts src/a.test.ts
-.claude/scripts/git/git-commit.sh "fix: B 버그 수정" src/b.ts
+${CLAUDE_SCRIPTS_ROOT}/git/git-commit.sh "feat: A 기능" src/a.ts src/a.test.ts
+${CLAUDE_SCRIPTS_ROOT}/git/git-commit.sh "fix: B 버그 수정" src/b.ts
 
 # 3. clean 확인 후 푸시
-.claude/scripts/git/git-clean-check.sh
-.claude/scripts/git/git-push.sh
+${CLAUDE_SCRIPTS_ROOT}/git/git-clean-check.sh
+${CLAUDE_SCRIPTS_ROOT}/git/git-push.sh
 ```
 
 </workflow>

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

@@ -0,0 +1,67 @@
+---
+description: 타겟 브랜치에 소스 브랜치를 merge 후 push
+argument-hint: <target-branch> <source-branch>
+---
+
+# Git Merge Command
+
+> 타겟 브랜치에 소스 브랜치를 merge하고 push.
+
+---
+
+<scripts>
+
+## 사용 가능한 스크립트
+
+| 스크립트 | 용도 |
+|----------|------|
+| `${CLAUDE_SCRIPTS_ROOT}/git/git-merge.sh <target> <source>` | checkout → merge → push → 원래 브랜치 복귀 |
+
+</scripts>
+
+---
+
+<workflow>
+
+## 워크플로우
+
+```bash
+# 인자에서 타겟/소스 브랜치 추출 후 실행
+${CLAUDE_SCRIPTS_ROOT}/git/git-merge.sh <target-branch> <source-branch>
+```
+
+**스크립트 동작:**
+1. Working directory clean 확인
+2. `git fetch origin`
+3. 타겟 브랜치 checkout + pull
+4. 소스 브랜치 merge (`--no-edit`)
+5. 타겟 브랜치 push
+6. 원래 브랜치로 복귀
+
+</workflow>
+
+---
+
+<examples>
+
+```bash
+# deploy/prod에 dev 머지
+${CLAUDE_SCRIPTS_ROOT}/git/git-merge.sh deploy/prod dev
+
+# main에 feature/auth 머지
+${CLAUDE_SCRIPTS_ROOT}/git/git-merge.sh main feature/auth
+```
+
+</examples>
+
+---
+
+<error_handling>
+
+| 상황 | 대응 |
+|------|------|
+| **Working directory dirty** | 커밋 또는 stash 후 재시도 안내 |
+| **Merge conflict** | 수동 해결 안내 (타겟 브랜치에 머물러 있음) |
+| **브랜치 미존재** | 에러 출력 후 종료 |
+
+</error_handling>

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

@@ -14,10 +14,10 @@ description: 현재 세션에서 수정한 파일만 커밋 후 푸시
 
 | 스크립트 | 용도 |
 |----------|------|
-| `.claude/scripts/git/git-info.sh` | 상태 + diff 요약 출력 |
-| `.claude/scripts/git/git-commit.sh "msg" [files]` | Co-Authored-By 포함 커밋 |
-| `.claude/scripts/git/git-push.sh` | 안전한 푸시 |
-| `.claude/scripts/git/git-clean-check.sh` | clean 여부 확인 |
+| `${CLAUDE_SCRIPTS_ROOT}/git/git-info.sh` | 상태 + diff 요약 출력 |
+| `${CLAUDE_SCRIPTS_ROOT}/git/git-commit.sh "msg" [files]` | Co-Authored-By 포함 커밋 |
+| `${CLAUDE_SCRIPTS_ROOT}/git/git-push.sh` | 안전한 푸시 |
+| `${CLAUDE_SCRIPTS_ROOT}/git/git-clean-check.sh` | clean 여부 확인 |
 
 </scripts>
 
@@ -29,13 +29,13 @@ description: 현재 세션에서 수정한 파일만 커밋 후 푸시
 
 ```bash
 # 1. 상태 확인
-.claude/scripts/git/git-info.sh
+${CLAUDE_SCRIPTS_ROOT}/git/git-info.sh
 
 # 2. 현재 세션 파일만 선택하여 커밋
-.claude/scripts/git/git-commit.sh "feat: 로그인 기능" src/auth/login.ts src/auth/logout.ts
+${CLAUDE_SCRIPTS_ROOT}/git/git-commit.sh "feat: 로그인 기능" src/auth/login.ts src/auth/logout.ts
 
 # 3. 푸시
-.claude/scripts/git/git-push.sh
+${CLAUDE_SCRIPTS_ROOT}/git/git-push.sh
 ```
 
 </workflow>
@@ -70,14 +70,14 @@ description: 현재 세션에서 수정한 파일만 커밋 후 푸시
 ```bash
 # 상황: 로그인 기능 작업 중, 이전 프로필 기능은 미완성
 
-.claude/scripts/git/git-info.sh
+${CLAUDE_SCRIPTS_ROOT}/git/git-info.sh
 # modified: src/auth/login.ts (현재 세션)
 # modified: src/auth/logout.ts (현재 세션)
 # modified: src/profile/edit.ts (이전 세션)
 
 # ✅ 로그인 관련만 커밋
-.claude/scripts/git/git-commit.sh "feat: 로그인/로그아웃 기능 추가" src/auth/login.ts src/auth/logout.ts
-.claude/scripts/git/git-push.sh
+${CLAUDE_SCRIPTS_ROOT}/git/git-commit.sh "feat: 로그인/로그아웃 기능 추가" src/auth/login.ts src/auth/logout.ts
+${CLAUDE_SCRIPTS_ROOT}/git/git-push.sh
 ```
 
 </example>

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

@@ -16,8 +16,8 @@ argument-hint: [파일/디렉토리 경로...]
 
 | 스크립트 | 용도 |
 |----------|------|
-| `.claude/scripts/lint/lint-check.sh` | tsc + eslint 병렬 검사 |
-| `.claude/scripts/lint/lint-file.sh [files]` | 특정 파일만 검사 |
+| `${CLAUDE_SCRIPTS_ROOT}/lint/lint-check.sh` | tsc + eslint 병렬 검사 |
+| `${CLAUDE_SCRIPTS_ROOT}/lint/lint-file.sh [files]` | 특정 파일만 검사 |
 
 </scripts>
 
@@ -31,17 +31,17 @@ argument-hint: [파일/디렉토리 경로...]
 
 ```bash
 # 1. 병렬 검사 (tsc + eslint 동시)
-.claude/scripts/lint/lint-check.sh
+${CLAUDE_SCRIPTS_ROOT}/lint/lint-check.sh
 
 # 2. 오류 수정 후 재검사
-.claude/scripts/lint/lint-check.sh
+${CLAUDE_SCRIPTS_ROOT}/lint/lint-check.sh
 ```
 
 ### 특정 파일 검사
 
 ```bash
 # 특정 파일만
-.claude/scripts/lint/lint-file.sh src/utils/api.ts src/components/Button.tsx
+${CLAUDE_SCRIPTS_ROOT}/lint/lint-file.sh src/utils/api.ts src/components/Button.tsx
 ```
 
 </workflow>

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

@@ -16,10 +16,10 @@ argument-hint: [파일/디렉토리 경로...]
 
 | 스크립트 | 용도 |
 |----------|------|
-| `.claude/scripts/deploy/deploy-check.sh` | 전체 검증 (tsc + eslint + build) |
-| `.claude/scripts/deploy/build-run.sh` | build만 실행 |
-| `.claude/scripts/lint/lint-check.sh` | tsc + eslint 병렬 검사 |
-| `.claude/scripts/pm/pm-detect.sh` | package manager 감지 |
+| `${CLAUDE_SCRIPTS_ROOT}/deploy/deploy-check.sh` | 전체 검증 (tsc + eslint + build) |
+| `${CLAUDE_SCRIPTS_ROOT}/deploy/build-run.sh` | build만 실행 |
+| `${CLAUDE_SCRIPTS_ROOT}/lint/lint-check.sh` | tsc + eslint 병렬 검사 |
+| `${CLAUDE_SCRIPTS_ROOT}/pm/pm-detect.sh` | package manager 감지 |
 
 </scripts>
 
@@ -33,17 +33,17 @@ argument-hint: [파일/디렉토리 경로...]
 
 ```bash
 # 한 번에 tsc + eslint + build 검증
-.claude/scripts/deploy/deploy-check.sh
+${CLAUDE_SCRIPTS_ROOT}/deploy/deploy-check.sh
 ```
 
 ### 단계별 검증
 
 ```bash
 # 1. lint 검사
-.claude/scripts/lint/lint-check.sh
+${CLAUDE_SCRIPTS_ROOT}/lint/lint-check.sh
 
 # 2. 오류 수정 후 build
-.claude/scripts/deploy/build-run.sh
+${CLAUDE_SCRIPTS_ROOT}/deploy/build-run.sh
 ```
 
 </workflow>

package/templates/.claude/commands/ralph-loop.md

@@ -0,0 +1,18 @@
+---
+description: "Start Ralph Loop in current session"
+argument-hint: "PROMPT [--max-iterations N] [--completion-promise TEXT]"
+allowed-tools: ["Bash(${CLAUDE_SCRIPTS_ROOT}/setup-ralph-loop.sh:*)"]
+hide-from-slash-command-tool: "true"
+---
+
+# Ralph Loop Command
+
+Execute the setup script to initialize the Ralph loop:
+
+```!
+"${CLAUDE_SCRIPTS_ROOT}/setup-ralph-loop.sh" $ARGUMENTS
+```
+
+Please work on the task. When you try to exit, the Ralph loop will feed the SAME PROMPT back to you for the next iteration. You'll see your previous work in files and git history, allowing you to iterate and improve.
+
+CRITICAL RULE: If a completion promise is set, you may ONLY output it when the statement is completely and unequivocally TRUE. Do not output false promises to escape the loop, even if you think you're stuck or should exit for other reasons. The loop is designed to continue until genuine completion.

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

@@ -18,10 +18,10 @@ argument-hint: <new-version | +1 | +minor | +major>
 
 | 스크립트 | 용도 |
 |----------|------|
-| `.claude/scripts/version/version-find.sh` | 버전 파일 탐색 (package.json + .version()) |
-| `.claude/scripts/version/version-bump.sh <current> <type>` | 새 버전 계산 |
-| `.claude/scripts/git/git-commit.sh "msg" [files]` | 커밋 |
-| `.claude/scripts/git/git-push.sh` | 푸시 |
+| `${CLAUDE_SCRIPTS_ROOT}/version/version-find.sh` | 버전 파일 탐색 (package.json + .version()) |
+| `${CLAUDE_SCRIPTS_ROOT}/version/version-bump.sh <current> <type>` | 새 버전 계산 |
+| `${CLAUDE_SCRIPTS_ROOT}/git/git-commit.sh "msg" [files]` | 커밋 |
+| `${CLAUDE_SCRIPTS_ROOT}/git/git-push.sh` | 푸시 |
 
 </scripts>
 
@@ -46,18 +46,18 @@ argument-hint: <new-version | +1 | +minor | +major>
 
 ```bash
 # 1. 버전 파일 탐색
-.claude/scripts/version/version-find.sh
+${CLAUDE_SCRIPTS_ROOT}/version/version-find.sh
 
 # 2. 현재 버전 확인 (package.json 읽기)
 
 # 3. 새 버전 계산
-.claude/scripts/version/version-bump.sh 1.2.3 +1
+${CLAUDE_SCRIPTS_ROOT}/version/version-bump.sh 1.2.3 +1
 # → 1.2.4
 
 # 4. 모든 파일 Edit로 업데이트
 
 # 5. 커밋
-.claude/scripts/git/git-commit.sh "chore: 버전 1.2.4로 업데이트" package.json packages/*/package.json
+${CLAUDE_SCRIPTS_ROOT}/git/git-commit.sh "chore: 버전 1.2.4로 업데이트" package.json packages/*/package.json
 ```
 
 </workflow>