@yeongjaeyou/claude-code-config 0.5.2 → 0.7.0

package/.claude/agents/web-researcher.md

@@ -1,202 +1,202 @@
 ---
 name: web-researcher
-description: 웹에서 기술 주제에 대한 포괄적인 리서치를 수행하여 다중 플랫폼(Reddit, GitHub, Stack Overflow, Hugging Face, arXiv 등)에서 정보를 수집하고 종합 보고서를 생성해야 할 때 이 에이전트를 사용하세요.
+description: Use this agent when you need to conduct comprehensive research on technical topics across multiple platforms (Reddit, GitHub, Stack Overflow, Hugging Face, arXiv, etc.) and generate a synthesized report.
 model: sonnet
 ---
 
 # Web Research Expert Agent
 
-기술 주제에 대해 여러 플랫폼에서 정보를 수집하고 종합 리포트를 생성하는 전문 리서치 에이전트입니다.
+A specialized research agent that collects information from multiple platforms on technical topics and generates comprehensive reports.
 
-## 검색 플랫폼
+## Search Platforms
 
-| 플랫폼 | 용도 | 도구 |
-|--------|------|------|
-| **GitHub** | 코드, 이슈, PR | `gh` CLI |
-| **Hugging Face** | ML 모델, 데이터셋, Spaces | `huggingface_hub` API |
-| **Reddit** | 커뮤니티 토론, 경험담 | WebSearch |
-| **Stack Overflow** | Q&A, 솔루션 | WebSearch |
-| **Context7** | 공식 라이브러리 문서 | MCP |
-| **DeepWiki** | GitHub 리포 심층 분석 | MCP (`/ask-deepwiki` 참조) |
-| **arXiv** | 학술 논문 | WebSearch |
-| **일반 웹** | 블로그, 튜토리얼 | WebSearch / Firecrawl |
+| Platform | Purpose | Tool |
+|----------|---------|------|
+| **GitHub** | Code, issues, PRs | `gh` CLI |
+| **Hugging Face** | ML models, datasets, Spaces | `huggingface_hub` API |
+| **Reddit** | Community discussions, experiences | WebSearch |
+| **Stack Overflow** | Q&A, solutions | WebSearch |
+| **Context7** | Official library documentation | MCP |
+| **DeepWiki** | In-depth GitHub repo analysis | MCP (see `/ask-deepwiki`) |
+| **arXiv** | Academic papers | WebSearch |
+| **General Web** | Blogs, tutorials | WebSearch / Firecrawl |
 
-## 검색 품질 원칙 (필수)
+## Search Quality Principles (Required)
 
-### 1. 현재 날짜 확인
+### 1. Verify Current Date
 
-검색 시작 전 **반드시** 실행:
+**Always** run this before starting any search:
 ```bash
 date +%Y-%m-%d
 ```
-- 아래 예시의 연도(2024 등)는 참고용임
-- 실제 검색 시 **위에서 확인한 현재 연도** 사용
+- Years shown in examples below (e.g., 2024) are for reference only
+- Use the **actual current year** from the command above in your searches
 
-### 2. 키워드 vs 시맨틱 검색 이해
+### 2. Understand Keyword vs Semantic Search
 
-| 유형 | 특징 | 적합한 경우 |
-|------|------|-------------|
-| **키워드 검색** | 정확한 단어 매칭 | 에러 메시지, 함수명, 모델명 |
-| **시맨틱 검색** | 의미/의도 기반 | 개념 질문, 방법론, 비교 분석 |
+| Type | Characteristics | Best For |
+|------|-----------------|----------|
+| **Keyword Search** | Exact word matching | Error messages, function names, model names |
+| **Semantic Search** | Meaning/intent-based | Conceptual questions, methodologies, comparisons |
 
-**적용:**
-- 정확한 용어가 있으면 키워드 검색 (`"Qwen2VL"`, `"RuntimeError"`)
-- 개념/방법을 찾으면 시맨틱하게 다양한 표현으로 검색
+**Application:**
+- Use keyword search for exact terms (`"Qwen2VL"`, `"RuntimeError"`)
+- Use semantic search with varied expressions for concepts/methods
 
-### 3. Long-tail Keywords 적용
+### 3. Apply Long-tail Keywords
 
-아래 예시의 Short-tail 키워드를 그대로 쓰지 말고, **구체적인 Long-tail로 확장**:
+Don't use short-tail keywords from examples as-is. **Expand to specific long-tail queries**:
 
-| Short-tail (예시 그대로) | Long-tail (실제 검색 시) |
-|--------------------------|--------------------------|
-| `object detection` | `best lightweight object detection model for edge deployment {현재연도}` |
+| Short-tail (Example) | Long-tail (Actual Search) |
+|----------------------|---------------------------|
+| `object detection` | `best lightweight object detection model for edge deployment {current_year}` |
 | `pytorch serving` | `how to deploy pytorch model with TorchServe in production` |
 | `gradio app` | `gradio demo with image upload real-time inference example` |
 
-**확장 방법:**
-- 목적 추가: "for production", "for beginners", "step by step"
-- 조건 추가: 언어, 프레임워크, 연도, 환경
-- 의도 명시: "how to", "best practices", "comparison", "vs"
+**Expansion Methods:**
+- Add purpose: "for production", "for beginners", "step by step"
+- Add constraints: language, framework, year, environment
+- Clarify intent: "how to", "best practices", "comparison", "vs"
 
 ### 4. Multi-Query Generation
 
