cc-viewer 1.7.22 → 1.8.0

package/concepts/ko/Tool-ListConnectors.md

@@ -0,0 +1,34 @@
+# ListConnectors
+
+사용자의 claude.ai 조직에 설치된 MCP 커넥터를 나열하며, 선택적으로 키워드로 필터링합니다.
+
+## 사용 시점
+
+- 새 커넥터를 제안하기 전에 이미 설치된 커넥터를 알아야 합니다.
+- 사용자가 자신의 조직에 어떤 통합이 있는지 묻습니다.
+
+## 활성화
+
+- 퍼스트파티 API의 원격(claude.ai) 세션에서만 사용할 수 있습니다.
+
+## 매개변수
+
+- `keywords` (array of strings, 선택): 목록 필터 — 최대 8개 항목, 각각 1-64자. 생략하면 전체를 나열합니다.
+
+## 예시
+
+### 예시 1: 설치된 모든 커넥터 나열
+
+```
+ListConnectors()
+```
+
+### 예시 2: 키워드로 필터링
+
+```
+ListConnectors(keywords=["github"])
+```
+
+## 참고사항
+
+- 전체 찾기-및-활성화 흐름을 위해 `SearchMcpRegistry`(발견)와 `SuggestConnectors`(상세 정보)를 함께 사용하십시오.

package/concepts/ko/Tool-ListMcpResources.md

@@ -0,0 +1,35 @@
+# ListMcpResources
+
+연결된 MCP 서버가 노출하는 리소스를 나열하며, 선택적으로 한 서버로 필터링합니다.
+
+## 사용 시점
+
+- 읽기 전에 MCP 서버가 제공하는 리소스(파일, 레코드, 문서)를 발견해야 합니다.
+- 연결된 모든 서버의 전체 리소스 개요를 원합니다.
+
+## 활성화
+
+- 항상 활성화되어 있지만 모델의 도구 목록에는 노출되지 않습니다 — 씬 클라이언트/사이드카 사용을 위한 것입니다.
+
+## 매개변수
+
+- `server` (string, 선택): 리소스를 필터링할 서버 이름. 생략하면 연결된 모든 서버의 리소스를 나열합니다.
+
+## 예시
+
+### 예시 1: 전체 나열
+
+```
+ListMcpResources()
+```
+
+### 예시 2: 한 서버의 리소스 나열
+
+```
+ListMcpResources(server="github")
+```
+
+## 참고사항
+
+- 이것은 발견 단계입니다: 흥미로운 URI를 `ReadMcpResource`(단일 리소스) 또는 `ReadMcpResourceDir`(디렉터리 목록)로 넣으십시오.
+- 서버는 세션 수명 동안 연결되고 해제됩니다. 서버가 방금 추가되었다면 다시 나열하십시오.

package/concepts/ko/Tool-ListPlugins.md

@@ -0,0 +1,35 @@
+# ListPlugins
+
+사용자의 활성화된 claude.ai 플러그인을 나열하며, 선택적으로 키워드로 필터링합니다.
+
+## 사용 시점
+
+- 이미 활성화된 플러그인을 알아야 합니다 — 예를 들어 `SuggestPluginInstall` 카드 후에 설치된 것을 확인하기 위해.
+- 사용자가 어떤 플러그인을 갖고 있는지 묻습니다.
+
+## 활성화
+
+- 플러그인 레지스트리 접근 권한이 필요합니다.
+- 사용 가능 여부는 세션 유형과 기능 롤아웃에 따라 다릅니다 — HIPAA 환경에서는 비활성화되고, 원격 세션에서는 항상 사용할 수 있습니다.
+
+## 매개변수
+
+- `keywords` (array of strings, 선택): 목록 필터 — 최대 8개 항목, 각각 1-64자. 생략하면 전체를 나열합니다.
+
+## 예시
+
+### 예시 1: 활성화된 플러그인 나열
+
+```
+ListPlugins()
+```
+
+### 예시 2: 키워드로 필터링
+
+```
+ListPlugins(keywords=["figma"])
+```
+
+## 참고사항
+
+- 플러그인 카탈로그에 도달할 수 없는 경우(forbidden), 도구는 실패하는 대신 경고와 함께 빈 목록으로 저하됩니다.

package/concepts/ko/Tool-ListSkills.md

