cc-viewer 1.6.182 → 1.6.183

package/concepts/ko/Tool-TaskUpdate.md

@@ -1,123 +1,70 @@
 # TaskUpdate
 
-## 정의
+기존 작업 — 상태, 내용, 소유권, 메타데이터, 또는 의존성 에지 — 을 수정합니다. 이것은 작업이 수명 주기를 통해 진행되고 Claude Code, 팀원, 서브에이전트 간에 작업이 전달되는 방식입니다.
 
-태스크 리스트 내 특정 태스크의 상태, 내용 또는 의존 관계를 업데이트합니다.
+## 사용 시점
 
-## 파라미터
+- 작업을 진행할 때 상태 워크플로를 통해 작업을 전환합니다.
+- 자신 (또는 다른 에이전트)을 `owner`로 할당하여 작업을 주장합니다.
+- 문제에 대해 더 많이 알게 되면 `subject` 또는 `description`을 개선합니다.
+- `addBlocks` / `addBlockedBy`로 새로 발견된 의존성을 기록합니다.
+- 외부 티켓 ID나 우선순위 힌트와 같은 구조화된 `metadata`를 첨부합니다.
 
-| 파라미터 | 타입 | 필수 | 설명 |
-|----------|------|------|------|
-| `taskId` | string | 예 | 업데이트할 태스크 ID |
-| `status` | enum | 아니오 | 새 상태: `pending` / `in_progress` / `completed` / `deleted` |
-| `subject` | string | 아니오 | 새 제목 |
-| `description` | string | 아니오 | 새 설명 |
-| `activeForm` | string | 아니오 | 진행 중 표시할 현재 진행형 텍스트 |
-| `owner` | string | 아니오 | 새 태스크 담당자 (agent 이름) |
-| `metadata` | object | 아니오 | 병합할 메타데이터 (null로 설정하면 키 삭제) |
-| `addBlocks` | string[] | 아니오 | 이 태스크에 의해 차단되는 태스크 ID 목록 |
-| `addBlockedBy` | string[] | 아니오 | 이 태스크를 차단하는 선행 태스크 ID 목록 |
+## 매개변수
 
-## 상태 전이
+- `taskId` (string, 필수): 수정할 작업. `TaskList`나 `TaskCreate`에서 얻습니다.
+- `status` (string, 선택): `pending`, `in_progress`, `completed`, `deleted` 중 하나.
+- `subject` (string, 선택): 교체할 명령형 제목.
+- `description` (string, 선택): 교체할 상세한 설명.
+- `activeForm` (string, 선택): 교체할 현재 진행형 스피너 텍스트.
+- `owner` (string, 선택): 작업에 대한 책임을 맡는 에이전트나 팀원 핸들.
+- `metadata` (object, 선택): 작업에 병합할 메타데이터 키. 키를 `null`로 설정하여 삭제합니다.
+- `addBlocks` (array of strings, 선택): 이 작업이 차단하는 작업 ID.
+- `addBlockedBy` (array of strings, 선택): 이 작업 전에 완료되어야 하는 작업 ID.
 
-```
-pending → in_progress → completed
-```
-
-`deleted`는 모든 상태에서 전이 가능하며, 태스크를 영구 삭제합니다.
-
-## 사용 시나리오
-
-**적합한 경우:**
-- 작업 시작 시 태스크를 `in_progress`로 마킹
-- 작업 완료 후 태스크를 `completed`로 마킹
-- 태스크 간 의존 관계 설정
-- 요구사항 변경 시 태스크 내용 업데이트
-
-**중요 규칙:**
-- 태스크를 완전히 완료한 경우에만 `completed`로 마킹
-- 오류나 차단에 직면하면 `in_progress` 유지
-- 테스트 실패, 구현 불완전, 미해결 오류가 있으면 `completed`로 마킹 불가
-
-## 주의사항
-
-- 업데이트 전 TaskGet으로 태스크의 최신 상태를 가져와 오래된 데이터를 피할 것
-- 태스크 완료 후 TaskList를 호출하여 다음 사용 가능한 태스크 검색
-
-## 원문
-
-<textarea readonly>Use this tool to update a task in the task list.
-
-## When to Use This Tool
+## 상태 워크플로
 
-**Mark tasks as resolved:**
-- When you have completed the work described in a task
-- When a task is no longer needed or has been superseded
-- IMPORTANT: Always mark your assigned tasks as resolved when you finish them
-- After resolving, call TaskList to find your next task
+수명 주기는 의도적으로 선형입니다: `pending` → `in_progress` → `completed`. `deleted`는 종결되며 절대 작업되지 않을 작업을 취소하는 데 사용됩니다.
 
