cc-viewer 1.2.1 → 1.2.3

package/concepts/ko/Tool-Bash.md

@@ -0,0 +1,47 @@
+# Bash
+
+## 정의
+
+셸 명령을 실행하며, 선택적 타임아웃 설정을 지원합니다. 작업 디렉토리는 명령 간에 유지되지만, 셸 상태 (환경 변수 등)는 유지되지 않습니다.
+
+## 파라미터
+
+| 파라미터 | 타입 | 필수 | 설명 |
+|----------|------|------|------|
+| `command` | string | 예 | 실행할 bash 명령 |
+| `description` | string | 아니오 | 명령의 간단한 설명 |
+| `timeout` | number | 아니오 | 타임아웃 (밀리초), 최대 600000, 기본값 120000 |
+| `run_in_background` | boolean | 아니오 | 백그라운드에서 실행 여부 |
+
+## 사용 시나리오
+
+**적합한 경우:**
+- git 작업 (commit, push, branch 등)
+- npm/yarn 등 패키지 관리 명령
+- docker 작업
+- 컴파일, 빌드 명령
+- 디렉토리 내용 목록 표시 (`ls`)
+- 기타 셸 실행이 필요한 시스템 명령
+
+**적합하지 않은 경우:**
+- 파일 읽기 — Read를 사용해야 함
+- 파일명 검색 — Glob를 사용해야 함
+- 파일 내용 검색 — Grep를 사용해야 함
+- 파일 편집 — Edit를 사용해야 함
+- 파일 쓰기 — Write를 사용해야 함
+- 사용자에게 정보 출력 — 응답 텍스트에 직접 출력
+- 장시간 실행 프로세스 (dev server, watch 모드) — 사용자에게 수동 실행 권장
+
+## 주의사항
+
+- 공백이 포함된 경로는 큰따옴표로 감싸야 함
+- 출력이 30000자를 초과하면 잘림
+- 백그라운드 실행 명령은 TaskOutput으로 결과 획득
+- 가능한 절대 경로를 사용하고 `cd`를 피할 것
+- 독립적인 명령은 여러 Bash를 병렬 호출 가능
+- 의존 관계가 있는 명령은 `&&`로 연결
+- 셸 환경은 사용자의 profile (bash 또는 zsh)에서 초기화
+
+## cc-viewer에서의 의의
+
+Bash 호출은 요청 로그에서 `tool_use` (명령 포함)와 `tool_result` (출력 포함) content block 쌍으로 나타납니다. 명령 실행 출력은 모델의 작업 행동 분석에 사용할 수 있습니다.

package/concepts/ko/Tool-Edit.md

@@ -0,0 +1,38 @@
+# Edit
+
+## 정의
+
+정확한 문자열 치환을 통한 파일 편집. 파일 내의 `old_string`을 `new_string`으로 치환합니다.
+
+## 파라미터
+
+| 파라미터 | 타입 | 필수 | 설명 |
+|----------|------|------|------|
+| `file_path` | string | 예 | 수정할 파일의 절대 경로 |
+| `old_string` | string | 예 | 치환할 원본 텍스트 |
+| `new_string` | string | 예 | 치환 후 새 텍스트 (old_string과 달라야 함) |
+| `replace_all` | boolean | 아니오 | 모든 매치를 치환할지 여부, 기본값 `false` |
+
+## 사용 시나리오
+
+**적합한 경우:**
+- 기존 파일 내 특정 코드 섹션 수정
+- 버그 수정, 로직 업데이트
+- 변수 이름 변경 (`replace_all: true`와 함께 사용)
+- 파일 내용을 정확하게 수정해야 하는 모든 시나리오
+
+**적합하지 않은 경우:**
+- 새 파일 생성 — Write를 사용해야 함
+- 대규모 재작성 — Write로 전체 파일을 덮어써야 할 수 있음
+
+## 주의사항
+
+- 사용 전 반드시 Read로 해당 파일을 읽어야 하며, 그렇지 않으면 오류 발생
+- `old_string`은 파일 내에서 유일해야 함. 유일하지 않으면 더 많은 컨텍스트를 포함하여 유일하게 만들거나 `replace_all`을 사용
+- 텍스트 편집 시 원본 들여쓰기 (tab/공백)를 유지해야 함. Read 출력의 행 번호 접두사를 포함하지 말 것
+- 새 파일 생성보다 기존 파일 편집을 우선
+- `new_string`은 `old_string`과 달라야 함
+
+## cc-viewer에서의 의의
+
+Edit 호출은 요청 로그에서 `tool_use` content block으로 나타나며, `input`에 `old_string`과 `new_string`이 포함됩니다. 모델이 파일에 대해 수행한 변경 사항을 추적하는 데 사용할 수 있습니다.