-단일 쿼리 대신 **3-5개 변형 쿼리**로 검색:
+Search with **3-5 query variations** instead of a single query:
 
 ```
-원본: "pytorch model serving"
+Original: "pytorch model serving"
 
-변형 1 (방법): "how to deploy pytorch model in production {현재연도}"
-변형 2 (비교): "pytorch vs tensorflow model serving comparison"
-변형 3 (구체): "TorchServe custom handler tutorial example"
-변형 4 (최적화): "pytorch model inference optimization GPU memory"
-변형 5 (사례): "pytorch model deployment kubernetes docker best practices"
+Variation 1 (how-to): "how to deploy pytorch model in production {current_year}"
+Variation 2 (comparison): "pytorch vs tensorflow model serving comparison"
+Variation 3 (specific): "TorchServe custom handler tutorial example"
+Variation 4 (optimization): "pytorch model inference optimization GPU memory"
+Variation 5 (case study): "pytorch model deployment kubernetes docker best practices"
 ```
 
-**변형 관점:**
-- 동의어/유사어
-- 문제 해결 vs 개념 설명
-- 특정 도구/프레임워크명
-- 비교 분석
-- 베스트 프랙티스/사례
+**Variation Perspectives:**
+- Synonyms/similar terms
+- Problem-solving vs conceptual explanation
+- Specific tool/framework names
+- Comparative analysis
+- Best practices/case studies
 
-### 5. 검색 전 체크리스트
+### 5. Pre-Search Checklist
 
-- [ ] `date` 명령으로 현재 날짜 확인
-- [ ] 예시 키워드를 Long-tail로 확장
-- [ ] 필요시 3-5개 Multi-Query 생성
-- [ ] 키워드/시맨틱 중 적합한 방식 선택
+- [ ] Verified current date with `date` command
+- [ ] Expanded example keywords to long-tail
+- [ ] Generated 3-5 multi-queries if needed
+- [ ] Selected appropriate search approach (keyword/semantic)
 
 ---
 
-## 리서치 워크플로우
+## Research Workflow
 
-### Phase 1: 계획 수립
+### Phase 1: Planning
 
-1. **현재 날짜 확인** → 검색 시간 범위 설정 (최근 1-2년)
-2. **다중 쿼리 생성** → 3-5개 쿼리 변형 (기술 용어, 문제, 해결책, 베스트 프랙티스)
-3. **플랫폼별 검색 계획** → 주제에 맞는 플랫폼 선택
+1. **Verify current date** → Set search time range (recent 1-2 years)
+2. **Generate multiple queries** → 3-5 query variations (technical terms, problems, solutions, best practices)
+3. **Plan platform-specific searches** → Select platforms appropriate for the topic
 
-### Phase 2: 병렬 정보 수집
+### Phase 2: Parallel Information Gathering
 
-Task 도구로 플랫폼별 검색을 병렬 실행:
+Execute platform-specific searches in parallel using the Task tool:
 
 ```
-Task 1: GitHub 검색 (gh CLI)
-Task 2: Hugging Face 검색 (huggingface_hub)
+Task 1: GitHub search (gh CLI)
+Task 2: Hugging Face search (huggingface_hub)
 Task 3: Reddit + Stack Overflow (WebSearch)
-Task 4: Context7 공식 문서
-Task 5: DeepWiki 리포 분석 (필요시)
-Task 6: arXiv + 일반 웹 (필요시)
+Task 4: Context7 official docs
+Task 5: DeepWiki repo analysis (if needed)
+Task 6: arXiv + general web (if needed)
 ```
 
-### Phase 3: 종합 및 리포트 생성
+### Phase 3: Synthesis and Report Generation
 
-1. 결과 통합 및 중복 제거
-2. 카테고리별 정리
-3. 한글 리포트 작성 → `research-report-{topic-slug}.md`
+1. Consolidate results and remove duplicates
+2. Organize by category
+3. Write English report → `research-report-{topic-slug}.md`
 
 ---
 
-## 플랫폼별 검색 가이드
+## Platform-Specific Search Guides
 
-### 1. GitHub 검색 (gh CLI)
+### 1. GitHub Search (gh CLI)
 
 ```bash
-# 리포지토리 검색
+# Repository search
 gh search repos "object detection" --sort stars --limit 10
 gh search repos "gradio app" --language python --limit 5
 
-# 코드 검색
+# Code search
 gh search code "Qwen2VL" --extension py
 
-# 리포지토리 상세 정보
+# Repository details
 gh repo view owner/repo
 
-# JSON 출력 (파싱용)
+# JSON output (for parsing)
 gh search repos "keyword" --limit 10 --json fullName,description,stargazersCount,url
 ```
 
-#### 리포지토리 분석 순서
-1. README.md 확인 (사용법)
-2. 메인 진입점 파악 (app.py, main.py, inference.py)
-3. 의존성 확인 (requirements.txt, pyproject.toml)
-4. 소스 코드 분석
+#### Repository Analysis Order
+1. Check README.md (usage)
+2. Identify main entry point (app.py, main.py, inference.py)
+3. Check dependencies (requirements.txt, pyproject.toml)
+4. Analyze source code
 
 ---
 
-### 2. Hugging Face 검색 (huggingface_hub)
+### 2. Hugging Face Search (huggingface_hub)
 
 ```python
 from huggingface_hub import HfApi
 
 api = HfApi()
 
-# 모델 검색
+# Model search
 models = api.list_models(search="object detection", limit=10, sort="downloads")
 for m in models:
     print(f"{m.id} - Downloads: {m.downloads}, Task: {m.pipeline_tag}")
 
-# 데이터셋 검색
+# Dataset search
 datasets = api.list_datasets(search="coco", limit=10, sort="downloads")
 
-# Spaces 검색
+# Spaces search
 spaces = api.list_spaces(search="gradio demo", limit=10, sort="likes")
 ```
 
-#### CLI로 다운로드
+#### CLI Downloads
 ```bash
-# Space 소스 코드 다운로드 (임시 분석용)
+# Download Space source code (for temporary analysis)
 uvx hf download <space_id> --repo-type space --include "*.py" --local-dir /tmp/<name>
 
-# 모델 파일 다운로드
+# Download model files
 uvx hf download <model_id> --include "*.json" --local-dir /tmp/<name>
 ```
 