@@ -0,0 +1,37 @@
+# ListSkills
+
+사용자의 활성화된 claude.ai 스킬을 나열하며, 선택적으로 키워드로 필터링합니다.
+
+## 사용 시점
+
+- 현재 활성화된 스킬의 권위 있는 목록이 필요합니다 — 스킬을 호출하기 전에, 또는 `SuggestSkills` 카드가 추가한 것을 확인하기 위해.
+- 사용자가 어떤 스킬을 갖고 있는지 묻습니다.
+
+## 활성화
+
+- 플러그인 레지스트리 접근 권한이 필요합니다.
+- HIPAA 환경에서는 비활성화됩니다.
+- 원격 세션에서는 항상 사용할 수 있습니다.
+
+## 매개변수
+
+- `keywords` (array of strings, 선택): 목록 필터 — 최대 8개 항목, 각각 1-64자. 생략하면 전체를 나열합니다.
+
+## 예시
+
+### 예시 1: 활성화된 스킬 나열
+
+```
+ListSkills()
+```
+
+### 예시 2: 키워드로 필터링
+
+```
+ListSkills(keywords=["review"])
+```
+
+## 참고사항
+
+- 카탈로그에 도달할 수 없는 경우(forbidden), 도구는 실패하는 대신 경고와 함께 빈 목록으로 저하됩니다.
+- 이것은 *활성화된* 스킬을 나열합니다. 사용자가 추가할 수 있는 스킬을 표시하려면 `SuggestSkills`를 사용하십시오.

package/concepts/ko/Tool-Monitor.md

@@ -10,6 +10,13 @@
 - 많은 반복에 걸쳐 특정 조건을 기다릴 때 (예: 학습 단계 마일스톤 또는 큐 소진)
 - 단순한 "완료까지 대기"에는 **사용하지 않는다** — 그 경우 `run_in_background`가 있는 `Bash`를 사용하면 프로세스 종료 시 완료 알림이 한 번 전송된다
 
+## 활성화
+
+- 기본적으로 꺼져 있습니다(서버 측 기능 플래그).
+- Amazon Bedrock, Google Cloud, Microsoft Foundry에서는 사용할 수 없습니다.
+- `DISABLE_TELEMETRY` 또는 `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC`이 설정되면 꺼집니다.
+- WebSocket 소스에는 Claude Code 2.1.195+가 필요합니다.
+
 ## 매개변수
 
 - `command` (문자열, 필수): 실행할 셸 명령 또는 스크립트. 표준 출력에 쓰인 각 줄이 독립적인 알림 이벤트가 된다. 프로세스가 종료되면 모니터가 끝난다.

package/concepts/ko/Tool-Projects.md

@@ -0,0 +1,46 @@
+# Projects
+
+사용자의 Claude 프로젝트 지식 베이스에 있는 프로젝트 문서를 관리합니다: 문서 읽기, 검색, 쓰기, 삭제, 또는 프로젝트 정보 가져오기.
+
+## 사용 시점
+
+- 문서(산출물, 노트, 참고 자료)를 사용자의 프로젝트에 영속화하여 세션이 끝나도 남도록 합니다.
+- 기존 프로젝트 문서를 읽거나 검색하여 현재 태스크를 이전 컨텍스트에 근거시키려고 합니다.
+- 로컬 파일을 그 내용을 컨텍스트에 로드하지 않고 프로젝트에 업로드합니다.
+- 오래된 프로젝트 문서를 제거합니다.
+
+## 매개변수
+
+- `method` (string, 필수): `project_info`, `project_read`, `project_search`, `project_write`, `project_delete` 중 하나.
+- `path` (string, 선택): `project_read`/`project_write`/`project_delete`의 경우: 문서 경로. `project_write`의 경우: 기존 경로는 그 자리에서 대체되고, 새 단순 파일명("/" 없음)은 `claude/<name>`으로 네임스페이스됩니다.
+- `content` (string, 선택): `project_write`의 경우: 인라인 문서 텍스트. `local_path`와 상호 배타적입니다.
+- `local_path` (string, 선택): `project_write`의 경우: 작업 디렉터리 안의 파일을 업로드 — 내용은 컨텍스트에 절대 들어오지 않습니다. `content`와 상호 배타적입니다.
+- `present_to_user` (boolean, 선택): `project_write`의 경우: 이 문서를 사용자가 봐야 하는 산출물로 표시합니다. 기본값 false. 일상적인 저장과 일괄 쓰기에는 설정하지 않은 채로 두십시오.
+- `query` (string, 선택): `project_search`의 경우: 지식 베이스 쿼리.
+- `n` (number, 선택): `project_search`의 경우: 히트 수 (기본값 5).
+
+## 예시
+
+### 예시 1: 산출물을 프로젝트에 쓰기
+
+```
+Projects(
+  method="project_write",
+  path="claude/migration-plan.md",
+  local_path="./migration-plan.md",
+  present_to_user=true
+)
+```
+
+로컬 파일의 내용을 컨텍스트로 끌어오지 않고 업로드하며, 사용자의 산출물로 표시합니다.
+
+### 예시 2: 지식 베이스 검색
+
+```
+Projects(method="project_search", query="authentication refresh tokens", n=5)
+```
+
+## 참고사항
+
+- `content`는 인라인으로 작성하는 텍스트용이고 `local_path`는 이미 디스크에 있는 모든 것용입니다 — 둘을 섞지 마십시오.
+- `present_to_user=true`는 아껴서 사용하십시오: 사용자가 요청했거나 반드시 조치해야 하는 문서 하나에만 사용하십시오.