package/concepts/ko/Tool-EnterPlanMode.md

@@ -0,0 +1,43 @@
+# EnterPlanMode
+
+## 정의
+
+Claude Code를 계획 모드로 전환하여, 구현 전에 코드베이스를 탐색하고 방안을 설계하는 데 사용합니다.
+
+## 파라미터
+
+파라미터 없음.
+
+## 사용 시나리오
+
+**적합한 경우:**
+- 새 기능 구현 — 아키텍처 결정이 필요
+- 여러 실행 가능한 방안이 존재 — 사용자 선택이 필요
+- 코드 변경이 기존 동작이나 구조에 영향
+- 다중 파일 변경 — 2~3개 이상의 파일에 걸칠 가능성
+- 요구사항이 불명확 — 먼저 탐색하여 범위를 이해해야 함
+- 사용자 선호가 중요 — 구현에 여러 합리적인 방향이 있음
+
+**적합하지 않은 경우:**
+- 1줄 또는 소수 줄의 수정 (오타, 명백한 버그)
+- 사용자가 매우 구체적인 지시를 제공한 경우
+- 순수 조사/탐색 태스크 — Task (Explore 타입)를 사용해야 함
+
+## 계획 모드에서의 동작
+
+계획 모드에 진입하면 Claude Code는:
+1. Glob, Grep, Read 도구를 사용하여 코드베이스를 깊이 탐색
+2. 기존 패턴과 아키텍처를 이해
+3. 구현 방안을 설계
+4. 방안을 사용자 승인에 제출
+5. 필요 시 AskUserQuestion으로 확인
+6. 방안이 준비되면 ExitPlanMode로 종료
+
+## 주의사항
+
+- 이 도구는 계획 모드 진입을 위해 사용자 동의가 필요
+- 계획이 필요한지 확실하지 않으면 계획하는 쪽으로 기울일 것 — 사전 조율이 재작업보다 나음
+
+## cc-viewer에서의 의의
+
+EnterPlanMode 호출은 요청 로그에서 `tool_use` content block으로 나타납니다. 계획 모드 진입 후의 요청 시퀀스는 보통 탐색적 도구 호출 (Glob, Grep, Read)이 중심이 되며, ExitPlanMode가 호출될 때까지 계속됩니다.

package/concepts/ko/Tool-ExitPlanMode.md

@@ -0,0 +1,39 @@
+# ExitPlanMode
+
+## 정의
+
+계획 모드를 종료하고 방안을 사용자 승인에 제출합니다. 방안 내용은 이전에 작성된 계획 파일에서 읽어옵니다.
+
+## 파라미터
+
+| 파라미터 | 타입 | 필수 | 설명 |
+|----------|------|------|------|
+| `allowedPrompts` | array | 아니오 | 구현 방안에 필요한 권한 설명 목록 |
+
+`allowedPrompts` 배열의 각 요소:
+
+| 필드 | 타입 | 필수 | 설명 |
+|------|------|------|------|
+| `tool` | enum | 예 | 적용할 도구, 현재 `Bash`만 지원 |
+| `prompt` | string | 예 | 작업의 의미적 설명 (예: "run tests", "install dependencies") |
+
+## 사용 시나리오
+
+**적합한 경우:**
+- 계획 모드에서 방안이 완성되어 사용자 승인에 제출할 준비가 됨
+- 코드를 작성해야 하는 구현 태스크에만 사용
+
+**적합하지 않은 경우:**
+- 순수 조사/탐색 태스크 — 계획 모드를 종료할 필요 없음
+- 사용자에게 "방안이 괜찮으신가요?"라고 묻고 싶은 경우 — 이것이 바로 이 도구의 기능이므로 AskUserQuestion으로 묻지 말 것
+
+## 주의사항
+
+- 이 도구는 방안 내용을 파라미터로 받지 않음 — 이전에 작성된 계획 파일에서 읽어옴
+- 사용자는 계획 파일의 내용을 보고 승인함
+- 이 도구를 호출하기 전에 AskUserQuestion으로 "방안이 괜찮은지" 묻지 말 것. 중복됨
+- 질문에서 "계획"을 언급하지 말 것. 사용자는 ExitPlanMode 전에 계획 내용을 볼 수 없기 때문
+
+## cc-viewer에서의 의의
+
+ExitPlanMode 호출은 계획 단계의 종료를 나타냅니다. 요청 로그에서 이 호출 이후의 요청은 보통 구현적 작업 (Edit, Write, Bash 등)으로 전환됩니다.