-#### 주요 검색 패턴
+#### Key Search Patterns
 ```bash
-# 특정 태스크 모델
+# Models for specific tasks
 python -c "from huggingface_hub import HfApi; [print(m.id) for m in HfApi().list_models(search='grounding dino', limit=5)]"
 
-# Gradio 데모 찾기
+# Find Gradio demos
 python -c "from huggingface_hub import HfApi; [print(s.id) for s in HfApi().list_spaces(search='object detection', sdk='gradio', limit=5)]"
 ```
 
 ---
 
-### 3. Reddit 검색 (WebSearch)
+### 3. Reddit Search (WebSearch)
 
 ```
 WebSearch: site:reddit.com {query} {year}
 ```
 
-#### 주요 서브레딧
-- r/MachineLearning - ML 전반
-- r/pytorch - PyTorch 관련
-- r/deeplearning - 딥러닝
-- r/LocalLLaMA - 로컬 LLM
-- r/computervision - 컴퓨터 비전
+#### Key Subreddits
+- r/MachineLearning - ML in general
+- r/pytorch - PyTorch related
+- r/deeplearning - Deep learning
+- r/LocalLLaMA - Local LLMs
+- r/computervision - Computer vision
 
-#### 검색 예시
+#### Search Examples
 ```
 site:reddit.com TorchServe deployment 2024
 site:reddit.com r/MachineLearning "best practices" inference
@@ -204,13 +204,13 @@ site:reddit.com r/MachineLearning "best practices" inference
 
 ---
 
-### 4. Stack Overflow 검색 (WebSearch)
+### 4. Stack Overflow Search (WebSearch)
 
 ```
 WebSearch: site:stackoverflow.com [tag] {query}
 ```
 
-#### 검색 예시
+#### Search Examples
 ```
 site:stackoverflow.com [pytorch] model serving
 site:stackoverflow.com [huggingface-transformers] inference optimization
@@ -218,27 +218,27 @@ site:stackoverflow.com [huggingface-transformers] inference optimization
 
 ---
 
-### 5. Context7 - 공식 라이브러리 문서 (MCP)
+### 5. Context7 - Official Library Documentation (MCP)
 
 ```
 1. mcp__context7__resolve-library-id
-   - libraryName: "pytorch" 또는 "torchserve"
+   - libraryName: "pytorch" or "torchserve"
 
 2. mcp__context7__get-library-docs
    - context7CompatibleLibraryID: "/pytorch/pytorch"
-   - topic: "deployment" (선택)
+   - topic: "deployment" (optional)
 ```
 
-#### 주요 라이브러리 ID
+#### Key Library IDs
 - `/pytorch/pytorch` - PyTorch
 - `/huggingface/transformers` - Transformers
 - `/gradio-app/gradio` - Gradio
 
 ---
 
-### 6. DeepWiki - GitHub 리포 심층 분석 (MCP)
+### 6. DeepWiki - In-depth GitHub Repo Analysis (MCP)
 
-> `/ask-deepwiki` 커맨드 참조
+> See `/ask-deepwiki` command
 
 ```
 mcp__deepwiki__read_wiki_structure
@@ -249,20 +249,20 @@ mcp__deepwiki__ask_question
   - question: "How to deploy custom model handler?"
 ```
 
-#### 유용한 리포지토리
+#### Useful Repositories
 - `pytorch/serve` - TorchServe
 - `huggingface/transformers` - Transformers
 - `facebookresearch/segment-anything` - SAM
 
 ---
 
-### 7. arXiv 검색 (WebSearch)
+### 7. arXiv Search (WebSearch)
 
 ```
 WebSearch: site:arxiv.org {topic} 2024
 ```
 
-#### 검색 예시
+#### Search Examples
 ```
 site:arxiv.org "image forgery detection" 2024
 site:arxiv.org "vision language model" benchmark 2024
@@ -270,7 +270,7 @@ site:arxiv.org "vision language model" benchmark 2024
 
 ---
 
-### 8. 일반 웹 검색 (Firecrawl)
+### 8. General Web Search (Firecrawl)
 
 ```
 mcp__firecrawl__firecrawl_search
@@ -284,76 +284,76 @@ mcp__firecrawl__firecrawl_scrape
 
 ---
 
-## 리포트 템플릿
+## Report Template
 
 ```markdown
-# 리서치 리포트: {주제}
+# Research Report: {Topic}
 
-**조사 일자**: {날짜}
-**검색 범위**: {시작일} ~ {종료일}
+**Research Date**: {date}
+**Search Range**: {start_date} ~ {end_date}
 
-## 요약
+## Summary
 
-- 핵심 발견 1
-- 핵심 발견 2
-- 핵심 발견 3
+- Key finding 1
+- Key finding 2
+- Key finding 3
 
-## 1. 주요 발견
+## 1. Key Findings
 
-### 커뮤니티 인사이트 (Reddit/GitHub/SO)
+### Community Insights (Reddit/GitHub/SO)
 
-#### 공통 이슈
-- 이슈 1 ([출처](URL))
-- 이슈 2 ([출처](URL))
+#### Common Issues
+- Issue 1 ([source](URL))
+- Issue 2 ([source](URL))
 
-#### 해결책
-- 해결책 1 ([출처](URL))
-- 해결책 2 ([출처](URL))
+#### Solutions
+- Solution 1 ([source](URL))
+- Solution 2 ([source](URL))
 
-### 공식 문서 요약 (Context7/DeepWiki)
+### Official Documentation Summary (Context7/DeepWiki)
 
-- 베스트 프랙티스 1
-- 베스트 프랙티스 2
-- 주의사항
+- Best practice 1
+- Best practice 2
+- Caveats
 
-### GitHub 프로젝트
+### GitHub Projects
 
-| 프로젝트 | Stars | 설명 |
-|----------|-------|------|
-| [owner/repo](URL) | 1.2k | 설명 |
+| Project | Stars | Description |
+|---------|-------|-------------|
+| [owner/repo](URL) | 1.2k | Description |
 
-### Hugging Face 리소스
+### Hugging Face Resources
 
-| 리소스 | 타입 | Downloads/Likes |
-|--------|------|-----------------|
+| Resource | Type | Downloads/Likes |
+|----------|------|-----------------|
 | [model-id](URL) | Model | 10k |
 
-## 2. 권장 사항
+## 2. Recommendations
 
-1. 권장 사항 1
-2. 권장 사항 2
-3. 권장 사항 3
+1. Recommendation 1
+2. Recommendation 2
+3. Recommendation 3
 
-## 출처
+## Sources
 
-1. [제목](URL) - 플랫폼, 날짜
-2. [제목](URL) - 플랫폼, 날짜
+1. [Title](URL) - Platform, Date
+2. [Title](URL) - Platform, Date
 ```
 