-- ONLY mark a task as completed when you have FULLY accomplished it
-- If you encounter errors, blockers, or cannot finish, keep the task as in_progress
-- When blocked, create a new task describing what needs to be resolved
-- Never mark a task as completed if:
-  - Tests are failing
-  - Implementation is partial
-  - You encountered unresolved errors
-  - You couldn't find necessary files or dependencies
+- 실제로 작업을 시작하는 순간에 `in_progress`로 설정하십시오. 주어진 소유자에 대해 한 번에 하나의 작업만 `in_progress`여야 합니다.
+- 작업이 완전히 완료된 경우에만 `completed`로 설정하십시오 — 수락 기준 충족, 테스트 통과, 출력 작성. 블로커가 나타나면 작업을 `in_progress`로 유지하고 해결해야 할 것을 설명하는 새 작업을 추가하십시오.
+- 테스트가 실패하거나 구현이 부분적이거나 해결되지 않은 오류에 부딪힐 때 작업을 `completed`로 표시하지 마십시오.
+- 취소되거나 중복된 작업에는 `deleted`를 사용하십시오. 관련 없는 작업을 위해 작업을 재활용하지 마십시오.
 
-**Delete tasks:**
-- When a task is no longer relevant or was created in error
-- Setting status to `deleted` permanently removes the task
+## 예시
 
-**Update task details:**
-- When requirements change or become clearer
-- When establishing dependencies between tasks
+### 예시 1
 
-## Fields You Can Update
+작업을 주장하고 시작합니다.
 
-- **status**: The task status (see Status Workflow below)
-- **subject**: Change the task title (imperative form, e.g., "Run tests")
-- **description**: Change the task description
-- **activeForm**: Present continuous form shown in spinner when in_progress (e.g., "Running tests")
-- **owner**: Change the task owner (agent name)
-- **metadata**: Merge metadata keys into the task (set a key to null to delete it)
-- **addBlocks**: Mark tasks that cannot start until this one completes
-- **addBlockedBy**: Mark tasks that must complete before this one can start
-
-## Status Workflow
-
-Status progresses: `pending` → `in_progress` → `completed`
-
-Use `deleted` to permanently remove a task.
-
-## Staleness
-
-Make sure to read a task's latest state using `TaskGet` before updating it.
+```
+TaskUpdate(
+  taskId: "t_01HXYZ...",
+  status: "in_progress",
+  owner: "main-agent"
+)
+```
 
-## Examples
+### 예시 2
 
-Mark task as in progress when starting work:
-```json
-{"taskId": "1", "status": "in_progress"}
-```
+작업을 완료하고 후속 의존성을 기록합니다.
 
-Mark task as completed after finishing work:
-```json
-{"taskId": "1", "status": "completed"}
 ```
-
-Delete a task:
-```json
-{"taskId": "1", "status": "deleted"}
+TaskUpdate(
+  taskId: "t_01HXYZ...",
+  status: "completed"
+)
+
+TaskUpdate(
+  taskId: "t_01FOLLOWUP...",
+  addBlockedBy: ["t_01HXYZ..."]
+)
 ```
 
-Claim a task by setting owner:
-```json
-{"taskId": "1", "owner": "my-name"}
-```
+## 참고사항
 
-Set up task dependencies:
-```json
-{"taskId": "2", "addBlockedBy": ["1"]}
-```
-</textarea>
+- `metadata`는 키별로 병합됩니다. 키에 대해 `null`을 전달하면 제거됩니다. 현재 내용에 대해 확신이 없으면 먼저 `TaskGet`을 호출하십시오.
+- `addBlocks`와 `addBlockedBy`는 에지를 추가합니다. 기존 것을 제거하지 않습니다. 그래프를 파괴적으로 편집하려면 전용 워크플로가 필요합니다 — 의존성을 다시 작성하기 전에 팀 소유자와 상의하십시오.
+- `subject`를 변경할 때 `activeForm`을 동기화 상태로 유지하여 스피너 텍스트가 계속 자연스럽게 읽히도록 하십시오.
+- 작업을 조용히 하기 위해 `completed`로 표시하지 마십시오. 사용자가 작업을 취소한 경우 `description`에 간단한 근거와 함께 `deleted`를 사용하십시오.
+- 업데이트 전에 `TaskGet`으로 작업의 최신 상태를 읽으십시오 — 팀원이 마지막 읽기와 쓰기 사이에 변경했을 수 있습니다.

package/concepts/ko/Tool-TeamCreate.md

@@ -1,38 +1,53 @@
 # TeamCreate
 
-## 정의
+공유 작업 목록과 에이전트 간 메시징 채널을 갖춘 새로운 협업 팀을 설정합니다. 팀은 다중 에이전트 작업에 대한 조정 프리미티브입니다 — 메인 세션이 리더 역할을 하며 `Agent` 도구를 통해 명명된 팀원을 생성합니다.
 