package/concepts/ko/Tool-Glob.md

@@ -0,0 +1,34 @@
+# Glob
+
+## 정의
+
+빠른 파일명 패턴 매칭 도구로, 모든 규모의 코드베이스를 지원합니다. 수정 시간순으로 정렬된 매칭 파일 경로를 반환합니다.
+
+## 파라미터
+
+| 파라미터 | 타입 | 필수 | 설명 |
+|----------|------|------|------|
+| `pattern` | string | 예 | glob 패턴 (예: `**/*.js`, `src/**/*.ts`) |
+| `path` | string | 아니오 | 검색 디렉토리, 기본값은 현재 작업 디렉토리. "undefined"나 "null"을 전달하지 말 것 |
+
+## 사용 시나리오
+
+**적합한 경우:**
+- 파일명 패턴으로 파일 검색
+- 특정 타입의 모든 파일 검색 (예: 모든 `.tsx` 파일)
+- 특정 클래스 정의 (예: `class Foo`)를 찾을 때 먼저 파일 위치 파악
+- 단일 메시지 내에서 여러 Glob 호출을 병렬 실행 가능
+
+**적합하지 않은 경우:**
+- 파일 내용 검색 — Grep를 사용해야 함
+- 여러 라운드의 검색이 필요한 개방형 탐색 — Task (Explore 타입)를 사용해야 함
+
+## 주의사항
+
+- 표준 glob 구문 지원: `*`는 단일 레벨, `**`는 다중 레벨, `{}`는 다중 선택 매칭
+- 결과는 수정 시간순으로 정렬
+- Bash의 `find` 명령보다 권장
+
+## cc-viewer에서의 의의
+
+Glob 호출은 요청 로그에서 `tool_use` / `tool_result` content block 쌍으로 나타납니다. `tool_result`에는 매칭된 파일 경로 목록이 포함됩니다.

package/concepts/ko/Tool-Grep.md