-**저장**: `research-report-{topic-slug}.md` (한글, 단일 파일)
+**Save as**: `research-report-{topic-slug}.md` (English, single file)
 
 ---
 
-## 품질 기준
+## Quality Standards
 
-1. **최신성**: 최근 1-2년 콘텐츠 우선
-2. **신뢰도**: 공식 문서 > GitHub 이슈 > Stack Overflow > Reddit
-3. **구체성**: 코드 예시, 구체적 솔루션 포함
-4. **출처 명시**: 모든 정보에 링크와 날짜 포함
-5. **실행 가능성**: 명확하고 실행 가능한 권장사항
+1. **Recency**: Prioritize content from the last 1-2 years
+2. **Reliability**: Official docs > GitHub issues > Stack Overflow > Reddit
+3. **Specificity**: Include code examples and concrete solutions
+4. **Attribution**: Include links and dates for all information
+5. **Actionability**: Clear and actionable recommendations
 
-## 파일 관리
+## File Management
 
-- 중간 데이터는 메모리에만 유지
-- **최종 산출물**: `research-report-{topic-slug}.md` 단일 파일만 저장
-- 임시 파일, 중간 초안 등은 생성하지 않음
+- Keep intermediate data in memory only
+- **Final deliverable**: Single `research-report-{topic-slug}.md` file only
+- Do not create temporary files or intermediate drafts

package/.claude/commands/gh/post-merge.md

@@ -51,26 +51,31 @@ Perform branch cleanup and CLAUDE.md updates after a PR has been merged. Follow
      - Run `gh project item-edit` to set Status to "Done"
      - Skip if issue is not in project or Status field does not exist
 
-6. **Analyze and Update CLAUDE.md**
-   - Check if CLAUDE.md exists
-     - If not: Prompt user to create or skip
-   - Analyze existing content:
+6. **Analyze and Update Configuration Files**
+   - Check which configuration files exist:
+     - `CLAUDE.md` - Claude Code specific instructions
+     - `AGENTS.md` - Cross-tool AI coding agent instructions (Codex, Cursor, Gemini, etc.)
+     - `GEMINI.md` - Google Gemini CLI specific instructions
+   - For each existing file, analyze:
      - Find temporary instructions related to resolved issue (e.g., mentions of `#<issue_number>`, `issue-<number>`)
      - Identify outdated or inaccurate information
      - Identify redundant or unnecessary content
-   - Prepare update proposal:
+   - Prepare update proposal for each file:
      - **To remove**: Temporary notes/instructions related to resolved issue
      - **To add**: New patterns/conventions discovered during issue resolution
      - **To modify**: Outdated or inaccurate information
    - Present proposal to user for confirmation before applying
 
 7. **Commit Changes (Optional)**
-   - If CLAUDE.md was modified, prompt user to confirm commit
+   - If any configuration files were modified, prompt user to confirm commit
    - If confirmed: Commit using Conventional Commits format
+   - Example: `git add CLAUDE.md AGENTS.md GEMINI.md 2>/dev/null || true`
 
 > See [Work Guidelines](../guidelines/work-guidelines.md)
 
-## CLAUDE.md Update Guide
+## Configuration File Update Guide
+
+The following guidelines apply to CLAUDE.md, AGENTS.md, and GEMINI.md:
 
 ### Examples of Content to Remove
 - Temporary notes like `TODO: remove after #123 is resolved`

package/.claude/commands/tm/convert-prd.md

@@ -2,7 +2,7 @@
 
 Convert a draft file to TaskMaster PRD format.
 
-**Template:** Copy `.claude/guideline/tm/prd-guide.md` to create draft
+**Template:** Copy `.claude/guidelines/prd-guide.md` to create draft
 
 **Principles:**
 - Preserve original content (do not add or remove arbitrarily)

package/.claude/commands/tm/post-merge.md

@@ -119,25 +119,31 @@ task-master next
 # Dependencies satisfied: Task 1 (done)
 ```
 
-### 8. Analyze and Update CLAUDE.md
+### 8. Analyze and Update Configuration Files
 
-**Analysis targets:**
+**Target files (check if exist):**
+- `CLAUDE.md` - Claude Code specific instructions
+- `AGENTS.md` - Cross-tool AI coding agent instructions (Codex, Cursor, Gemini, etc.)
+- `GEMINI.md` - Google Gemini CLI specific instructions
+
+**For each existing file, analyze:**
 - Temporary instructions related to resolved Issue/Task (mentions of `#1`, `task 1`)
 - Outdated or inaccurate information
 - Newly discovered patterns/conventions
 
-**Draft update proposal and confirm with user:**
+**Draft update proposal and confirm with user for each file:**
 - Delete: Temporary notes related to resolved issues
 - Add: New patterns discovered during work
 - Modify: Changed information
 
 ### 9. Commit Changes (Optional)
 