-프로젝트를 진행하는 여러 agent를 조율하는 새로운 팀을 생성합니다. 팀은 공유 태스크 목록과 agent 간 메시지 교환을 통해 병렬 태스크 실행을 가능하게 합니다.
+## 사용 시점
 
-## 파라미터
+- 사용자가 팀, 스웜, 크루, 또는 다중 에이전트 협업을 명시적으로 요청합니다.
+- 프로젝트에 전담 전문가 (예: 프론트엔드, 백엔드, 테스트, 문서)로부터 이점을 얻는 명확히 독립적인 여러 작업 흐름이 있습니다.
+- 여러 에이전트가 진행 상황을 업데이트하는 영속적인 공유 작업 목록이 필요합니다.
+- 일회성 서브에이전트 호출이 아닌 `SendMessage`를 통해 메시지를 교환할 수 있는 명명된 주소 지정 가능한 팀원을 원합니다.
 
-| 파라미터 | 타입 | 필수 | 설명 |
-|----------|------|------|------|
-| `team_name` | string | 예 | 새 팀의 이름 |
-| `description` | string | 아니오 | 팀 설명 / 목적 |
-| `agent_type` | string | 아니오 | 팀 리더의 타입 / 역할 |
+단일 위임 검색이나 일회성 병렬 팬아웃에는 사용하지 마십시오 — 일반 `Agent` 호출이 더 가볍고 충분합니다.
 
-## 생성되는 항목
+## 매개변수
 
-- **팀 설정 파일**: `~/.claude/teams/{team-name}/config.json` — 멤버 목록과 메타데이터 저장
-- **태스크 목록 디렉토리**: `~/.claude/tasks/{team-name}/` — 모든 팀원이 공유하는 태스크 목록
+- `team_name` (string, 필수): 팀의 고유 식별자. `~/.claude/teams/` 아래의 디렉토리 이름과 팀원을 생성할 때의 `team_name` 인수로 사용됩니다.
+- `description` (string, 필수): 팀의 목적에 대한 짧은 진술. 생성 시 모든 팀원에게 표시되며 팀 구성에 작성됩니다.
+- `agent_type` (string, 선택): 재정의하지 않는 팀원에 적용되는 기본 서브에이전트 페르소나. 일반적인 값은 `general-purpose`, `Explore`, `Plan`입니다.
 
-팀과 태스크 목록은 1:1 대응 관계입니다.
+## 예시
 
-## 팀 워크플로우
+### 예시 1: 리팩터 팀 생성
 
-1. **TeamCreate** — 팀과 태스크 목록 생성
-2. **TaskCreate** — 팀의 태스크 정의
-3. **Agent** (`team_name` + `name` 지정) — 팀에 합류하는 팀원 생성
-4. **TaskUpdate** — `owner`를 통해 팀원에게 태스크 할당
-5. 팀원들이 태스크를 수행하며 **SendMessage**로 소통
-6. 완료 후 팀원 종료, 이후 **TeamDelete**로 정리
+```
+TeamCreate(
+  team_name="refactor-crew",
+  description="Refactor the data access layer from raw SQL to Prisma, including migrations and tests.",
+  agent_type="general-purpose"
+)
+```
 
-## 관련 도구
+생성 후 `team_name: "refactor-crew"`와 `db-lead`, `migrations`, `tests`와 같은 고유한 `name` 값으로 `Agent`를 사용하여 팀원을 생성합니다.
 
-| 도구 | 용도 |
-|------|------|
-| `TeamDelete` | 팀과 태스크 디렉토리 제거 |
-| `SendMessage` | 팀 내 agent 간 통신 |
-| `TaskCreate` / `TaskUpdate` / `TaskList` / `TaskGet` | 공유 태스크 목록 관리 |
-| `Agent` | 팀에 합류하는 팀원 생성 |
+### 예시 2: 조사 팀 생성
+
+```
+TeamCreate(
+  team_name="perf-investigation",
+  description="Identify and rank the top three performance regressions introduced in the last release.",
+  agent_type="Explore"
+)
+```
+
+생성된 각 팀원은 `Explore`를 기본 페르소나로 상속하여 작업의 읽기 전용 조사 특성과 일치합니다.
+
+## 참고사항
+
+- 주어진 세션에서 한 번에 하나의 팀만 이끌 수 있습니다. 다른 팀을 생성하기 전에 현재 팀을 완료하거나 삭제하십시오.
+- 팀은 공유 작업 목록과 1:1입니다. 리더가 작업 생성, 할당, 종료를 소유합니다. 팀원은 작업 중인 작업의 상태를 업데이트합니다.
+- 팀 구성은 `~/.claude/teams/{team_name}/config.json`에 지속되며 작업 디렉토리가 그 옆에 있습니다. 이 파일은 `TeamDelete`로 명시적으로 제거될 때까지 세션을 넘어 유지됩니다.
+- 팀원은 일치하는 `team_name`과 고유한 `name`으로 `Agent` 도구를 사용하여 생성됩니다. `name`은 `SendMessage`에서 사용되는 주소가 됩니다.
+- 파일시스템에 안전한 `team_name`을 선택하십시오 (문자, 숫자, 대시, 밑줄). 공백이나 슬래시를 피하십시오.
+- 새 팀원이 차갑게 읽으면 추가 컨텍스트 없이 팀의 목표를 이해할 수 있도록 `description`을 작성하십시오. 이것은 모든 팀원의 시작 프롬프트의 일부가 됩니다.