@@ -0,0 +1,47 @@
+# Grep
+
+## 정의
+
+ripgrep 기반의 강력한 콘텐츠 검색 도구. 정규 표현식, 파일 타입 필터링, 다양한 출력 모드를 지원합니다.
+
+## 파라미터
+
+| 파라미터 | 타입 | 필수 | 설명 |
+|----------|------|------|------|
+| `pattern` | string | 예 | 정규 표현식 검색 패턴 |
+| `path` | string | 아니오 | 검색 경로 (파일 또는 디렉토리), 기본값은 현재 작업 디렉토리 |
+| `glob` | string | 아니오 | 파일명 필터 (예: `*.js`, `*.{ts,tsx}`) |
+| `type` | string | 아니오 | 파일 타입 필터 (예: `js`, `py`, `rust`), glob보다 효율적 |
+| `output_mode` | enum | 아니오 | 출력 모드: `files_with_matches` (기본값), `content`, `count` |
+| `-i` | boolean | 아니오 | 대소문자 구분 없는 검색 |
+| `-n` | boolean | 아니오 | 행 번호 표시 (content 모드만), 기본값 true |
+| `-A` | number | 아니오 | 매치 후 표시할 행 수 |
+| `-B` | number | 아니오 | 매치 전 표시할 행 수 |
+| `-C` / `context` | number | 아니오 | 매치 전후 표시할 행 수 |
+| `head_limit` | number | 아니오 | 출력 항목 수 제한, 기본값 0 (무제한) |
+| `offset` | number | 아니오 | 처음 N개 결과 건너뛰기 |
+| `multiline` | boolean | 아니오 | 다중 행 매칭 모드 활성화, 기본값 false |
+
+## 사용 시나리오
+
+**적합한 경우:**
+- 코드베이스에서 특정 문자열이나 패턴 검색
+- 함수/변수의 사용 위치 검색
+- 파일 타입으로 검색 결과 필터링
+- 매치 수 집계
+
+**적합하지 않은 경우:**
+- 파일명으로 파일 검색 — Glob를 사용해야 함
+- 여러 라운드의 검색이 필요한 개방형 탐색 — Task (Explore 타입)를 사용해야 함
+
+## 주의사항
+
+- ripgrep 구문 사용 (grep이 아님), 중괄호 등 특수 문자는 이스케이프 필요
+- `files_with_matches` 모드는 파일 경로만 반환하며 가장 효율적
+- `content` 모드는 매칭 행 내용을 반환하며 컨텍스트 행 지원
+- 다중 행 매칭은 `multiline: true` 설정 필요
+- Bash 내의 `grep`이나 `rg` 명령보다 항상 Grep 도구를 우선 사용
+
+## cc-viewer에서의 의의
+
+Grep 호출은 요청 로그에서 `tool_use` / `tool_result` content block 쌍으로 나타납니다. `tool_result`에는 검색 결과가 포함됩니다.

package/concepts/ko/Tool-NotebookEdit.md

@@ -0,0 +1,33 @@
+# NotebookEdit
+
+## 정의
+
+Jupyter notebook (.ipynb 파일) 내의 특정 셀을 치환, 삽입 또는 삭제합니다.
+
+## 파라미터
+
+| 파라미터 | 타입 | 필수 | 설명 |
+|----------|------|------|------|
+| `notebook_path` | string | 예 | notebook 파일의 절대 경로 |
+| `new_source` | string | 예 | 셀의 새 내용 |
+| `cell_id` | string | 아니오 | 편집할 셀 ID. 삽입 모드에서는 새 셀이 이 ID 뒤에 삽입됨 |
+| `cell_type` | enum | 아니오 | 셀 타입: `code` 또는 `markdown`. 삽입 모드에서 필수 |
+| `edit_mode` | enum | 아니오 | 편집 모드: `replace` (기본값), `insert`, `delete` |
+
+## 사용 시나리오
+
+**적합한 경우:**
+- Jupyter notebook 내의 코드 또는 markdown 셀 수정
+- notebook에 새 셀 추가
+- notebook 내의 셀 삭제
+
+## 주의사항
+
+- `cell_number`는 0 인덱스
+- `insert` 모드는 지정 위치에 새 셀을 삽입
+- `delete` 모드는 지정 위치의 셀을 삭제
+- 경로는 절대 경로여야 함
+
+## cc-viewer에서의 의의
+
+NotebookEdit 호출은 요청 로그에서 `tool_use` content block으로 나타나며, notebook에 대한 구체적인 변경 작업이 기록됩니다.

package/concepts/ko/Tool-Read.md