package/concepts/ko/Tool-ProposeGoal.md

@@ -0,0 +1,43 @@
+# ProposeGoal
+
+세션의 검증 가능한 완료 목표를 제안합니다. 목표는 (기본적으로) 승인 대화상자로 사용자에게 표시되며, 일단 설정되면 나머지 대화를 확인 가능한 결과로 이끕니다.
+
+## 사용 시점
+
+- 세션에 평가자가 대화에서 확인할 수 있는 구체적인 종료 상태가 있습니다 (예: "all tests in test/auth pass").
+- 상당한 작업을 하기 전에 "완료"가 무엇을 의미하는지 사용자의 명시적인 동의를 얻고 싶습니다.
+- 사용자 자신의 말로 결과가 이미 명시되어 있고 이를 세션 목표로 기록하고 싶습니다.
+
+## 활성화
+
+- 기본적으로 꺼져 있습니다(서버 측 기능 플래그).
+- 대화형 및 백그라운드 세션에서 제외됩니다.
+- `modelProposedGoals: "disabled"` 설정 키로 꺼집니다.
+
+## 매개변수
+
+- `condition` (string, 필수): 별도의 평가자가 대화에서 확인할 수 있도록 작성된 완료 조건 (예: "all tests in test/auth pass (bun test exits 0)"). 최대 500자 — 승인 대화상자에서 사용자가 전체 조건을 읽을 수 있어야 합니다.
+- `ask_user` (boolean, 선택): 목표가 설정되기 전에 사용자에게 승인을 요청할지 여부. 기본값 true (승인 대화상자가 표시됨). 이 대화에서 사용자 자신의 말로 이 결과를 원한다고 명시한 경우에만 false로 설정하십시오. 목표는 가시적인 안내와 함께 직접 설정되고, 사용자는 `/goal clear`로 지울 수 있습니다.
+
+## 예시
+
+### 예시 1: 테스트로 뒷받침되는 목표 제안
+
+```
+ProposeGoal(condition="npm run test exits 0 with the new catalog cases included")
+```
+
+사용자는 승인 대화상자에서 조건을 보고 수락, 편집, 또는 거부할 수 있습니다.
+
+### 예시 2: 사용자가 명시한 결과 직접 채택
+
+```
+ProposeGoal(condition="the login form validates email format and shows an inline error", ask_user=false)
+```
+
+사용자가 대화에서 앞서 그 결과를 명시적으로 말했기 때문에 유효합니다.
+
+## 참고사항
+
+- `condition`을 짧고 객관적으로 확인 가능하게 유지하십시오 — 모호한 목표("더 좋게 만들기")는 목적을 무색하게 만듭니다.
+- `ask_user=false`는 사용자가 스스로 명시한 결과에만 엄격히 제한됩니다. 그 외의 모든 것은 승인 대화상자를 거쳐야 합니다.

package/concepts/ko/Tool-PushNotification.md

@@ -14,6 +14,12 @@
 
 작업 중 일상적인 진행 상황 업데이트에는 알림을 보내지 마십시오. 사용자가 방금 질문하고 명백히 기다리고 있는 경우에도 마찬가지입니다. 짧은 작업이 완료되었을 때도 알림은 불필요합니다. 사용자가 제출 직후 기다리고 있다면 알림은 아무 가치가 없고, 이후 알림에 대한 신뢰만 떨어뜨립니다. 기본적으로 보내지 않는 방향으로 강하게 권장합니다.
 