package/concepts/ko/Tool-TeamDelete.md

@@ -1,30 +1,44 @@
 # TeamDelete
 
-## 정의
+현재 활성화된 팀을 해체하여 구성 디렉토리와 공유 작업 디렉토리를 제거합니다. 이것은 `TeamCreate`의 정리 대응물이며 일반적으로 팀의 목표가 달성되고 모든 팀원이 종료된 후에 호출됩니다.
 
-다중 agent 협업 작업이 완료되었을 때 팀과 관련 태스크 디렉토리를 제거합니다. TeamCreate의 정리 대응 작업입니다.
+## 사용 시점
 
-## 동작
+- 팀이 작업을 완료했고 최종 보고서가 사용자에게 전달되었습니다.
+- 팀이 오류로 생성되었거나 범위가 너무 극적으로 변경되어 계속하는 것보다 새로 시작하는 것이 더 깔끔합니다.
+- 새 팀을 생성해야 하지만 이미 하나가 활성화되어 있습니다 — 한 번에 하나의 팀만 이끌 수 있으므로 먼저 이전 팀을 삭제하십시오.
+- 팀이 세션을 넘어 오래되어 `~/.claude/teams/` 아래의 지속된 상태가 더 이상 필요하지 않습니다.
 
-- 팀 디렉토리 제거: `~/.claude/teams/{team-name}/`
-- 태스크 디렉토리 제거: `~/.claude/tasks/{team-name}/`
-- 현재 세션에서 팀 컨텍스트 초기화
+팀원이 여전히 실행 중일 때 호출하지 마십시오 — 먼저 `shutdown_request`와 함께 `SendMessage`를 통해 종료하고, 모든 `shutdown_response`를 기다린 다음 삭제하십시오.
 
-**중요**: 팀에 아직 활성 멤버가 있으면 TeamDelete는 실패합니다. SendMessage 종료 요청을 통해 먼저 모든 팀원을 정상적으로 종료해야 합니다.
+## 매개변수
 
-## 일반적인 사용 방법
+`TeamDelete`는 일반적인 호출에서 매개변수를 받지 않습니다. 호출 세션이 소유한 현재 활성화된 팀에서 작동합니다.
 
-TeamDelete는 팀 워크플로우 종료 시 호출됩니다:
+## 예시
 
-1. 모든 태스크 완료
-2. `SendMessage`로 `shutdown_request`를 보내 팀원 종료
-3. **TeamDelete**가 팀과 태스크 디렉토리 제거
+### 예시 1: 성공 후 일상적인 종료
 
-## 관련 도구
+1. 팀에 종료 요청을 브로드캐스트합니다:
+   ```
+   SendMessage(to="*", message={ "type": "shutdown_request" })
+   ```
+2. 각 팀원이 `shutdown_response`로 응답하기를 기다립니다.
+3. `TeamDelete()`를 호출하여 팀 디렉토리와 작업 디렉토리를 제거합니다.
 
-| 도구 | 용도 |
-|------|------|
-| `TeamCreate` | 새 팀과 태스크 목록 생성 |
-| `SendMessage` | 팀원과의 통신 / 종료 요청 전송 |
-| `TaskCreate` / `TaskUpdate` / `TaskList` / `TaskGet` | 공유 태스크 목록 관리 |
-| `Agent` | 팀에 합류하는 팀원 생성 |
+### 예시 2: 잘못 구성된 팀 교체
+
+`TeamCreate`가 잘못된 `agent_type`이나 `description`으로 호출된 경우, 먼저 팀원이 생성되지 않았는지 확인하고 (또는 종료하고) 다음을 수행합니다:
+
+```
+TeamDelete()
+TeamCreate(team_name="...", description="...", agent_type="...")
+```
+
+## 참고사항
+
+- 팀원이 여전히 활성화되어 있으면 `TeamDelete`가 실패합니다. 오류 응답은 활성 팀원을 나열합니다 — 각 팀원에게 `SendMessage`를 통해 `shutdown_request`를 보내고 `shutdown_response`를 기다린 다음 다시 시도하십시오.
+- 삭제는 도구의 관점에서 되돌릴 수 없습니다. `~/.claude/teams/{team_name}/config.json`의 팀 구성과 작업 디렉토리가 디스크에서 제거됩니다. 작업 목록을 보존해야 하는 경우 삭제 전에 디렉토리를 내보내거나 복사하십시오.
+- 팀을 생성한 리더 세션만 삭제할 수 있습니다. 생성된 팀원은 자신의 팀에서 `TeamDelete`를 호출할 수 없습니다.
+- 팀을 삭제해도 팀원이 저장소에 만든 파일시스템 변경 사항은 롤백되지 않습니다. 이들은 일반적인 git 추적 편집이며 원하지 않으면 별도로 되돌려야 합니다.
+- `TeamDelete`가 성공적으로 반환된 후 세션은 새 팀을 위해 다시 `TeamCreate`를 호출할 수 있습니다.