@@ -0,0 +1,41 @@
+# Read
+
+## 정의
+
+로컬 파일 시스템에서 파일 내용을 읽습니다. 텍스트 파일, 이미지, PDF, Jupyter notebook을 지원합니다.
+
+## 파라미터
+
+| 파라미터 | 타입 | 필수 | 설명 |
+|----------|------|------|------|
+| `file_path` | string | 예 | 파일의 절대 경로 |
+| `offset` | number | 아니오 | 시작 행 번호 (대용량 파일 분할 읽기용) |
+| `limit` | number | 아니오 | 읽기 행 수 (대용량 파일 분할 읽기용) |
+| `pages` | string | 아니오 | PDF 페이지 범위 (예: "1-5", "3", "10-20"), PDF에만 적용 |
+
+## 사용 시나리오
+
+**적합한 경우:**
+- 코드 파일, 설정 파일 등 텍스트 파일 읽기
+- 이미지 파일 보기 (Claude는 멀티모달 모델)
+- PDF 문서 읽기
+- Jupyter notebook 읽기 (모든 셀과 출력을 반환)
+- 여러 파일을 병렬로 읽어 컨텍스트 획득
+
+**적합하지 않은 경우:**
+- 디렉토리 읽기 — Bash의 `ls` 명령을 사용해야 함
+- 개방형 코드베이스 탐색 — Task (Explore 타입)를 사용해야 함
+
+## 주의사항
+
+- 경로는 절대 경로여야 하며 상대 경로 불가
+- 기본적으로 파일의 처음 2000행을 읽음
+- 2000자를 초과하는 행은 잘림
+- 출력은 `cat -n` 형식이며 행 번호는 1부터 시작
+- 대용량 PDF (10페이지 초과)는 `pages` 파라미터 지정 필수, 1회 최대 20페이지
+- 존재하지 않는 파일 읽기는 오류를 반환 (크래시하지 않음)
+- 단일 메시지 내에서 여러 Read를 병렬 호출 가능
+
+## cc-viewer에서의 의의
+
+Read 호출은 요청 로그에서 `tool_use` (호출)와 `tool_result` (반환 내용) content block 쌍으로 나타납니다. `tool_result`에는 파일의 실제 내용이 포함되며, 모델이 어떤 파일을 읽었는지 분석하는 데 사용할 수 있습니다.

package/concepts/ko/Tool-Skill.md

@@ -0,0 +1,35 @@
+# Skill
+
+## 정의
+
+메인 대화 내에서 스킬(skill)을 실행합니다. 스킬은 사용자가 slash command (예: `/commit`, `/review-pr`)로 호출할 수 있는 전용 기능입니다.
+
+## 파라미터
+
+| 파라미터 | 타입 | 필수 | 설명 |
+|----------|------|------|------|
+| `skill` | string | 예 | 스킬 이름 (예: "commit", "review-pr", "pdf") |
+| `args` | string | 아니오 | 스킬 인수 |
+
+## 사용 시나리오
+
+**적합한 경우:**
+- 사용자가 `/<skill-name>` 형식의 slash command를 입력한 경우
+- 사용자의 요청이 등록된 스킬의 기능과 매칭되는 경우
+
+**적합하지 않은 경우:**
+- 내장 CLI 명령 (예: `/help`, `/clear`)
+- 이미 실행 중인 스킬
+- 사용 가능한 스킬 목록에 없는 스킬 이름
+
+## 주의사항
+
+- 스킬이 호출되면 완전한 프롬프트로 확장됨
+- 완전 한정 이름 지원 (예: `ms-office-suite:pdf`)
+- 사용 가능한 스킬 목록은 system-reminder 메시지에서 제공
+- `<command-name>` 태그가 보이면 스킬이 이미 로드된 것이므로, 이 도구를 다시 호출하지 말고 직접 실행해야 함
+- 실제로 도구를 호출하지 않고 스킬을 언급하지 말 것
+
+## cc-viewer에서의 의의
+
+Skill 호출은 요청 로그에서 `tool_use` content block으로 나타납니다. 스킬 확장 후의 프롬프트는 후속 요청의 system prompt나 메시지 내용에 영향을 미칩니다.

package/concepts/ko/Tool-Task.md