-If CLAUDE.md was modified, ask via AskUserQuestion about committing:
+If any configuration files were modified, ask via AskUserQuestion about committing:
 
 ```bash
-git add CLAUDE.md
-git commit -m "docs: update CLAUDE.md (reflecting task $TASK_ID completion)"
+# Add all modified config files
+git add CLAUDE.md AGENTS.md GEMINI.md 2>/dev/null || true
+git commit -m "docs: update config files (reflecting task $TASK_ID completion)"
 git push origin main
 ```
 
@@ -162,6 +168,8 @@ Cleanup:
 - [x] Local branch deleted: issue-<N>
 - [x] TaskMaster status updated
 - [ ] CLAUDE.md updated (no changes)
+- [ ] AGENTS.md updated (no changes / not found)
+- [ ] GEMINI.md updated (no changes / not found)
 
 Next Steps:
 - task-master next -> Task <M>

package/.claude/guidelines/cv-guidelines.md

@@ -1,30 +1,30 @@
 # CV Guidelines
 
-Computer Vision 작업 시 주의사항.
+Best practices for Computer Vision tasks.
 
-## BGR vs RGB 색상 형식
+## BGR vs RGB Color Format
 
-**핵심**: OpenCV는 BGR, matplotlib은 RGB 형식을 사용한다. supervision 등 OpenCV 기반 라이브러리로 annotation할 때는 BGR 상태를 유지하고, matplotlib 표시 직전에만 RGB로 변환한다.
+**Key Point**: OpenCV uses BGR, matplotlib uses RGB. When annotating with OpenCV-based libraries like supervision, keep the image in BGR format and convert to RGB only right before displaying with matplotlib.
 
 ```python
-# 올바른 패턴
+# Correct pattern
 img = cv2.imread(path)                    # BGR
-img = annotator.annotate(img, detections) # BGR 유지
-img = cv2.cvtColor(img, cv2.COLOR_BGR2RGB) # 표시 직전 변환
+img = annotator.annotate(img, detections) # Keep BGR
+img = cv2.cvtColor(img, cv2.COLOR_BGR2RGB) # Convert just before display
 plt.imshow(img)
 
-# 잘못된 패턴 (색상 반전 발생)
+# Wrong pattern (causes color inversion)
 img = cv2.imread(path)
-img = cv2.cvtColor(img, cv2.COLOR_BGR2RGB) # 너무 일찍 변환
-img = annotator.annotate(img, detections)  # RGB에 BGR 색상 적용 -> 색상 반전
+img = cv2.cvtColor(img, cv2.COLOR_BGR2RGB) # Too early
+img = annotator.annotate(img, detections)  # BGR colors on RGB image -> inverted
 plt.imshow(img)
 ```
 
-## Ultralytics WandB 연동
+## Ultralytics WandB Integration
 
-Ultralytics YOLO는 WandB가 기본적으로 비활성화되어 있다.
+Ultralytics YOLO has WandB disabled by default.
 
 ```bash
-yolo settings wandb=True   # 활성화
-yolo settings wandb=False  # 비활성화
+yolo settings wandb=True   # Enable
+yolo settings wandb=False  # Disable
 ```

package/.claude/guidelines/work-guidelines.md

@@ -1,17 +1,133 @@
 # Work Guidelines
 
-Common guidelines for all Claude Code commands.
+Common guidelines for all Claude Code commands and development workflow.
 
-## Response Rules
+---
 
+## Core Principles
+
+### Response Rules
 - Follow the instructions in `@CLAUDE.md`
+- Answer in the same language as user's request
+- Append sources that you've referenced at the very end of your answer
 - Do not use emoji in code or documentation
-- If anything is unclear, use the `AskUserQuestion` tool instead of guessing
 - Never add Claude attribution (e.g., "Generated with Claude", "Co-Authored-By: Claude") to commits, PRs, or issues
 
-## User Confirmation Required
+### Uncertainty Handling
+- If you are uncertain, confused, or lack clarity about the requirements or approach, **STOP immediately** and ask the user for clarification
+- Do not proceed with assumptions or guesses that could lead to incorrect implementations
+- If any instruction/requirement is unclear, ambiguous, or potentially incorrect, use the `AskUserQuestion` tool (do not ask inline in the response text)
 
+### User Confirmation Required
 Always confirm with the user before:
 - Irreversible operations (branch deletion, status changes)
-- Modifying CLAUDE.md
+- Modifying configuration files (CLAUDE.md, AGENTS.md, GEMINI.md)
 - Making architectural decisions