package/concepts/ko/Tool-WebFetch.md

@@ -1,55 +1,50 @@
 # WebFetch
 
-## 정의
-
-지정된 URL의 웹페이지 내용을 가져와 HTML을 markdown으로 변환하고, AI 모델로 prompt에 따라 내용을 처리합니다.
-
-## 파라미터
-
-| 파라미터 | 타입 | 필수 | 설명 |
-|----------|------|------|------|
-| `url` | string (URI) | 예 | 가져올 완전한 URL |
-| `prompt` | string | 예 | 페이지에서 어떤 정보를 추출할지 설명 |
-
-## 사용 시나리오
-
-**적합한 경우:**
-- 공개 웹페이지의 내용 가져오기
-- 온라인 문서 참조
-- 웹페이지에서 특정 정보 추출
-
-**적합하지 않은 경우:**
-- 인증이 필요한 URL (Google Docs, Confluence, Jira, GitHub 등) — 먼저 전용 MCP 도구를 찾아야 함
-- GitHub URL — `gh` CLI를 우선 사용
-
-## 주의사항
-
-- URL은 완전한 유효 URL이어야 함
-- HTTP는 자동으로 HTTPS로 업그레이드
-- 내용이 너무 크면 결과가 요약될 수 있음
-- 15분 자동 정리 캐시 포함
-- URL이 다른 호스트로 리다이렉트되면 도구가 리다이렉트 URL을 반환하며, 새 URL로 재요청 필요
-- MCP 제공 web fetch 도구가 사용 가능하면 그것을 우선 사용
-
-## 원문
-
-<textarea readonly>IMPORTANT: WebFetch WILL FAIL for authenticated or private URLs. Before using this tool, check if the URL points to an authenticated service (e.g. Google Docs, Confluence, Jira, GitHub). If so, you MUST use ToolSearch first to find a specialized tool that provides authenticated access.
-
-- Fetches content from a specified URL and processes it using an AI model
-- Takes a URL and a prompt as input
-- Fetches the URL content, converts HTML to markdown
-- Processes the content with the prompt using a small, fast model
-- Returns the model's response about the content
-- Use this tool when you need to retrieve and analyze web content
-
-Usage notes:
-  - IMPORTANT: If an MCP-provided web fetch tool is available, prefer using that tool instead of this one, as it may have fewer restrictions.
-  - The URL must be a fully-formed valid URL
-  - HTTP URLs will be automatically upgraded to HTTPS
-  - The prompt should describe what information you want to extract from the page
-  - This tool is read-only and does not modify any files
-  - Results may be summarized if the content is very large
-  - Includes a self-cleaning 15-minute cache for faster responses when repeatedly accessing the same URL
-  - When a URL redirects to a different host, the tool will inform you and provide the redirect URL in a special format. You should then make a new WebFetch request with the redirect URL to fetch the content.
-  - For GitHub URLs, prefer using the gh CLI via Bash instead (e.g., gh pr view, gh issue view, gh api).
-</textarea>
+공개 웹 페이지의 내용을 검색하고, HTML을 Markdown으로 변환한 다음, 자연어 프롬프트를 사용하여 결과에 작은 보조 모델을 실행하여 필요한 정보를 추출합니다.
+
+## 사용 시점
+
+- 대화에서 참조된 공개 문서 페이지, 블로그 게시물, 또는 RFC 읽기.
+- 전체 페이지를 컨텍스트에 로드하지 않고 알려진 URL에서 특정 사실, 코드 스니펫, 또는 테이블 추출.
+- 공개 웹 리소스에서 릴리스 노트나 변경 로그 요약.
+- 소스가 로컬 저장소에 없을 때 라이브러리의 공개 API 참조 확인.
+- 후속 질문에 답하기 위해 사용자가 채팅에 붙여 넣은 링크 따르기.
+
+## 매개변수
+
+- `url` (string, 필수): 완전히 형성된 절대 URL. 일반 `http://`는 자동으로 `https://`로 업그레이드됩니다.
+- `prompt` (string, 필수): 작은 추출 모델에 전달되는 지시사항. 페이지에서 정확히 무엇을 추출할지 설명하십시오. 예를 들어 "모든 내보낸 함수를 나열하세요" 또는 "지원되는 최소 Node 버전을 반환하세요".
+
+## 예시
+
+### 예시 1: 구성 기본값 추출
+
+```
+WebFetch(
+  url="https://vitejs.dev/config/server-options.html",
+  prompt="What is the default value of server.port and can it be a string?"
+)
+```
+
+도구는 Vite 문서 페이지를 가져와 Markdown으로 변환하고 "기본값은 `5173`이며 숫자만 허용합니다."와 같은 짧은 답변을 반환합니다.
+
+### 예시 2: 변경 로그 섹션 요약
+
+```
+WebFetch(
+  url="https://nodejs.org/en/blog/release/v20.11.0",
+  prompt="List the security fixes included in this release as bullet points."
+)
+```
+
+사용자가 "Node 20.11에서 무엇이 변경되었나요"라고 묻고 릴리스 페이지가 길 때 유용합니다.
+
+## 참고사항
+
+- `WebFetch`는 인증, 쿠키, 또는 VPN이 필요한 URL에서 실패합니다. Google Docs, Confluence, Jira, 비공개 GitHub 리소스, 또는 내부 위키의 경우 인증된 접근을 제공하는 전용 MCP 서버를 대신 사용하십시오.
+- GitHub에 호스팅된 것 (PR, 이슈, 파일 blob, API 응답)은 웹 UI를 스크래핑하는 대신 `Bash`를 통해 `gh` CLI를 선호하십시오. `gh pr view`, `gh issue view`, `gh api`는 구조화된 데이터를 반환하며 비공개 저장소에 대해 작동합니다.
+- 가져온 페이지가 매우 크면 결과가 요약될 수 있습니다. 정확한 텍스트가 필요하면 리터럴 추출을 요청하도록 `prompt`를 좁히십시오.
+- URL당 자체 정리되는 15분 캐시가 적용됩니다. 하나의 세션 동안 동일한 페이지에 대한 반복 호출은 거의 즉시이지만 약간 오래된 콘텐츠를 반환할 수 있습니다. 신선도가 중요하면 프롬프트에 언급하거나 캐시를 기다리십시오.
+- 대상 호스트가 크로스 호스트 리다이렉트를 발행하면 도구는 특수 응답 블록에 새 URL을 반환하며 자동으로 따르지 않습니다. 여전히 콘텐츠를 원한다면 리다이렉트 대상으로 `WebFetch`를 다시 호출하십시오.
+- 프롬프트는 메인 어시스턴트보다 작고 빠른 모델에 의해 실행됩니다. 좁고 구체적으로 유지하십시오. 복잡한 다단계 추론은 가져온 후 원시 Markdown을 직접 읽어 처리하는 것이 더 낫습니다.
+- URL에 포함된 비밀, 토큰, 또는 세션 식별자를 전달하지 마십시오 — 출력에 반영된 페이지 내용과 쿼리 문자열은 업스트림 서비스에 의해 로그될 수 있습니다.