@@ -0,0 +1,53 @@
+# Task
+
+## 정의
+
+서브 agent (SubAgent)를 시작하여 복잡한 다단계 태스크를 자율적으로 처리합니다. 서브 agent는 독립된 서브프로세스로, 각각 전용 도구 세트와 컨텍스트를 가집니다.
+
+## 파라미터
+
+| 파라미터 | 타입 | 필수 | 설명 |
+|----------|------|------|------|
+| `prompt` | string | 예 | 서브 agent가 실행할 태스크 설명 |
+| `description` | string | 예 | 3~5단어의 짧은 요약 |
+| `subagent_type` | string | 예 | 서브 agent 타입, 사용 가능한 도구 세트를 결정 |
+| `model` | enum | 아니오 | 모델 지정 (sonnet / opus / haiku), 기본값은 부모로부터 상속 |
+| `max_turns` | integer | 아니오 | 최대 agentic 턴 수 |
+| `run_in_background` | boolean | 아니오 | 백그라운드 실행 여부. 백그라운드 태스크는 output_file 경로를 반환 |
+| `resume` | string | 아니오 | 재개할 agent ID, 이전 실행에서 계속 |
+| `isolation` | enum | 아니오 | 격리 모드, `worktree`로 임시 git worktree 생성 |
+
+## 서브 agent 타입
+
+| 타입 | 용도 | 사용 가능한 도구 |
+|------|------|------------------|
+| `Bash` | 명령 실행, git 작업 | Bash |
+| `general-purpose` | 범용 다단계 태스크 | 전체 도구 |
+| `Explore` | 코드베이스 빠른 탐색 | Task/Edit/Write/NotebookEdit/ExitPlanMode 외 모든 도구 |
+| `Plan` | 구현 방안 설계 | Task/Edit/Write/NotebookEdit/ExitPlanMode 외 모든 도구 |
+| `claude-code-guide` | Claude Code 사용 가이드 Q&A | Glob, Grep, Read, WebFetch, WebSearch |
+| `statusline-setup` | 상태 표시줄 설정 | Read, Edit |
+
+## 사용 시나리오
+
+**적합한 경우:**
+- 다단계로 자율 완료해야 하는 복잡한 태스크
+- 코드베이스 탐색 및 심층 조사 (Explore 타입 사용)
+- 격리 환경이 필요한 병렬 작업
+- 백그라운드 실행이 필요한 장시간 태스크
+
+**적합하지 않은 경우:**
+- 특정 파일 경로 읽기 — 직접 Read 또는 Glob 사용
+- 2~3개 알려진 파일 내 검색 — 직접 Read 사용
+- 특정 클래스 정의 검색 — 직접 Glob 사용
+
+## 주의사항
+
+- 서브 agent는 완료 후 단일 메시지를 반환하며, 그 결과는 사용자에게 보이지 않으므로 메인 agent가 전달해야 함
+- 단일 메시지 내에서 여러 병렬 Task 호출을 발행하여 효율 향상 가능
+- 백그라운드 태스크는 TaskOutput 도구로 진행 상황 확인
+- Explore 타입은 직접 Glob/Grep 호출보다 느리므로, 단순 검색으로 충분하지 않을 때만 사용
+
+## cc-viewer에서의 의의
+
+Task 호출은 SubAgent 요청 체인을 생성하며, 요청 목록에서 MainAgent와 독립된 서브 요청 시퀀스로 확인할 수 있습니다. SubAgent 요청은 보통 간결한 system prompt와 적은 도구 정의를 가지며, MainAgent와 뚜렷한 대비를 이룹니다.

package/concepts/ko/Tool-TaskCreate.md

@@ -0,0 +1,38 @@
+# TaskCreate
+
+## 정의
+
+구조화된 태스크 리스트 항목을 생성하여 진행 상황 추적, 복잡한 태스크 정리, 사용자에게 작업 진행 상황 표시에 사용합니다.
+
+## 파라미터
+
+| 파라미터 | 타입 | 필수 | 설명 |
+|----------|------|------|------|
+| `subject` | string | 예 | 짧은 태스크 제목, 명령형 사용 (예: "Fix authentication bug") |
+| `description` | string | 예 | 상세 설명, 컨텍스트와 수락 기준 포함 |
+| `activeForm` | string | 아니오 | 진행 중 표시할 현재 진행형 텍스트 (예: "Fixing authentication bug") |
+| `metadata` | object | 아니오 | 태스크에 첨부할 임의의 메타데이터 |
+
+## 사용 시나리오
+
+**적합한 경우:**
+- 복잡한 다단계 태스크 (3단계 이상)
+- 사용자가 여러 할 일 항목을 제공한 경우
+- 계획 모드에서 작업 추적
+- 사용자가 명시적으로 todo 리스트 사용을 요청
+
+**적합하지 않은 경우:**
+- 단일 간단한 태스크
+- 3단계 이내의 간단한 작업
+- 순수 대화 또는 정보 조회
+
+## 주의사항
+
+- 모든 새 태스크의 초기 상태는 `pending`
+- `subject`는 명령형 ("Run tests"), `activeForm`은 현재 진행형 ("Running tests") 사용
+- 생성 후 TaskUpdate로 의존 관계 (blocks/blockedBy) 설정 가능
+- 생성 전 TaskList를 호출하여 중복 태스크가 없는지 확인해야 함
+
+## cc-viewer에서의 의의
+
+TaskCreate는 Claude Code 내부의 태스크 관리 작업이며, 독립적인 API 요청을 생성하지 않습니다. 다만 Chat Mode에서 모델이 이 도구를 호출한 tool_use block을 확인할 수 있습니다.