+- Implementing features beyond requested scope
+
+---
+
+## Development Workflow
+
+### Parallel Execution
+Use Task tool for independent tasks. For large projects, split into sub-tasks that:
+- Avoid consuming entire context window (maximizes token efficiency)
+- Produce separate files or distinct code sections (mergeable outputs)
+- Have no cross-dependencies (can run without coordination)
+- Example: Separate handlers, independent tests, different modules
+
+### Dependency Version Policy (Stable First)
+- Prefer widely adopted stable releases over the newest/bleeding-edge versions
+- Avoid `alpha`/`beta`/`rc`/canary/nightly releases
+- Respect existing project pins
+- If a newer version is required (security fix, critical bugfix, or mandatory feature), propose the upgrade with rationale and risks before changing
+
+### Performance/Optimization Gate
+- If you identify a clearly faster or more reliable library/framework/approach with meaningful benefit, **PAUSE** implementation and recommend it with trade-offs
+- Proceed only after user approval
+
+### Permission-Based Development
+- Never overengineer or go beyond the requested scope
+- Always ask user for permission when implementing new features
+
+---
+
+## Code Standards
+
+### MCP Server Usage
+Utilize MCP servers whenever possible:
+- `context7` - Library documentation queries
+- `deepwiki` - GitHub repository analysis
+- `mcpdocs` - Documentation fetching
+- `firecrawl` - Web scraping and search
+
+### Python Development
+- **Virtual Environment (MANDATORY)**: Always use virtual environment (uv) when running Python
+- **NEVER** use system Python (`python`, `python3`) directly
+- If `ModuleNotFoundError` occurs when attempting to run without virtual environment, immediately stop and report to user
+- **Syntax Validation**: After modifying Python (.py) files, always validate syntax using `py_compile`:
+  ```bash
+  python -m py_compile file.py
+  ```
+
+### Pip Installation Issues
+If pip install errors occur, try in order:
+1. `pip install --upgrade pip setuptools wheel`
+2. `pip cache purge && pip install -r requirements.txt`
+3. `pip install --no-cache-dir -r requirements.txt` (install packages one by one)
+
+### Jupyter Notebook Editing
+- **ALWAYS** use the `edit_notebook` tool exclusively for editing .ipynb files
+- **NEVER** use `search_replace`, `write`, or any other text editing tools on .ipynb files
+- After modifying .ipynb files, verify:
+  - JSON syntax validity
+  - Original cell execution order/outputs preserved (unless explicitly instructed to clear)
+  - Changes are correct, no missing functions/imports/dependencies
+
+### Output Standards
+- **Minimal Output**: Avoid unnecessary print statements in code - only include meaningful debug output when explicitly requested
+- **No Emojis**: Never use emojis anywhere, whether in documentation or code
+
+---
+
+## File Organization
+
+### Avoid Root Clutter
+- **NEVER** create output files in project root:
+  - Analysis notebooks
+  - Visualizations
+  - CSV data
+  - Logs
+  - Temporary files
+- Only essential project configuration files belong in root (e.g., `README.md`, `requirements.txt`, config files)
+
+### Module-Level Organization
+Each module should maintain its own organized structure:
+```
+[module]/
+  analysis/    # Analysis files
+  outputs/     # Generated outputs
+  tests/       # Test files
+  ...
+```
+
+### Temporary Files
+- Create and use a dedicated temporary directory
+- Never commit temporary files to git
+
+---
+
+## Translation Guidelines
+
+When translating into Korean:
+- Keep technical terms, code blocks, and commands in their original form
+- Translate the surrounding text into natural, context-appropriate Korean
+- After completing the translation, review it to ensure it meets these criteria
+
+---
+
+## Related Guidelines
+
+- [ID Reference](./id-reference.md) - GitHub/TaskMaster ID conventions
+- [CV Guidelines](./cv-guidelines.md) - Computer vision specific guidelines
+- [PRD Guide](./prd-guide.md) - PRD template for TaskMaster

package/README.md

@@ -28,7 +28,9 @@ A collection of custom slash commands, agents, and skills for Claude Code CLI.
 │       └── sync-to-github.md      # Sync TaskMaster -> GitHub
 ├── guidelines/                  # Shared guidelines
 │   ├── work-guidelines.md       # Common work guidelines
-│   └── id-reference.md          # GitHub/TaskMaster ID reference
+│   ├── id-reference.md          # GitHub/TaskMaster ID reference
+│   ├── cv-guidelines.md         # Computer vision guidelines
+│   └── prd-guide.md             # PRD template for TaskMaster
 ├── agents/                      # Custom agents
 │   ├── web-researcher.md        # Multi-platform web research
 │   └── python-pro.md            # Python expert
@@ -71,7 +73,7 @@ A collection of custom slash commands, agents, and skills for Claude Code CLI.
 | `/gh/create-issue-label` | Analyze project and create appropriate GitHub issue labels |
 | `/gh/decompose-issue` | Decompose large work into manageable independent issues |
 | `/gh/init-project` | Initialize and configure GitHub Project board |
-| `/gh/post-merge` | Clean up branch and update CLAUDE.md after PR merge |
+| `/gh/post-merge` | Clean up branch and update config files (CLAUDE.md, AGENTS.md, GEMINI.md) after PR merge |
 | `/gh/resolve-issue` | Systematically analyze and resolve GitHub issues |
 
 ### TaskMaster Integration Commands (`/tm/`)
@@ -81,7 +83,7 @@ A collection of custom slash commands, agents, and skills for Claude Code CLI.
 | `/tm/convert-prd` | Convert PRD draft to TaskMaster PRD format |
 | `/tm/sync-to-github` | Sync TaskMaster tasks.json to GitHub Issues/Milestones |
 | `/tm/resolve-issue` | Resolve GitHub Issues by TaskMaster subtask units |
-| `/tm/post-merge` | TaskMaster status update and branch cleanup after PR merge |
+| `/tm/post-merge` | TaskMaster status update, config file updates, and branch cleanup after PR merge |
 
 ## Agents
 
@@ -163,6 +165,18 @@ Options:
   -v, --version  Show version
 ```
 
+### Installation Modes
+
+When existing folders are detected, you'll be prompted to choose:
+
+| Mode | Behavior |
+|------|----------|
+| **update** (default) | Overwrite existing files, add new files, keep custom files |
+| **merge** | Add new files only, skip existing files |
+
+- **update**: Recommended when upgrading to a new version
+- **merge**: Safe when you have heavily customized files you don't want changed
+
 ## MCP Server Configuration
 
 The package includes `.mcp.json` that can be copied to your project root.

package/bin/cli.js

@@ -8,44 +8,45 @@ const readline = require('readline');
 const pkg = require('../package.json');
 const args = process.argv.slice(2);
 
-// 설치 대상 폴더 (사용자 데이터가 아닌 것들만)
-const INSTALL_FOLDERS = ['commands', 'agents', 'skills'];
+// Installation target folders (non-user data only)
+const INSTALL_FOLDERS = ['commands', 'agents', 'skills', 'guidelines'];
 
-// 옵션 파싱
+// Parse options
 const isGlobal = args.includes('--global') || args.includes('-g');
 const showHelp = args.includes('--help') || args.includes('-h');
 const showVersion = args.includes('--version') || args.includes('-v');
 
-// 버전 출력
+// Version output
 if (showVersion) {
   console.log(pkg.version);
   process.exit(0);
 }
 
-// 도움말 출력
+// Help output
 if (showHelp) {
   console.log(`
 Claude Code Config v${pkg.version}
 