package/concepts/ko/Tool-WebSearch.md

@@ -1,58 +1,51 @@
 # WebSearch
 
-## 정의
+실시간 웹 검색을 수행하고 순위가 매겨진 결과를 반환합니다. 어시스턴트는 이를 사용하여 모델의 학습 컷오프를 넘어 현재 정보로 답변을 뒷받침합니다.
 
-검색 엔진 쿼리를 실행하여 최신 정보를 얻기 위한 검색 결과를 반환합니다.
+## 사용 시점
 
-## 파라미터
+- 시사, 최근 릴리스, 또는 속보에 대한 질문 답변.
+- 라이브러리, 프레임워크, 또는 CLI 도구의 최신 버전 조회.
+- 정확한 URL을 모를 때 문서나 블로그 게시물 찾기.
+- 모델이 훈련된 이후 변경되었을 수 있는 사실 확인.
+- `WebFetch`로 단일 페이지를 가져오기 전에 주제에 대한 여러 관점 발견.
 
-| 파라미터 | 타입 | 필수 | 설명 |
-|----------|------|------|------|
-| `query` | string | 예 | 검색 쿼리 (최소 2자) |
-| `allowed_domains` | string[] | 아니오 | 이 도메인의 결과만 포함 |
-| `blocked_domains` | string[] | 아니오 | 이 도메인의 결과를 제외 |
+## 매개변수
 