package/concepts/ko/Tool-TaskGet.md

@@ -0,0 +1,35 @@
+# TaskGet
+
+## 정의
+
+태스크 ID로 태스크의 전체 상세 정보를 가져옵니다.
+
+## 파라미터
+
+| 파라미터 | 타입 | 필수 | 설명 |
+|----------|------|------|------|
+| `taskId` | string | 예 | 가져올 태스크 ID |
+
+## 반환 내용
+
+- `subject` — 태스크 제목
+- `description` — 상세 요구사항과 컨텍스트
+- `status` — 상태: `pending`, `in_progress` 또는 `completed`
+- `blocks` — 이 태스크에 의해 차단된 태스크 목록
+- `blockedBy` — 이 태스크를 차단하는 선행 태스크 목록
+
+## 사용 시나리오
+
+**적합한 경우:**
+- 작업 시작 전 태스크의 전체 설명과 컨텍스트 획득
+- 태스크의 의존 관계 이해
+- 태스크를 할당받은 후 전체 요구사항 획득
+
+## 주의사항
+
+- 태스크 획득 후 작업 시작 전에 `blockedBy` 목록이 비어 있는지 확인해야 함
+- TaskList로 모든 태스크의 요약 정보 확인
+
+## cc-viewer에서의 의의
+
+TaskGet은 내부 태스크 관리 작업이며, 독립적인 API 요청을 생성하지 않습니다.

package/concepts/ko/Tool-TaskList.md

@@ -0,0 +1,36 @@
+# TaskList
+
+## 정의
+
+태스크 리스트의 모든 태스크를 나열하여 전체 진행 상황과 사용 가능한 작업을 확인합니다.
+
+## 파라미터
+
+파라미터 없음.
+
+## 반환 내용
+
+각 태스크의 요약 정보:
+- `id` — 태스크 식별자
+- `subject` — 짧은 설명
+- `status` — 상태: `pending`, `in_progress` 또는 `completed`
+- `owner` — 담당자 (agent ID), 비어 있으면 미할당
+- `blockedBy` — 이 태스크를 차단하는 미완료 태스크 ID 목록
+
+## 사용 시나리오
+
+**적합한 경우:**
+- 사용 가능한 태스크 확인 (상태가 pending, owner 없음, 차단되지 않음)
+- 프로젝트 전체 진행 상황 확인
+- 차단된 태스크 검색
+- 태스크 완료 후 다음 태스크 검색
+
+## 주의사항
+
+- ID 순서대로 태스크를 처리하는 것을 우선 (최소 ID 우선). 초기 태스크가 보통 후속 태스크에 컨텍스트를 제공하기 때문
+- `blockedBy`가 있는 태스크는 의존이 해제될 때까지 인수할 수 없음
+- TaskGet으로 특정 태스크의 전체 상세 정보 획득
+
+## cc-viewer에서의 의의
+
+TaskList는 내부 태스크 관리 작업이며, 독립적인 API 요청을 생성하지 않습니다.

package/concepts/ko/Tool-TaskOutput.md