+## 활성화
+
+- 기본적으로 꺼져 있습니다(서버 측 기능 플래그).
+- 전송은 Anthropic 호스팅 인프라를 통해 이루어집니다 — Amazon Bedrock, AWS의 Claude Platform, Google Cloud, Microsoft Foundry에서는 사용할 수 없습니다.
+- 휴대폰 푸시는 추가로 연결된 원격 제어 클라이언트가 필요합니다.
+
 ## 매개변수
 
 - `message` (문자열, 필수): 알림 본문. 200자 이내로 유지하십시오. 모바일 운영체제는 긴 문자열을 잘라냅니다. 사용자가 행동을 취할 수 있는 내용으로 시작하십시오: "build failed: 2 auth tests"는 "task complete"보다 훨씬 유용합니다.

package/concepts/ko/Tool-REPL.md

@@ -0,0 +1,47 @@
+# REPL
+
+세션 내부의 영속적인 Node.js vm 컨텍스트에서 JavaScript를 실행합니다. 최상위 `await`가 지원되며, 한 호출에서 정의된 변수/함수는 이후 호출에서도 계속 사용할 수 있습니다.
+
+## 사용 시점
+
+- 셸 원라이너보다 코드로 작성하는 편이 쉬운 빠른 계산, 데이터 변환, 또는 JSON 다루기.
+- 호출 사이에 중간 상태(카운터, 누적 결과)가 유지되어야 하는 다단계 스크립팅.
+- 파일에 작성하기 전에 API나 라이브러리 동작을 대화형으로 탐색.
+
+## 활성화
+
+- 기본적으로 꺼져 있습니다 — 활성화하려면 `CLAUDE_CODE_REPL=true`를 설정하십시오.
+- 터미널(`cli`) 및 claude.ai(`remote`) 세션에서는 서버 측 기능 플래그가 이를 활성화할 수도 있습니다.
+- 꺼져 있으면 REPL은 모델의 도구 목록에서 숨겨집니다. 켜져 있으면 `Read`, `Glob`, `Grep`, `Bash`, `PowerShell`, `NotebookEdit`가 REPL 축약형으로 대체됩니다.
+
+## 매개변수
+
+- `code` (string, 필수): 실행할 JavaScript 코드. 최상위 await를 지원합니다. 상태는 호출 간에 유지됩니다.
+- `description` (string, 선택): 이 스크립트가 무엇을 하는지 능동태로 작성한 명확하고 간결한 설명 (5-10단어), 예: "Trace upgrade message to its GrowthBook flag".
+- `timeout` (number, 선택): 밀리초 단위 타임아웃. 기본값 30000, 최대 600000.
+
+## 예시
+
+### 예시 1: 계산하고 상태 재사용
+
+```
+REPL(code="const counts = new Map(); ['a','b','a'].forEach(k => counts.set(k, (counts.get(k)||0)+1)); counts.get('a')")
+```
+
+`2`를 반환합니다. `counts`는 같은 세션의 후속 REPL 호출에서 정의된 상태로 유지됩니다.
+
+### 예시 2: 더 긴 타임아웃과 함께 최상위 await
+
+```
+REPL(
+  code="const res = await fetch('https://example.com/api'); await res.json()",
+  description="Fetch example API and parse JSON",
+  timeout=60000
+)
+```
+
+## 참고사항
+
+- 상태는 세션 단위입니다: 세션을 재시작하면 모든 정의가 지워집니다.
+- 이것은 JavaScript(Node) 환경입니다 — 셸 명령, 파일시스템 중심 작업, 또는 비-JS 런타임에는 Bash를 사용하십시오.
+- 장시간 실행되는 코드는 명시적인 `timeout`을 설정해야 합니다. 기본 30초는 그보다 느린 모든 것을 종료시킵니다.

package/concepts/ko/Tool-ReadMcpResource.md

@@ -0,0 +1,32 @@
+# ReadMcpResource
+
+연결된 MCP(Model Context Protocol) 서버가 노출하는 단일 리소스를 URI로 지정하여 읽습니다.
+
+## 사용 시점
+
+- MCP 서버가 컨텍스트에 필요한 콘텐츠를 가진 리소스(파일, 레코드, 문서)를 광고합니다.
+- `ListMcpResources`, 서버 문서, 또는 이전 도구 결과에서 구체적인 리소스 URI를 알고 있습니다.
+
+## 활성화
+
+- 항상 활성화되어 있지만 모델의 도구 목록에는 노출되지 않습니다 — 씬 클라이언트/사이드카 사용을 위한 것입니다.
+
+## 매개변수
+
+- `server` (string, 필수): MCP 서버 이름.
+- `uri` (string, 필수): 읽을 리소스 URI.
+
+## 예시
+
+### 예시 1: URI로 서버 리소스 읽기
+
+```
+ReadMcpResource(server="github", uri="file:///repo/docs/architecture.md")
+```
+
+`github` MCP 서버가 제공하는 리소스 콘텐츠를 반환합니다.
+
+## 참고사항
+
+- 서버가 어떤 리소스를 노출하는지 모른다면 먼저 `ListMcpResources`를 사용하십시오. 디렉터리형 목록에는 `ReadMcpResourceDir`를 사용하십시오.
+- URI 스킴은 서버별로 다릅니다(`file://`, `https://`, 사용자 정의 스킴) — 대상 서버가 광고하는 것을 확인하십시오.