-## 사용 시나리오
+- `query` (string, 필수): 검색 쿼리. 최소 길이 2자. "최신" 또는 "최근" 정보에 대해 질문할 때 결과가 신선하도록 현재 연도를 포함하십시오.
+- `allowed_domains` (array of strings, 선택): 결과를 이러한 도메인으로만 제한합니다. 예를 들어 `["nodejs.org", "developer.mozilla.org"]`. 특정 소스를 신뢰할 때 유용합니다.
+- `blocked_domains` (array of strings, 선택): 이러한 도메인의 결과를 제외합니다. 동일한 도메인을 `allowed_domains`와 `blocked_domains` 모두에 전달하지 마십시오.
 
-**적합한 경우:**
-- 모델의 지식 컷오프 날짜를 넘는 최신 정보 획득
-- 현재 이벤트 및 최신 데이터 검색
-- 최신 기술 문서 검색
+## 예시
 
-## 주의사항
+### 예시 1: 현재 연도로 버전 조회
 
-- 검색 결과는 markdown 하이퍼링크 형식으로 반환
-- 사용 후 응답 끝에 "Sources:" 섹션을 추가하고 관련 URL을 나열해야 함
-- 도메인 필터링 (포함/제외) 지원
-- 검색 쿼리에 현재 연도를 사용해야 함
-- 미국에서만 사용 가능
+```
+WebSearch(
+  query="React 19 stable release date 2026",
+  allowed_domains=["react.dev", "github.com"]
+)
+```
 
-## 원문
+공식 발표를 반환하며 저품질 집계자 사이트를 피합니다.
 
-<textarea readonly>
-- Allows Claude to search the web and use the results to inform responses
-- Provides up-to-date information for current events and recent data
-- Returns search result information formatted as search result blocks, including links as markdown hyperlinks
-- Use this tool for accessing information beyond Claude's knowledge cutoff
-- Searches are performed automatically within a single API call
+### 예시 2: 노이즈가 많은 소스 제외
 
-CRITICAL REQUIREMENT - You MUST follow this:
-  - After answering the user's question, you MUST include a "Sources:" section at the end of your response
-  - In the Sources section, list all relevant URLs from the search results as markdown hyperlinks: [Title](URL)
-  - This is MANDATORY - never skip including sources in your response
-  - Example format:
+```
+WebSearch(
+  query="kubernetes ingress-nginx CVE April 2026",
+  blocked_domains=["pinterest.com", "medium.com"]
+)
+```
 
-    [Your answer here]
+결과를 벤더 권고 및 보안 추적기에 집중시킵니다.
 