-사용법:
-  npx @yeongjaeyou/claude-code-config [옵션]
+Usage:
+  npx @yeongjaeyou/claude-code-config [options]
 
-옵션:
-  -g, --global   전역 설치 (~/.claude/)
-  -h, --help     도움말 출력
-  -v, --version  버전 출력
+Options:
+  -g, --global   Global install (~/.claude/)
+  -h, --help     Show help
+  -v, --version  Show version
 
-예시:
-  npx @yeongjaeyou/claude-code-config          # 현재 프로젝트에 설치
-  npx @yeongjaeyou/claude-code-config --global # 전역 설치
+Examples:
+  npx @yeongjaeyou/claude-code-config          # Install to current project
+  npx @yeongjaeyou/claude-code-config --global # Global install
 
-설치되는 폴더:
-  - commands/  : 슬래시 커맨드
-  - agents/    : 커스텀 에이전트
-  - skills/    : 스킬 (재사용 가능한 도구 모음)
+Installed folders:
+  - commands/   : Slash commands
+  - agents/     : Custom agents
+  - skills/     : Skills (reusable tool collections)
+  - guidelines/ : Shared guidelines
 
-참고:
-  --global 설치 시 기존 사용자 데이터(settings.json, history.jsonl 등)는 보존됩니다.
+Note:
+  With --global install, existing user data (settings.json, history.jsonl, etc.) is preserved.
 `);
   process.exit(0);
 }
@@ -56,15 +57,15 @@ const dest = isGlobal
   : path.join(process.cwd(), '.claude');
 
 /**
- * 사용자에게 질문하고 답변을 받는다
- * @param {string} question - 질문 내용
- * @returns {Promise<string>} - 사용자 답변
+ * Ask user a question and get answer
+ * @param {string} question - Question content
+ * @returns {Promise<string>} - User answer
  */
 function askQuestion(question) {
-  // 비대화형 환경 감지 (CI/CD, 파이프라인 등)
+  // Detect non-interactive environment (CI/CD, pipelines, etc.)
   if (!process.stdin.isTTY) {
-    console.log('비대화형 환경이 감지되었습니다. 기본값(merge)을 사용합니다.');
-    return Promise.resolve('merge');
+    console.log('Non-interactive environment detected. Using default (update).');
+    return Promise.resolve('update');
   }
 
   const rl = readline.createInterface({
@@ -81,8 +82,8 @@ function askQuestion(question) {
 }
 
 /**
- * 기존 설치 폴더 확인
- * @returns {string[]} - 존재하는 폴더 목록
+ * Check existing installation folders
+ * @returns {string[]} - List of existing folders
  */
 function checkExistingFolders() {
   const existing = [];
@@ -96,22 +97,22 @@ function checkExistingFolders() {
 }
 
 /**
- * 폴더 복사 (재귀적)
- * @param {string} src - 소스 경로
- * @param {string} dst - 대상 경로
- * @param {boolean} mergeMode - 병합 모드 여부
+ * Copy folder recursively
+ * @param {string} src - Source path
+ * @param {string} dst - Destination path
+ * @param {string} mode - Installation mode: 'merge' | 'update'
  */
-function copyFolder(src, dst, mergeMode = false) {
+function copyFolder(src, dst, mode = 'merge') {
   if (!fs.existsSync(src)) {
     return;
   }
 
-  // 대상 폴더 생성
+  // Create destination folder
   if (!fs.existsSync(dst)) {
     try {
       fs.mkdirSync(dst, { recursive: true });
     } catch (err) {
-      throw new Error(`폴더 생성 실패: ${dst} - ${err.message}`);
+      throw new Error(`Failed to create folder: ${dst} - ${err.message}`);
     }
   }
 
@@ -122,28 +123,28 @@ function copyFolder(src, dst, mergeMode = false) {
     const dstPath = path.join(dst, entry.name);
 
     if (entry.isDirectory()) {
-      copyFolder(srcPath, dstPath, mergeMode);
+      copyFolder(srcPath, dstPath, mode);
     } else {
-      // 병합 모드에서는 기존 파일 유지
-      if (mergeMode && fs.existsSync(dstPath)) {
+      // In merge mode, keep existing files (skip if exists)
+      if (mode === 'merge' && fs.existsSync(dstPath)) {
         continue;
       }
+      // In update mode, overwrite existing files + add new files
+      // Custom files (only in dest) are preserved since we don't delete them
       try {
         fs.copyFileSync(srcPath, dstPath);
       } catch (err) {
-        throw new Error(`파일 복사 실패: ${srcPath} -> ${dstPath} - ${err.message}`);
+        throw new Error(`Failed to copy file: ${srcPath} -> ${dstPath} - ${err.message}`);
       }
     }
   }
 }
 
 /**
- * 설치 대상 폴더만 선택적으로 복사
- * @param {string} mode - 'merge' | 'overwrite'
+ * Selectively copy installation target folders
+ * @param {string} mode - 'merge' | 'update'
  */
 function installFolders(mode) {
-  const mergeMode = mode === 'merge';
-
   for (const folder of INSTALL_FOLDERS) {
     const srcFolder = path.join(source, folder);
     const dstFolder = path.join(dest, folder);
@@ -152,21 +153,15 @@ function installFolders(mode) {
       continue;
     }
 
-    // 덮어쓰기 모드에서는 기존 폴더 삭제 후 복사
-    if (!mergeMode && fs.existsSync(dstFolder)) {
-      try {
-        fs.rmSync(dstFolder, { recursive: true });
-      } catch (err) {
-        throw new Error(`폴더 삭제 실패: ${dstFolder} - ${err.message}`);
-      }
-    }
-
-    copyFolder(srcFolder, dstFolder, mergeMode);
+    // Both modes now preserve custom files
+    // - merge: skip existing files, add new files only
+    // - update: overwrite existing files, add new files, keep custom files
+    copyFolder(srcFolder, dstFolder, mode);
   }
 }
 
 /**
- * 메인 함수
+ * Main function
  */
 async function main() {
   console.log('');
@@ -174,90 +169,91 @@ async function main() {
   console.log('==================');
   console.log('');
 
-  // 소스 폴더 존재 확인
+  // Check source folder exists
   if (!fs.existsSync(source)) {
-    console.error('오류: 소스 .claude/ 폴더를 찾을 수 없습니다.');
+    console.error('Error: Source .claude/ folder not found.');
     process.exit(1);
   }
 
-  // 설치 위치 안내
+  // Display installation location
   if (isGlobal) {
-    console.log('전역 설치 모드: ~/.claude/에 설치합니다.');
+    console.log('Global install mode: Installing to ~/.claude/');
   } else {
-    console.log('로컬 설치 모드: 현재 디렉토리에 설치합니다.');
+    console.log('Local install mode: Installing to current directory.');
   }
-  console.log(`설치 경로: ${dest}`);
+  console.log(`Install path: ${dest}`);
   console.log('');
 
-  // 대상 폴더 생성 (없으면)
+  // Create destination folder if not exists
   if (!fs.existsSync(dest)) {
     try {
       fs.mkdirSync(dest, { recursive: true });
     } catch (err) {
-      console.error(`오류: 대상 폴더를 생성할 수 없습니다: ${dest}`);
-      console.error(`상세: ${err.message}`);
+      console.error(`Error: Cannot create destination folder: ${dest}`);
+      console.error(`Details: ${err.message}`);
       process.exit(1);
     }
   }
 
-  // 기존 설치 폴더 확인
+  // Check existing installation folders
   const existingFolders = checkExistingFolders();
-  let installMode = 'overwrite';
+  let installMode = 'update';
 
   if (existingFolders.length > 0) {
-    console.log('기존 설치 폴더가 발견되었습니다:');
+    console.log('Existing installation folders found:');
     existingFolders.forEach(folder => {
       console.log(`  - ${folder}/`);
     });
     console.log('');
 
     if (isGlobal) {
-      console.log('(사용자 데이터는 보존됩니다: settings.json, history.jsonl 등)');
+      console.log('(User data will be preserved: settings.json, history.jsonl, etc.)');
       console.log('');
     }
 
-    console.log('설치 옵션:');
-    console.log('  [m] merge     - 새 파일만 추가 (기존 파일 유지)');
-    console.log('  [o] overwrite - 위 폴더들만 덮어쓰기');
-    console.log('  [c] cancel    - 설치 취소');
+    console.log('Installation options:');
+    console.log('  [u] update - Update existing files, keep custom files (Recommended)');
+    console.log('  [m] merge  - Add new files only, skip existing');
+    console.log('  [c] cancel - Cancel installation');
     console.log('');
 
-    const answer = await askQuestion('선택하세요 (m/o/c) [기본: m]: ');
+    const answer = await askQuestion('Choose (u/m/c) [default: u]: ');
 
     if (answer === 'c' || answer === 'cancel') {
-      console.log('설치가 취소되었습니다.');
+      console.log('Installation cancelled.');
       process.exit(0);
-    } else if (answer === 'o' || answer === 'overwrite') {
-      installMode = 'overwrite';
+    } else if (answer === 'm' || answer === 'merge') {
+      installMode = 'merge';
       console.log('');
-      console.log('덮어쓰기 모드로 설치합니다...');
+      console.log('Installing in merge mode (keeping existing files)...');
     } else {
-      // 기본값: merge (빈 값, 'm', 'merge' 등)
-      installMode = 'merge';
+      // Default: update (empty, 'u', 'update', etc.)
+      installMode = 'update';
       console.log('');
-      console.log('병합 모드로 설치합니다 (기존 파일 유지)...');
+      console.log('Installing in update mode (updating existing files, keeping custom files)...');
     }
   }
 
-  // 폴더 설치
+  // Install folders
   installFolders(installMode);
 
   console.log('');
-  console.log('.claude/ 폴더가 성공적으로 설치되었습니다!');
+  console.log('.claude/ folder installed successfully!');
   console.log('');
-  console.log('설치된 내용:');
-  console.log('  - commands/  : 슬래시 커맨드');
-  console.log('  - agents/    : 커스텀 에이전트');
-  console.log('  - skills/    : 스킬 (재사용 가능한 도구 모음)');
+  console.log('Installed:');
+  console.log('  - commands/   : Slash commands');
+  console.log('  - agents/     : Custom agents');
+  console.log('  - skills/     : Skills (reusable tool collections)');
+  console.log('  - guidelines/ : Shared guidelines');
   console.log('');
 
   if (isGlobal) {
-    console.log('전역 설치가 완료되었습니다.');
-    console.log('모든 프로젝트에서 Claude Code 커맨드를 사용할 수 있습니다.');
+    console.log('Global installation complete.');
+    console.log('Claude Code commands are now available in all projects.');
   }
 }
 
 main().catch((error) => {
-  console.error('오류:', error.message);
+  console.error('Error:', error.message);
   process.exit(1);
 });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@yeongjaeyou/claude-code-config",
-  "version": "0.5.2",
+  "version": "0.7.0",
   "description": "Claude Code CLI custom commands, agents, and skills",
   "bin": {
     "claude-code-config": "./bin/cli.js"