package/concepts/ko/Tool-ReadMcpResourceDir.md

@@ -0,0 +1,32 @@
+# ReadMcpResourceDir
+
+연결된 MCP 서버가 노출하는 디렉터리형 리소스의 항목을 URI로 지정하여 나열합니다.
+
+## 사용 시점
+
+- MCP 서버가 리소스를 계층적으로 구성하며 그 계층의 한 수준을 열거해야 합니다.
+- `ReadMcpResource`로 개별 리소스를 읽기 전에 탐색하고 싶습니다.
+
+## 활성화
+
+- 항상 활성화되어 있지만 모델의 도구 목록에는 노출되지 않습니다 — 씬 클라이언트/사이드카 사용을 위한 것입니다.
+
+## 매개변수
+
+- `server` (string, 필수): MCP 서버 이름.
+- `uri` (string, 필수): 나열할 디렉터리 리소스 URI.
+
+## 예시
+
+### 예시 1: 리소스 디렉터리 나열
+
+```
+ReadMcpResourceDir(server="filesystem", uri="file:///project/src/")
+```
+
+서버가 해당 디렉터리 URI 아래에서 노출하는 하위 항목을 반환합니다.
+
+## 참고사항
+
+- 리소스를 디렉터리로 모델링하는 서버만 이를 지원합니다. 평면적인 서버는 오류 또는 빈 목록을 반환합니다 — `ListMcpResources`로 폴백하십시오.
+- `ReadMcpResource`와 결합하여 관련 있어 보이는 항목으로 파고드십시오.

package/concepts/ko/Tool-ReadNotifications.md

@@ -0,0 +1,27 @@
+# ReadNotifications
+
+현재 세션에서 어시스턴트에게 대기 중인 알림을 읽습니다 — 구독한 PR의 GitHub 활동(`github_webhook`), 스케줄된 트리거 발화(`trigger_fire`), 그리고 다른 Claude 세션에서 도착한 메시지(`mcp_send_message`).
+
+## 사용 시점
+
+- 무언가 일어났다는 알림을 받았고(구독한 PR 업데이트, 스케줄된 트리거 발화, 다른 세션의 메시지) 실제 페이로드가 필요합니다.
+- 백로그 소진: 큰 배치는 부분적으로 반환되므로, 결과가 0 `remaining`을 보고할 때까지 계속 호출하십시오.
+
+## 매개변수
+
+이 도구는 매개변수를 받지 않습니다.
+
+## 예시
+
+### 예시 1: 보류 중인 알림 소진
+
+```
+ReadNotifications()
+```
+
+대기 중인 알림을 가장 오래된 것부터 반환합니다. 결과에는 이번 소진 후에도 여전히 대기 중인 알림의 `remaining` 개수가 포함됩니다 — 나머지를 읽으려면 도구를 다시 호출하십시오.
+
+## 참고사항
+
+- 소진은 크기 예산이 정해져 있습니다: 후속 호출은 새 도착분만이 아니라 같은 큐의 나머지(새로 도착한 것을 더한)를 반환합니다. `remaining`이 0이 될 때까지 반복하십시오.
+- 알림은 구독한 PR의 GitHub 웹훅, 스케줄된 트리거, 그리고 다른 Claude 세션의 메시지에서 발생합니다. 현재 버전에는 필터링 매개변수가 없습니다.

package/concepts/ko/Tool-RemoteTrigger.md

@@ -10,6 +10,13 @@ claude.ai 원격 트리거 API를 호출하여 예약된 작업과 온디맨드
 - 모든 현재 트리거를 나열하거나 감사하여 구성 및 상태 검토
 - 트리거를 재생성하지 않고 일정, 페이로드 또는 설명과 같은 트리거 설정 업데이트
 