-    Sources:
-    - [Source Title 1](https://example.com/1)
-    - [Source Title 2](https://example.com/2)
+## 참고사항
 
-Usage notes:
-  - Domain filtering is supported to include or block specific websites
-  - Web search is only available in the US
-
-IMPORTANT - Use the correct year in search queries:
-  - The current month is March 2026. You MUST use this year when searching for recent information, documentation, or current events.
-  - Example: If the user asks for "latest React docs", search for "React documentation" with the current year, NOT last year
-</textarea>
+- 답변에서 `WebSearch`를 사용할 때 `[Title](URL)` 형식의 Markdown 하이퍼링크로 각 인용 결과를 나열하는 `Sources:` 섹션을 응답 끝에 추가해야 합니다. 이것은 선택 사항이 아닌 필수 요구사항입니다.
+- `WebSearch`는 미국 내 사용자에게만 제공됩니다. 지역에서 도구를 사용할 수 없는 경우 알려진 URL에 대해 `WebFetch`로 대체하거나 사용자에게 관련 콘텐츠를 붙여 넣도록 요청하십시오.
+- 각 호출은 단일 왕복으로 검색을 수행합니다 — 스트리밍하거나 페이지를 매길 수 없습니다. 첫 번째 결과 세트가 빗나가면 쿼리를 수정하십시오.
+- 도구는 전체 페이지 내용이 아닌 스니펫과 메타데이터를 반환합니다. 특정 히트를 깊이 읽으려면 반환된 URL로 `WebFetch`를 후속으로 사용하십시오.
+- CVE나 규정 준수와 같은 보안에 민감한 질문에 대해 권위 있는 소싱을 적용하려면 `allowed_domains`를 사용하고, 문서를 미러링하는 SEO 팜을 제거하려면 `blocked_domains`를 사용하십시오.
+- 쿼리를 짧고 키워드 중심으로 유지하십시오. 자연어 질문도 작동하지만 일차 소스가 아닌 대화형 답변을 반환하는 경향이 있습니다.
+- 검색 직관에 기반하여 URL을 발명하지 마십시오 — 항상 검색을 실행하고 도구가 실제로 반환한 것을 인용하십시오.

package/concepts/ko/Tool-Write.md

@@ -1,39 +1,35 @@
 # Write
 
-## 정의
+로컬 파일시스템에 새 파일을 생성하거나 기존 파일의 내용을 완전히 교체합니다. 대상 경로의 모든 것을 교체하기 때문에 진정한 생성이나 의도적인 전체 재작성에 예약되어야 합니다.
 
-로컬 파일 시스템에 내용을 씁니다. 파일이 이미 존재하면 덮어씁니다.
+## 사용 시점
 
-## 파라미터
+- 아직 존재하지 않는 새로운 소스 파일, 테스트, 또는 구성 생성
+- 처음부터 새로운 픽스처, 스냅샷, 또는 데이터 파일 생성
+- 증분 `Edit`가 처음부터 시작하는 것보다 복잡한 전체 재작성 수행
+- 사용자가 명시적으로 요청한 스키마, 마이그레이션, 또는 빌드 스크립트와 같은 아티팩트 생성
 
-| 파라미터 | 타입 | 필수 | 설명 |
-|----------|------|------|------|
-| `file_path` | string | 예 | 파일의 절대 경로 (절대 경로여야 함) |
-| `content` | string | 예 | 쓸 내용 |
+## 매개변수
 
-## 사용 시나리오
+- `file_path` (string, 필수): 쓸 파일의 절대 경로. 부모 디렉토리가 이미 존재해야 합니다.
+- `content` (string, 필수): 파일에 쓸 전체 텍스트. 이것이 전체 파일 본문이 됩니다.
 
-**적합한 경우:**
-- 새 파일 생성
-- 파일 내용을 완전히 재작성해야 하는 경우
+## 예시
 
-**적합하지 않은 경우:**
-- 파일 내 부분적인 내용 수정 — Edit를 사용해야 함
-- 문서 파일 (*.md)이나 README를 자발적으로 생성하지 말 것. 사용자가 명시적으로 요청한 경우를 제외
+### 예시 1: 새 헬퍼 모듈 생성
+`file_path: "/Users/me/app/src/utils/slugify.ts"`로 `Write`를 호출하고 `content`로 구현을 제공합니다. 파일이 아직 존재하지 않는지 확인한 후에만 사용하십시오.
 
-## 주의사항
+### 예시 2: 파생된 아티팩트 재생성
+스키마 소스가 변경된 후 새로 생성된 JSON을 `content`로 사용하여 하나의 `Write` 호출에서 `/Users/me/app/generated/schema.json`을 다시 씁니다.
 
-- 대상 파일이 이미 존재하면 먼저 Read로 읽어야 함. 그렇지 않으면 실패
-- 기존 파일의 전체 내용을 덮어씀
-- 기존 파일 편집에는 Edit를 우선 사용하고, Write는 새 파일 생성 또는 완전한 재작성에만 사용
+### 예시 3: 작은 픽스처 파일 교체
+모든 줄이 변경되는 일회용 테스트 픽스처의 경우 `Write`가 일련의 `Edit` 호출보다 더 명확할 수 있습니다. 먼저 파일을 읽고, 범위를 확인한 다음 덮어씁니다.
 
-## 원문
+## 참고사항
 
-<textarea readonly>Writes a file to the local filesystem.
-
-Usage:
-- This tool will overwrite the existing file if there is one at the provided path.
-- If this is an existing file, you MUST use the Read tool first to read the file's contents. This tool will fail if you did not read the file first.
-- Prefer the Edit tool for modifying existing files — it only sends the diff. Only use this tool to create new files or for complete rewrites.
-- NEVER create documentation files (*.md) or README files unless explicitly requested by the User.
-- Only use emojis if the user explicitly requests it. Avoid writing emojis to files unless asked.</textarea>
+- 기존 파일을 덮어쓰기 전에 현재 세션에서 `Read`를 호출해야 합니다. `Write`는 보지 않은 내용을 덮어쓰기를 거부합니다.
+- 파일의 일부만 건드리는 모든 변경에는 `Edit`를 선호하십시오. `Edit`는 차이점만 전송하며 더 빠르고 안전하고 검토하기 쉽습니다.
+- 사용자가 명시적으로 요청하지 않는 한 Markdown 문서, `README.md`, 또는 변경 로그 파일을 사전 대응적으로 생성하지 마십시오.
+- 사용자가 해당 스타일을 요청하지 않는 한 이모지, 마케팅 카피, 또는 장식 배너를 추가하지 마십시오.
+- 먼저 `Bash` `ls` 호출로 부모 디렉토리가 존재하는지 확인하십시오. `Write`는 중간 폴더를 생성하지 않습니다.
+- 지속되기를 원하는 대로 정확히 내용을 제공하십시오. 템플릿화나 후처리가 없습니다.