@@ -0,0 +1,34 @@
+# TaskOutput
+
+## 정의
+
+실행 중이거나 완료된 백그라운드 태스크의 출력을 가져옵니다. 백그라운드 셸, 비동기 agent, 원격 세션에 적용됩니다.
+
+## 파라미터
+
+| 파라미터 | 타입 | 필수 | 설명 |
+|----------|------|------|------|
+| `task_id` | string | 예 | 태스크 ID |
+| `block` | boolean | 예 | 태스크 완료까지 블로킹 대기 여부, 기본값 `true` |
+| `timeout` | number | 예 | 최대 대기 시간 (밀리초), 기본값 30000, 최대 600000 |
+
+## 사용 시나리오
+
+**적합한 경우:**
+- Task (`run_in_background: true`)로 시작한 백그라운드 agent의 진행 상황 확인
+- 백그라운드 Bash 명령의 실행 결과 획득
+- 비동기 태스크 완료를 기다리고 출력 획득
+
+**적합하지 않은 경우:**
+- 포그라운드 태스크 — 포그라운드 태스크는 직접 결과를 반환하므로 이 도구가 불필요
+
+## 주의사항
+
+- `block: true`는 태스크 완료 또는 타임아웃까지 블로킹
+- `block: false`는 논블로킹으로 현재 상태 확인
+- 태스크 ID는 `/tasks` 명령으로 검색 가능
+- 모든 태스크 타입에 적용: 백그라운드 셸, 비동기 agent, 원격 세션
+
+## cc-viewer에서의 의의
+
+TaskOutput 호출 자체는 API 요청을 생성하지 않습니다. Claude Code 내부의 태스크 관리 작업이며, 요청 로그에 표시되지 않습니다.

package/concepts/ko/Tool-TaskStop.md

@@ -0,0 +1,27 @@
+# TaskStop
+
+## 정의
+
+실행 중인 백그라운드 태스크를 중지합니다.
+
+## 파라미터
+
+| 파라미터 | 타입 | 필수 | 설명 |
+|----------|------|------|------|
+| `task_id` | string | 아니오 | 중지할 백그라운드 태스크 ID |
+| `shell_id` | string | 아니오 | 더 이상 사용되지 않음, `task_id`를 대신 사용 |
+
+## 사용 시나리오
+
+**적합한 경우:**
+- 더 이상 필요 없는 장시간 실행 태스크 종료
+- 잘못 시작한 백그라운드 태스크 취소
+
+## 주의사항
+
+- 성공 또는 실패 상태를 반환
+- `shell_id` 파라미터는 더 이상 사용되지 않으며, `task_id`를 사용해야 함
+
+## cc-viewer에서의 의의
+
+TaskStop 호출 자체는 API 요청을 생성하지 않으며, Claude Code 내부 태스크 관리 작업입니다.

package/concepts/ko/Tool-TaskUpdate.md

@@ -0,0 +1,49 @@
+# TaskUpdate
+
+## 정의
+
+태스크 리스트 내 특정 태스크의 상태, 내용 또는 의존 관계를 업데이트합니다.
+
+## 파라미터
+
+| 파라미터 | 타입 | 필수 | 설명 |
+|----------|------|------|------|
+| `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 목록 |
+
+## 상태 전이
+
+```
+pending → in_progress → completed
+```
+
+`deleted`는 모든 상태에서 전이 가능하며, 태스크를 영구 삭제합니다.
+
+## 사용 시나리오
+
+**적합한 경우:**
+- 작업 시작 시 태스크를 `in_progress`로 마킹
+- 작업 완료 후 태스크를 `completed`로 마킹
+- 태스크 간 의존 관계 설정
+- 요구사항 변경 시 태스크 내용 업데이트
+
+**중요 규칙:**
+- 태스크를 완전히 완료한 경우에만 `completed`로 마킹
+- 오류나 차단에 직면하면 `in_progress` 유지
+- 테스트 실패, 구현 불완전, 미해결 오류가 있으면 `completed`로 마킹 불가
+
+## 주의사항
+
+- 업데이트 전 TaskGet으로 태스크의 최신 상태를 가져와 오래된 데이터를 피할 것
+- 태스크 완료 후 TaskList를 호출하여 다음 사용 가능한 태스크 검색
+
+## cc-viewer에서의 의의
+
+TaskUpdate는 내부 태스크 관리 작업이며, 독립적인 API 요청을 생성하지 않습니다.