+## 활성화
+
+- claude.ai Pro, Max, Team, 또는 Enterprise 플랜이 필요합니다.
+- Amazon Bedrock, AWS의 Claude Platform, Google Cloud, Microsoft Foundry에서는 사용할 수 없습니다.
+- 서버 측 기능 플래그와 `allow_remote_sessions` / `allow_routines` 정책 설정이 필요합니다.
+- 원격 세션 자체를 위한 것이 아닙니다.
+
 ## 매개변수
 
 - `action` (string, 필수): 수행할 작업 — `list`, `get`, `create`, `update`, `run` 중 하나

package/concepts/ko/Tool-ScheduleWakeup.md

@@ -10,6 +10,11 @@
 - 사용자 프롬프트 없이 자율 루프를 실행할 때 — 리터럴 센티널 `<<autonomous-loop-dynamic>>`을 `prompt`로 전달
 - 곧 상태가 변경될 프로세스를 폴링할 때 (짧은 지연으로 캐시를 워밍 상태로 유지)
 
+## 활성화
+
+- Amazon Bedrock, AWS의 Claude Platform, Google Cloud Agent Platform, Microsoft Foundry에서는 사용할 수 없습니다.
+- 기능 플래그 가져오기가 비활성화된 경우에도 꺼집니다(텔레메트리/트래픽 환경 변수).
+
 ## 매개변수
 
 - `delaySeconds` (숫자, 필수): 재개까지의 초 단위 시간. 런타임이 값을 자동으로 `[60, 3600]` 범위로 클램프하므로 직접 클램프할 필요가 없습니다.

package/concepts/ko/Tool-SearchMcpRegistry.md

@@ -0,0 +1,31 @@
+# SearchMcpRegistry
+
+MCP 커넥터 레지스트리를 키워드로 검색하여 태스크 완료에 도움이 될 커넥터를 발견합니다.
+
+## 사용 시점
+
+- 태스크가 외부 서비스(데이터베이스, 이슈 트래커, SaaS API)의 이점을 얻을 수 있고, 이를 위한 MCP 커넥터가 존재하는지 확인하고 싶습니다.
+- 사용자가 제품 이름을 말하며 연결을 요청합니다 — 일치하는 커넥터를 레지스트리에서 검색하십시오.
+
+## 활성화
+
+- 퍼스트파티 API의 원격(claude.ai) 세션에서만 사용할 수 있습니다.
+
+## 매개변수
+
+- `keywords` (array of strings, 필수): 사용자의 의도 또는 명명된 제품을 설명하는 키워드 구절. 1-8개 항목, 각각 1-64자.
+
+## 예시
+
+### 예시 1: 명명된 제품의 커넥터 찾기
+
+```
+SearchMcpRegistry(keywords=["linear", "issue tracker"])
+```
+
+커넥터가 키워드와 일치하는 레지스트리 항목을 반환합니다. `SuggestConnectors`로 전체 커넥터 상세 정보를 확인하십시오.
+
+## 참고사항
+
+- 읽기 전용이며 동시성에 안전합니다. 결과 크기는 제한됩니다.
+- 검색은 아무것도 설치하지 않습니다 — 순수한 발견입니다.

package/concepts/ko/Tool-SendFeedback.md

@@ -0,0 +1,38 @@
+# SendFeedback
+
+버그 리포트, 기능 아이디어, 누락된 기능 등 Claude Code에 대한 구조화된 피드백을 세션을 떠나지 않고 Anthropic으로 전송합니다.
+
+## 사용 시점
+
+- 사용자가 Claude Code 자체에 대한 버그 리포트나 피드백 전송을 요청합니다.
+- 보고할 가치가 있는 명확한 제품 결함(고장난 명령, 잘못된 동작, 크래시)을 발견했습니다.
+- 사용자가 존재했으면 하는 기능(아이디어 또는 누락된 기능)을 설명합니다.
+
+## 매개변수
+
+- `type` (string, 필수): `bug`, `idea`, `missing_capability` 중 하나.
+- `title` (string, 필수): 문제에 대한 짧고 구체적인 한 줄 요약.
+- `details` (string, 필수): 라벨이 붙은 글머리 항목을 다음 순서로 작성합니다: **What happened:** (관찰된 것 vs 기대한 것, 짧다면 정확한 오류 텍스트); **What the user said:** (인용, 또는 "User didn't comment; observed by the model."); **Repro:** (최소 재현 단계); **Evidence:** (요청 ID, 타임스탬프, 경로, 버전 — 없으면 생략); 선택적으로 마지막에 **Cause:** — 세션 내에서 검증된 경우에만. 글머리당 1~3줄; 서술형 문단, 추측, 비밀 정보 없음.
+- `area` (string, 선택): 이 피드백이 다루는 Claude Code 부분을 명명하는 짧은 태그 (예: "hooks config", "/help", "file editing"). 불분명하면 비워 두십시오.
+- `failure_mode` (string, 선택): 모델 동작 리포트의 경우 가장 가까운 실패 모드 (예: `instruction_following`, `repetition_and_looping`, `context_and_memory`, `stopping_short`, 또는 `other`). 리포트가 순수한 제품/도구 버그일 때만 생략하십시오.
+- `task_category` (string, 선택): 문제 발생 시 세션이 수행 중이던 작업: `code_edit`, `debug`, `explain`, `plan`, `shell`, `search`, `review`, 또는 `other`.
+
+## 예시
+
+### 예시 1: 제품 버그 리포트
+
+```
+SendFeedback(
+  type="bug",
+  title="/export truncates the last message",
+  details="**What happened:** exported transcript is missing the final assistant message.\n**What the user said:** \"the last reply never shows up in the file\".\n**Repro:** run /export after any multi-turn session.\n**Evidence:** v2.1.233, macOS.",
+  area="/export",
+  task_category="other"
+)
+```
+
+## 참고사항
+
+- `details`에 비밀, 토큰, 또는 개인 사용자 데이터를 포함하지 마십시오.
+- 가능하면 사용자의 말을 인용하고, 그렇지 않으면 모델이 문제를 관찰했다고 명시하십시오.
+- 리포트를 사실 기반으로 유지하십시오 — 근본 원인에 대한 추측은 세션 내에서 검증된 경우에만 `**Cause:**`에 넣으십시오.

package/concepts/ko/Tool-SendFile.md

@@ -0,0 +1,36 @@
+# SendFile
+
+하나 이상의 파일을 다른 Claude Code 세션으로 전송합니다 — `ListAgents`에 나열된 피어, 또는 명시적인 세션 주소.
+
+## 사용 시점
+
+- 피어 세션이 자신의 태스크를 계속하기 위해 작업 디렉터리의 파일(리포트, 패치, 픽스처)이 필요합니다.
+- 세션 간에 작업을 조율하며 텍스트가 아닌 산출물을 넘기고 싶습니다(텍스트에는 `SendMessage`를 사용하십시오).
+
+## 활성화
+
+- 세션에서 세션 간 파일 전송이 사용 가능해야 합니다. 그렇지 않으면 "Cross-session file transfer is not available in this session."으로 검증이 실패합니다.
+- `ListAgents`와 동일한 세션 간 메시징 조건(서버 측 기능 플래그, 기본적으로 꺼짐)에 의해 게이트됩니다.
+
+## 매개변수
+
+- `to` (string, 필수): 수신자 — `ListAgents`의 피어 세션 이름, 또는 명시적인 `uds:<socket>` / `bridge:<session id>` 주소.
+- `files` (array of strings, 필수): 전송할 파일 경로(절대 경로 또는 cwd 기준). 단일 파일이라도 항상 배열을 전달하십시오. 1-16개 파일, 각각 최대 30 MiB.
+- `message` (string, 선택): 파일과 함께 전달되는 짧은 메시지.
+
+## 예시
+
+### 예시 1: 피어 세션에 리포트 전송
+
+```
+SendFile(
+  to="teammate-a",
+  files=["./dist/report.html"],
+  message="The analysis you asked for"
+)
+```
+
+## 참고사항
+
+- 원격 머신으로의 전송은 추가 승인이 필요할 수 있습니다.
+- 파일 내용 읽기는 전송의 일부입니다 — 권한 규칙으로 파일 읽기가 비활성화되어 있으면 거부됩니다.

package/concepts/ko/Tool-SendMessage.md

@@ -10,6 +10,11 @@
 - 팀 리더의 종료 요청이나 계획 승인 요청과 같은 프로토콜 프롬프트에 답장합니다.
 - 위임된 작업의 끝에서 루프를 닫아 리더가 항목을 완료로 표시할 수 있도록 합니다.
 
+## 활성화
+
+- `ListAgents`와 동일한 세션 간 메시징 조건(서버 측 기능 플래그, 기본적으로 꺼짐)에 의해 게이트됩니다.
+- 팀원은 추가로 실험적 에이전트 팀이 활성화되어 있어야 합니다.
+
 ## 매개변수
 
 - `to` (string, 필수): 팀에 등록된 대상 팀원의 `name`, 또는 모든 팀원에게 한 번에 브로드캐스트하려면 `*`.

package/concepts/ko/Tool-SendUserFile.md

@@ -0,0 +1,38 @@
+# SendUserFile
+
+하나 이상의 파일을 사용자에게 전송합니다 — 생성된 산출물, 스크린샷, 리포트 — 클라이언트가 이를 표시하는 방식을 제어할 수 있습니다.
+
+## 사용 시점
+
+- 사용자가 필요로 하는 파일(리포트, 이미지, HTML 페이지)을 만들었고 경로만 언급하지 않고 이를 내보내고 싶습니다.
+- 첨부 파일로 답장(`status="normal"`), 또는 사용자가 요청하지 않았지만 지금 봐야 하는 것을 선제적으로 표시(`status="proactive"`).
+
+## 활성화
+
+- 원격 제어 클라이언트가 연결되어 있거나 세션이 관리형 클라우드 환경(예: 웹의 Claude Code)에서 실행될 때만 사용할 수 있습니다.
+- Amazon Bedrock, Google Cloud, Microsoft Foundry에서는 사용할 수 없습니다.
+- 세션에서 파일 전송을 허용해야 합니다(설정/기능 게이트된 기능). brief 모드에서는 제공되지 않습니다.
+
+## 매개변수
+
+- `files` (array of strings, 필수): 사용자에게 전송할 파일 경로(절대 경로 또는 cwd 기준). 단일 파일이라도 항상 배열을 전달하십시오.
+- `caption` (string, 선택): 파일에 대한 짧은 캡션.
+- `status` (string, 필수): 사용자가 요청하지 않았지만 지금 봐야 하는 파일 — 생성된 산출물, 완료된 리포트 — 을 표시할 때는 `proactive`; 사용자가 방금 말한 것에 답장할 때는 `normal`.
+- `display` (string, 선택): `render`는 파일을 측면 패널에 인라인으로 엽니다(HTML, SVG, Mermaid, 이미지, PDF). `attach`는 다운로드 카드만 표시합니다(사용자가 저장하고 다른 곳에서 열 산출물). 생략하면 클라이언트가 파일 유형에 따라 결정합니다.
+
+## 예시
+
+### 예시 1: 생성된 리포트 전달
+
+```
+SendUserFile(
+  files=["./out/weekly-report.html"],
+  caption="Weekly usage report",
+  status="proactive",
+  display="render"
+)
+```
+
+## 참고사항
+
+- 사용자가 저장해서 다른 앱에서 여는 파일에는 `display="attach"`를, 즉시 봐야 하는 것에는 `render`를 선택하십시오.

package/concepts/ko/Tool-SendUserMessage.md

@@ -0,0 +1,38 @@
+# SendUserMessage
+
+사용자에게 메시지를 전송합니다 — brief 스타일 세션에서의 주요 가시적 출력 채널. 레거시 별칭 `Brief`로도 알려져 있습니다.
+
+## 사용 시점
+
+- 사용자가 방금 말한 것에 답장합니다(`status="normal"`).
+- 사용자가 요청하지 않았지만 지금 봐야 하는 것을 선제적으로 표시합니다 — 자리를 비운 동안 태스크 완료, 부딪힌 블로커, 요청되지 않은 상태 업데이트(`status="proactive"`).
+
+## 활성화
+
+- 기본적으로 대화형 세션에서 숨겨집니다. 대부분의 대화형 CLI 세션은 대신 사용자에게 직접 말합니다.
+- brief 모드 또는 서버 측 기능 플래그를 통해 활성화됩니다.
+
+## 매개변수
+
+brief 모드에서:
+
+- `message` (string, 필수): 사용자에게 보낼 메시지. markdown 형식을 지원합니다.
+- `attachments` (array, 선택): 메시지와 함께 표시되는 첨부 파일. 각 항목은 로컬에서 읽을 수 있는 파일의 파일 경로(절대 경로 또는 cwd 기준), 또는 `attach_file`과 같은 장치 도구에서 얻은 미리 해석된 `{file_uuid, file_name, size, is_image}` 객체입니다.
+- `status` (string, 필수): 사용자가 지금 필요로 하는 요청되지 않은 업데이트는 `proactive`; 사용자에게 답장할 때는 `normal`.
+
+non-brief 빌드에서는 `message`만 사용할 수 있습니다.
+
+## 예시
+
+### 예시 1: 선제적 완료 알림
+
+```
+SendUserMessage(
+  message="The migration finished — 42 files updated, tests green.",
+  status="proactive"
+)
+```
+
+## 참고사항
+
+- `proactive`는 아껴서 사용하십시오 — 지금 정말 사용자의 주의가 필요한 것에만 쓰입니다.