cc-viewer 1.6.182 → 1.6.183

package/concepts/th/Tool-TaskUpdate.md

@@ -1,123 +1,70 @@
 # TaskUpdate
 
-## คำจำกัดความ
+แก้ไข task ที่มีอยู่ — สถานะ, เนื้อหา, ownership, metadata, หรือ dependency edge นี่คือวิธีที่ task ก้าวหน้าผ่าน lifecycle และวิธีที่งานถูกส่งต่อระหว่าง Claude Code, teammate, และ subagent
 
-อัปเดตสถานะ เนื้อหา หรือความสัมพันธ์การพึ่งพาของงานในรายการงาน
+## เมื่อใดควรใช้
 
-## พารามิเตอร์
-
-| พารามิเตอร์ | ประเภท | จำเป็น | คำอธิบาย |
-|------|------|------|------|
-| `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 เพื่อค้นหางานถัดไปที่พร้อมทำ
+- เปลี่ยน task ผ่าน workflow สถานะขณะที่คุณทำงานบนมัน
+- อ้างสิทธิ์ task โดยกำหนดตัวเอง (หรือ agent อื่น) เป็น `owner`
+- ปรับแต่ง `subject` หรือ `description` เมื่อคุณเรียนรู้เพิ่มเกี่ยวกับปัญหา
+- บันทึก dependency ที่เพิ่งค้นพบด้วย `addBlocks` / `addBlockedBy`
+- แนบ `metadata` ที่มีโครงสร้าง เช่น external ticket ID หรือ hint ลำดับความสำคัญ
 
-## ข้อความต้นฉบับ
-
-<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
-
-- 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
-
-**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
+- `taskId` (string, required): Task ที่จะแก้ไข รับจาก `TaskList` หรือ `TaskCreate`
+- `status` (string, optional): หนึ่งใน `pending`, `in_progress`, `completed`, `deleted`
+- `subject` (string, optional): หัวข้อคำสั่งที่แทนที่
+- `description` (string, optional): description ละเอียดที่แทนที่
+- `activeForm` (string, optional): ข้อความ spinner ปัจจุบันกาลต่อเนื่องที่แทนที่
+- `owner` (string, optional): handle ของ agent หรือ teammate ที่รับผิดชอบ task
+- `metadata` (object, optional): Metadata key ที่ merge เข้า task ตั้งค่า key เป็น `null` เพื่อลบ
+- `addBlocks` (array of strings, optional): Task ID ที่ task นี้ block
+- `addBlockedBy` (array of strings, optional): Task ID ที่ต้องเสร็จก่อนตัวนี้
 
-## Fields You Can Update
+## Workflow สถานะ
 
-- **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
+Lifecycle เป็นเส้นตรงอย่างจงใจ: `pending` → `in_progress` → `completed` `deleted` เป็น terminal และใช้เพื่อ retract task ที่จะไม่ทำ
 
-## Status Workflow
+- ตั้ง `in_progress` ณ ขณะที่คุณเริ่มงานจริง ไม่ใช่ก่อน มีเพียง task เดียวในแต่ละครั้งควรเป็น `in_progress` สำหรับ owner ที่กำหนด
+- ตั้ง `completed` เฉพาะเมื่องานเสร็จสมบูรณ์ — acceptance criteria พบแล้ว, test ผ่าน, output เขียน หาก blocker ปรากฏ ให้คง task เป็น `in_progress` และเพิ่ม task ใหม่อธิบายสิ่งที่ต้องแก้
+- อย่า mark task เป็น `completed` เมื่อ test ล้มเหลว, implementation เป็นบางส่วน, หรือคุณพบ error ที่ยังไม่แก้
+- ใช้ `deleted` สำหรับ task ที่ยกเลิกหรือซ้ำ; อย่าเปลี่ยนจุดประสงค์ task สำหรับงานที่ไม่เกี่ยวข้อง
 
-Status progresses: `pending` → `in_progress` → `completed`
+## ตัวอย่าง
 
-Use `deleted` to permanently remove a task.
+### ตัวอย่างที่ 1
 
-## Staleness
+อ้างสิทธิ์ task และเริ่ม
 
-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"}
-```
+จบงานและบันทึก dependency follow-up
 
-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` merge ทีละ key; ส่ง `null` สำหรับ key จะลบ เรียก `TaskGet` ก่อนหากไม่แน่ใจเนื้อหาปัจจุบัน
+- `addBlocks` และ `addBlockedBy` เพิ่ม edge; ไม่ลบของเดิม การแก้ graph แบบทำลายต้องใช้ workflow เฉพาะ — ปรึกษา owner ของทีมก่อนเขียน dependency ใหม่
+- รักษา `activeForm` ให้ sync เมื่อคุณเปลี่ยน `subject` เพื่อให้ข้อความ spinner ยังอ่านเป็นธรรมชาติ
+- อย่า mark task เป็น `completed` เพื่อปิดเสียง หากผู้ใช้ยกเลิกงาน ให้ใช้ `deleted` พร้อมเหตุผลสั้นใน `description`
+- อ่านสถานะล่าสุดของ task ด้วย `TaskGet` ก่อนอัปเดต — teammate อาจเปลี่ยนมันระหว่างการอ่านครั้งก่อนและการเขียนของคุณ

package/concepts/th/Tool-TeamCreate.md

@@ -1,38 +1,53 @@
 # TeamCreate
 
-## คำจำกัดความ
+จัดตั้งทีมร่วมงานใหม่พร้อม task list ที่แชร์และช่องทางส่งข้อความระหว่าง agent ทีมเป็น primitive การประสานงานสำหรับงานหลาย agent — session หลักทำหน้าที่เป็น leader และ spawn teammate ที่มีชื่อผ่าน tool `Agent`
 
-สร้างทีมใหม่���พื่อประสานงาน agent หลายตัวที่ทำงานในโครงการ ทีมช่วยให้สามารถดำเนินงานแบบขนานได้ผ่านรายการงานที่แชร์ร่วมกันและการส่งข้อความระหว่าง agent
+## เมื่อใดควรใช้
+
+- ผู้ใช้ขอทีม swarm ฝูง หรือการทำงานร่วมกันหลาย agent อย่างชัดเจน
+- โปรเจกต์มีงานอิสระชัดเจนหลายสายที่ได้ประโยชน์จากผู้เชี่ยวชาญเฉพาะ (เช่น frontend, backend, test, doc)
+- คุณต้องการ task list แชร์ที่คงอยู่ซึ่ง agent หลายตัวอัปเดตขณะที่คืบหน้า
+- คุณต้องการ teammate ที่มีชื่อและระบุตำแหน่งได้ที่สามารถแลกเปลี่ยนข้อความผ่าน `SendMessage` แทนที่จะเป็นการเรียก subagent แบบ one-shot
+
+อย่าใช้สำหรับการค้นหามอบหมายเดียวหรือการ fan-out ขนานครั้งเดียว — การเรียก `Agent` ธรรมดาเบากว่าและเพียงพอ
 
 ## พารามิเตอร์
 
-| พารามิเตอร์ | ประเภท | จำเป็น | คำอธิบาย |
-|-------------|--------|--------|----------|
-| `team_name` | string | ใช่ | ชื่อสำหรับทีมใหม่ |
-| `description` | string | ไม่ | คำอธิบาย / วัตถุประสงค์ของทีม |
-| `agent_type` | string | ไม่ | ประเภท / บทบาทของหัวหน้���ทีม |
+- `team_name` (string, required): ตัวระบุเฉพาะของทีม ใช้เป็นชื่อ directory ภายใต้ `~/.claude/teams/` และเป็น argument `team_name` เมื่อ spawn teammate
+- `description` (string, required): ข้อความสั้นเกี่ยวกับเป้าหมายของทีม แสดงแก่ teammate ทุกคนเมื่อ spawn และเขียนลง team config
+- `agent_type` (string, optional): persona subagent เริ่มต้นที่ใช้กับ teammate ที่ไม่ override ค่าทั่วไปคือ `general-purpose`, `Explore`, หรือ `Plan`
+
+## ตัวอย่าง
+
+### ตัวอย่างที่ 1: สร้างทีม refactor
 
-## สิ่งที่ถูกสร้าง
+```
+TeamCreate(
+  team_name="refactor-crew",
+  description="Refactor the data access layer from raw SQL to Prisma, including migrations and tests.",
+  agent_type="general-purpose"
+)
+```
 
-- **ไฟล์การตั้งค่าทีม**: `~/.claude/teams/{team-name}/config.json` — เก็บรายชื่อสมาชิกและข้อมูลเมตา
-- **ไดเรกทอรีรายการงาน**: `~/.claude/tasks/{team-name}/` — รายการงานที่แชร์ร่วมกันสำหรับสมาชิกทีมทุกคน
+หลังสร้าง spawn teammate ด้วย `Agent` โดยใช้ `team_name: "refactor-crew"` และค่า `name` ที่แตกต่างกัน เช่น `db-lead`, `migrations`, และ `tests`
 
-ทีมมีความสัมพันธ์แบบ 1:1 กับรายการงาน
+### ตัวอย่างที่ 2: สร้างทีมสืบสวน
 
-## ขั้นตอนการทำงานของทีม
+```
+TeamCreate(
+  team_name="perf-investigation",
+  description="Identify and rank the top three performance regressions introduced in the last release.",
+  agent_type="Explore"
+)
+```
 
-1. **TeamCreate** — สร้างทีมและรายการงาน
-2. **TaskCreate** — กำหนดงานสำหรับทีม
-3. **Agent** (พร้อม `team_name` + `name`) — สร้างสมาชิกที่เข้าร่วมทีม
-4. **TaskUpdate** — มอบหมายงานให้สมาชิกผ่าน `owner`
-5. สมาชิกทำงานและสื่อสารผ่าน **SendMessage**
-6. ปิดสมาชิกเมื่อเสร็จสิ้น จากนั้น **TeamDelete** เพื่อทำความสะอาด
+Teammate ที่ spawn แต่ละตัวสืบทอด `Explore` เป็น persona เริ่มต้น ตรงกับธรรมชาติการสืบสวนแบบ read-only ของงาน
 
-## เครื่องมือที่เกี่ยวข้อง
+## หมายเหตุ
 
-| เครื่องมือ | วัตถุประสงค์ |
-|-----------|-------------|
-| `TeamDelete` | ลบทีมและไดเรกทอรีงาน |
-| `SendMessage` | การสื่อสารระหว่าง agent ภายในทีม |
-| `TaskCreate` / `TaskUpdate` / `TaskList` / `TaskGet` | จัดการรายการงานที่แชร์ร่วมกัน |
-| `Agent` | สร้างสมาชิกที่เข้าร่วมทีม |
+- สามารถนำทีมได้เพียงทีมเดียวในคราวเดียวจาก session ที่กำหนด จบหรือลบทีมปัจจุบันก่อนสร้างอีก
+- ทีมมี task list แชร์ 1:1 Leader เป็นเจ้าของการสร้าง การมอบหมาย และการปิด task; teammate อัปเดตสถานะของ task ที่พวกเขากำลังทำ
+- Team configuration ถูก persist ที่ `~/.claude/teams/{team_name}/config.json` และ directory task อยู่ข้างๆ ไฟล์เหล่านี้รอดข้าม session จนกว่าจะถูกลบชัดเจนด้วย `TeamDelete`
+- Teammate ถูก spawn โดยใช้ tool `Agent` ด้วย `team_name` ที่ match บวก `name` ที่แตกต่าง `name` กลายเป็นที่อยู่ที่ใช้โดย `SendMessage`
+- เลือก `team_name` ที่ปลอดภัยต่อ filesystem (ตัวอักษร ตัวเลข dash underscore) หลีกเลี่ยง space หรือ slash
+- เขียน `description` เพื่อให้ teammate ใหม่เอี่ยมที่อ่านเย็นๆ จะเข้าใจเป้าหมายของทีมโดยไม่ต้องการ context เพิ่ม มันกลายเป็นส่วนหนึ่งของ startup prompt ของ teammate ทุกคน

package/concepts/th/Tool-TeamDelete.md

@@ -1,30 +1,44 @@
 # TeamDelete
 
-## คำจำกัดความ
+รื้อทีมที่ active ในปัจจุบัน ลบ directory configuration ของมันและ directory task ที่แชร์ นี่คือคู่ตรงข้ามในการทำความสะอาดของ `TeamCreate` และโดยทั่วไปเรียกหลังเป้าหมายของทีมสำเร็จและ teammate ทุกคนปิดระบบแล้ว
 
-ลบทีมและไดเรกทอรีงานที่เกี่ยวข้องเมื่องานการทำงานร่วมกันแบบหลาย agent เสร็จสมบูรณ์ นี่คือส่วนการทำความสะอาดที่เป็นคู่ตรงข้ามกับ TeamCreate
+## เมื่อใดควรใช้
 
-## พฤติกรรม
+- ทีมเสร็จงานและส่งรายงานสุดท้ายให้ผู้ใช้แล้ว
+- ทีมถูกสร้างโดยผิดพลาดหรือขอบเขตเปลี่ยนไปมากจนเริ่มใหม่สะอาดกว่าการทำต่อ
+- คุณต้องสร้างทีมใหม่แต่ยังมีทีม active อยู่ — ลบทีมเก่าก่อน เพราะสามารถนำทีมได้เพียงทีมเดียวในคราวเดียว
+- ทีมเก่าค้างข้าม session และ persisted state ใต้ `~/.claude/teams/` ไม่จำเป็นแล้ว
 
-- ลบไดเรกทอรีทีม: `~/.claude/teams/{team-name}/`
-- ลบไดเรกทอรีงาน: `~/.claude/tasks/{team-name}/`
-- ล้างบริบทของทีมออกจากเซสชันปัจจุบัน
+อย่าเรียกขณะ teammate ยังรันอยู่ — ปิด teammate ก่อนผ่าน `SendMessage` ด้วย `shutdown_request` รอ `shutdown_response` ทุกตัวแล้วลบ
 
-**สำคัญ**: TeamDelete จะล้มเหลวหากทีมยังมีสมาชิกที่ยังทำงานอยู่ ต้องปิดสมาชิกอย่างถูกต้องก่อนผ่านคำขอปิดระบบของ SendMessage
+## พารามิเตอร์
 
-## การใช้งานทั่วไป
+`TeamDelete` ไม่รับ parameter ในการ invoke ทั่วไป มันทำงานบนทีมที่ active ในปัจจุบันซึ่งเป็นของ session ที่เรียก
 
-TeamDelete ถูกเรียกใช้ที่ท้ายขั้นตอนการทำงานของทีม:
+## ตัวอย่าง
 
-1. งานทั้งหมดเสร็จสมบูรณ์
-2. ปิดสมาชิกผ่าน `SendMessage` พร้อม `shutdown_request`
-3. **TeamDelete** ลบไดเรกทอรีทีมและงาน
+### ตัวอย่างที่ 1: Shutdown ตามปกติหลังสำเร็จ
 
-## เครื่องมือที่เกี่ยวข้อง
+1. Broadcast คำขอ shutdown ไปยังทีม:
+   ```
+   SendMessage(to="*", message={ "type": "shutdown_request" })
+   ```
+2. รอให้ teammate แต่ละคนตอบด้วย `shutdown_response`
+3. เรียก `TeamDelete()` เพื่อลบ directory ทีมและ directory task
 
-| เครื่องมือ | วัตถุประสงค์ |
-|-----------|-------------|
-| `TeamCreate` | สร้างทีมใหม่และรายการงาน |
-| `SendMessage` | สื่อสารกับสมาชิก / ส่งคำขอปิดระบบ |
-| `TaskCreate` / `TaskUpdate` / `TaskList` / `TaskGet` | จัดการรายการงานที่แชร์ร่วมกัน |
-| `Agent` | สร้างสมาชิกที่เข้าร่วมทีม |
+### ตัวอย่างที่ 2: แทนที่ทีมที่ตั้งค่าผิด
+
+หาก `TeamCreate` ถูกเรียกด้วย `agent_type` หรือ `description` ที่ผิด ให้ตรวจสอบก่อนว่ายังไม่มี teammate ถูก spawn (หรือปิด) แล้ว:
+
+```
+TeamDelete()
+TeamCreate(team_name="...", description="...", agent_type="...")
+```
+
+## หมายเหตุ
+
+- `TeamDelete` ล้มเหลวหาก teammate ใดยัง active อยู่ response error จะ list teammate ที่ live — ส่ง `shutdown_request` ผ่าน `SendMessage` ให้แต่ละตัว รอ `shutdown_response` แล้ว retry
+- การลบเป็น irreversible จากมุมมองของ tool Config ของทีมที่ `~/.claude/teams/{team_name}/config.json` และ directory task ถูกลบจาก disk หากต้องการรักษา task list ให้ export หรือคัดลอก directory ก่อนลบ
+- เฉพาะ session leader ที่สร้างทีมเท่านั้นที่ลบได้ Teammate ที่ถูก spawn ไม่สามารถเรียก `TeamDelete` บนทีมของตัวเองได้
+- การลบทีมไม่ rollback การเปลี่ยนแปลง filesystem ที่ teammate ทำใน repository สิ่งเหล่านั้นคือการแก้ไขที่ติดตามโดย git ปกติและต้องถูก revert แยกหากไม่ต้องการ
+- หลัง `TeamDelete` คืนค่าสำเร็จ session อิสระที่จะเรียก `TeamCreate` อีกครั้งสำหรับทีมใหม่

package/concepts/th/Tools.md

@@ -8,7 +8,7 @@ Claude Code มอบชุดเครื่องมือในตัวใ
 
 | เครื่องมือ | วัตถุประสงค์ |
 |------|------|
-| [Task](Tool-Task.md) | เริ่มต้น sub-agent (SubAgent) เพื่อจัดการงานหลายขั้นตอนที่ซับซ้อน |
+| [Agent](Tool-Agent.md) | เริ่มต้น sub-agent (SubAgent) เพื่อจัดการงานหลายขั้นตอนที่ซับซ้อน |
 | [TaskOutput](Tool-TaskOutput.md) | รับผลลัพธ์ของงานเบื้องหลัง |
 | [TaskStop](Tool-TaskStop.md) | หยุดงานเบื้องหลังที่กำลังทำงาน |
 | [TaskCreate](Tool-TaskCreate.md) | สร้างรายการในรายการงานแบบมีโครงสร้าง |

package/concepts/tr/SubAgent-Search.md

@@ -1,20 +1,52 @@
 # SubAgent: Search
 
-## Tanım
+## Amaç
 
-Search, kod tabanında arama yapmak üzere Claude Code'un ana agent'ı tarafından oluşturulan bir sub-agent türüdür. Glob, Grep ve Read gibi araçları kullanarak hedefli dosya ve içerik aramaları gerçekleştirir, ardından sonuçları üst agent'a döndürür.
+Search alt ajanı hafif, yalnızca-okuma bir keşif ajanıdır. Bir kod tabanını anlamanız gerektiğinde — bir şeyin nerede yaşadığını bulmak, bileşenlerin nasıl bir araya geldiğini öğrenmek veya yapısal soruları yanıtlamak — hiçbir dosyayı değiştirmeden gönderin. Ham arama çıktısı yerine özlü bir özet döndürerek, birçok dosya üzerinde birçok küçük okuma için optimize edilmiştir.
 
-## Davranış
+Search genel amaçlı bir asistan değildir. Kodu düzenleyemez, derlemeler çalıştıramaz, değişiklikleri commit edemez veya yalnızca-okuma almanın ötesinde ağ bağlantıları açamaz. Değeri, ana ajanın bağlamını tüketmeden büyük bir keşif bütçesini paralel olarak yakabilmesi ve ardından kompakt bir yanıt geri vermesidir.
 
-- Ana agent'ın kod tabanını araması veya keşfetmesi gerektiğinde otomatik olarak oluşturulur
-- Salt okunur erişimle izole bir bağlamda çalışır
-- Dosya deseni eşleştirme için Glob, içerik arama için Grep ve dosya inceleme için Read kullanır
-- Arama sonuçlarını daha fazla işlenmek üzere üst agent'a döndürür
+## Ne Zaman Kullanılır
 
-## Ne Zaman Görünür
+- Üç veya daha fazla farklı arama veya okuma gerektiren bir soruyu yanıtlamanız gerekiyor. Örnek: "Giriş rotasından oturum deposuna kadar kimlik doğrulama nasıl bağlanıyor?"
+- Hedef bilinmiyor — hangi dosya, modül veya sembole bakacağınızı henüz bilmiyorsunuz.
+- Değişiklik yapmadan önce deponun tanıdık olmayan bir alanında yapısal bir genel bakışa ihtiyacınız var.
+- Birden fazla adayı çapraz referanslamak istersiniz (örneğin, benzer isimli yardımcılardan hangisinin gerçekten üretimde çağrıldığı).
+- Edebiyat tarzı bir özete ihtiyacınız var: "X'i içe aktaran her yeri listele ve çağrı sitesine göre kategorilendir."
 
-Search sub-agent'ları genellikle şu durumlarda görünür:
+Search'ü şunlar için kullanmayın:
 
-1. Ana agent'ın belirli dosyaları, fonksiyonları veya kod desenlerini bulması gerektiğinde
-2. Kullanıcı tarafından geniş kapsamlı bir kod tabanı keşfi talep edildiğinde
-3. Agent bağımlılıkları, referansları veya kullanım desenlerini araştırdığında
+- Tam dosya ve satırı zaten biliyorsunuz. Doğrudan `Read` çağırın.
+- Tek bir `Grep` veya `Glob` soruyu yanıtlayacak. Doğrudan çalıştırın; bir alt ajan göndermek ek yük ekler.
+- Görev düzenleme, komut çalıştırma veya herhangi bir yan etki gerektirir. Search tasarım gereği yalnızca-okumadır.
+- Bir araç çağrısının kelimesi kelimesine tam çıktısına ihtiyacınız var. Alt ajanlar özetler; ham sonuçları proxy etmezler.
+
+## Ayrıntı Düzeyleri
+
+Sorunun risklerine uyan düzeyi seçin.
+
+- `quick` — birkaç hedefli arama, en iyi çaba yanıtı. Hızlı bir işaretçiye ihtiyacınız olduğunda (örneğin, "env-değişken ayrıştırma mantığı nerede?") ve yanıt eksikse yineleme yapmaktan rahat olduğunuzda kullanın.
+- `medium` — varsayılan. Birkaç tur arama, adayları çapraz kontrol etme ve en ilgili dosyaları tam olarak okuma. Tipik "bu alanı anlamama yardım et" soruları için kullanın.
+- `very thorough` — kapsamlı keşif. Alt ajan her makul ipucunu takip edecek, çevreleyen bağlamı okuyacak ve özetlemeden önce bulguları iki kez kontrol edecek. Doğruluğun önemli olduğu durumlarda (örneğin, güvenlik incelemesi, geçiş planlaması) veya eksik bir yanıtın yeniden çalışmaya neden olacağı durumlarda kullanın.
+
+Daha yüksek ayrıntı düzeyi alt ajan içinde daha fazla zaman ve token maliyetlidir, ancak bu tokenlar alt ajan içinde kalır — yalnızca nihai özet ana ajana döner.
+
+## Mevcut Araçlar
+
+Search, ana ajanın kullandığı tüm yalnızca-okuma araçlara erişebilir ve başka hiçbir şeye erişemez:
+
+- `Read` — belirli dosyaları okumak için, kısmi aralıklar dahil.
+- `Grep` — ağaç genelinde içerik aramaları için.
+- `Glob` — ad desenine göre dosya bulmak için.
+- Yalnızca-okuma modunda `Bash` — durumu değiştirmeden inceleyen komutlar için (örneğin `git log`, `git show`, `ls`, `wc`).
+- `WebFetch` ve `WebSearch` — bu bağlam gerektiğinde dış dokümantasyonu okumak için.
+
+Düzenleme araçları (`Write`, `Edit`, `NotebookEdit`), durumu değiştiren kabuk komutları ve görev-grafiği araçları (`TaskCreate`, `TaskUpdate` vb.) kasıtlı olarak mevcut değildir.
+
+## Notlar
+
+- Search alt ajanına bir konu değil, belirli bir soru verin. "`renderMessage`'ın her çağrıcısını listele ve hangilerinin özel bir tema geçtiğini not et" yararlı bir yanıt döndürür; "render hakkında bana bilgi ver" döndürmez.
+- Alt ajan bir özet döndürür. Tam dosya yollarına ihtiyacınız varsa, promptunuzda bunları açıkça isteyin.
+- Birden fazla bağımsız soru tek bir uzun prompt yerine paralel Search alt ajanları olarak gönderildiğinde en iyidir, böylece her biri odaklanabilir.
+- Search düzenleyemediğinden, neyi değiştireceğinizi bildiğinizde ana ajanda bir takip düzenleme adımıyla eşleştirin.
+- Search çıktısını temel doğruluk olarak değil, kanıt olarak ele alın. Taşıyıcı herhangi bir şey için harekete geçmeden önce alıntılanan dosyaları kendiniz açın.

package/concepts/tr/Tool-Agent.md

@@ -1,125 +1,60 @@
 # Agent
 
-## Tanım
+Kendi bağlam penceresine sahip, odaklanmış bir görevi yürütüp tek bir birleştirilmiş sonuç döndüren otonom bir Claude Code alt ajanını başlatır. Açık uçlu araştırmaları, paralel çalışmaları veya ekip iş birliğini devretmek için kullanılan başlıca mekanizmadır.
 
-Karmaşık çok adımlı görevleri otonom olarak işlemek için bir alt agent (SubAgent) başlatır. Alt agent'lar bağımsız alt süreçlerdir ve her birinin kendine özel araç seti ve bağlamı vardır. Agent, yeni Claude Code sürümlerinde Task aracının yeniden adlandırılmış versiyonudur.
+## Ne Zaman Kullanılır
 
-## Parametreler
-
-| Parametre | Tür | Zorunlu | Açıklama |
-|-----------|-----|---------|----------|
-| `prompt` | string | Evet | Alt agent'ın yürüteceği görev açıklaması |
-| `description` | string | Evet | 3-5 kelimelik kısa özet |
-| `subagent_type` | string | Evet | Alt agent türü, kullanılabilir araç setini belirler |
-| `model` | enum | Hayır | Model belirtme (sonnet / opus / haiku), varsayılan üst seviyeden miras |
-| `max_turns` | integer | Hayır | Maksimum agentic tur sayısı |
-| `run_in_background` | boolean | Hayır | Arka planda çalıştırılıp çalıştırılmayacağı, arka plan görevleri output_file yolu döndürür |
-| `resume` | string | Hayır | Devam ettirilecek agent ID'si, son yürütmeden devam eder. Bağlamı kaybetmeden önceki bir alt agent'ı sürdürmek için kullanışlı |
-| `isolation` | enum | Hayır | İzolasyon modu, `worktree` geçici git worktree oluşturur |
-
-## Alt Agent Türleri
-
-| Tür | Kullanım Amacı | Kullanılabilir Araçlar |
-|-----|----------------|----------------------|
-| `Bash` | Komut çalıştırma, git işlemleri | Bash |
-| `general-purpose` | Genel amaçlı çok adımlı görevler | Tüm araçlar |
-| `Explore` | Hızlı kod tabanı keşfi | Agent/Edit/Write/NotebookEdit/ExitPlanMode hariç tüm araçlar |
-| `Plan` | Uygulama planı tasarlama | Agent/Edit/Write/NotebookEdit/ExitPlanMode hariç tüm araçlar |
-| `claude-code-guide` | Claude Code kullanım kılavuzu soru-cevap | Glob, Grep, Read, WebFetch, WebSearch |
-| `statusline-setup` | Durum çubuğu yapılandırma | Read, Edit |
-
-## Kullanım Senaryoları
-
-**Kullanıma uygun:**
-- Çok adımlı otonom tamamlama gerektiren karmaşık görevler
-- Kod tabanı keşfi ve derinlemesine araştırma (Explore türü ile)
-- İzole ortam gerektiren paralel çalışma
-- Arka planda çalıştırılması gereken uzun süreli görevler
-
-**Kullanıma uygun değil:**
-- Belirli dosya yolunu okuma — doğrudan Read veya Glob kullanın
-- 2-3 bilinen dosyada arama — doğrudan Read kullanın
-- Belirli sınıf tanımı arama — doğrudan Glob kullanın
-
-## Dikkat Edilecekler
-
-- Alt agent tamamlandığında tek bir mesaj döndürür; sonuçları kullanıcıya görünmez, ana agent'ın aktarması gerekir
-- Verimliliği artırmak için tek mesajda birden fazla paralel Agent çağrısı yapılabilir
-- Arka plan görevleri TaskOutput aracıyla ilerleme kontrolü yapılır
-- Explore türü doğrudan Glob/Grep çağrısından yavaştır, yalnızca basit arama yeterli olmadığında kullanın
-- Anında sonuç gerektirmeyen uzun süreli görevler için `run_in_background: true` kullanın; devam etmeden önce sonuç gerektiğinde ön plan modunu (varsayılan) kullanın
-- `resume` parametresi, daha önce başlatılmış bir alt agent oturumunu birikmiş bağlamı koruyarak sürdürmeye olanak tanır
+- Hangi dosyaların ilgili olduğunu henüz bilmediğiniz ve birden fazla tur `Glob`, `Grep` ve `Read` gerektirmesini beklediğiniz açık uçlu aramalar.
+- Paralel bağımsız çalışma — ayrı alanları eş zamanlı olarak incelemek için tek bir mesajda birkaç ajan başlatın.
+- Üst bağlamın derli toplu kalması için gürültülü keşfi ana konuşmadan izole etmek.
+- `Explore`, `Plan`, `claude-code-guide` veya `statusline-setup` gibi özelleşmiş bir alt ajan türüne devretmek.
+- Koordineli çoklu-ajan çalışması için aktif bir ekibe isimlendirilmiş bir takım arkadaşı dahil etmek.
 
-## Orijinal Metin
+Hedef dosya veya sembol zaten biliniyorsa KULLANMAYIN — doğrudan `Read`, `Grep` veya `Glob` kullanın. `Agent` üzerinden tek adımlık bir sorgu tam bir bağlam penceresini israf eder ve gecikme ekler.
 
-<textarea readonly>Launch a new agent to handle complex, multi-step tasks autonomously.
-
-The Agent tool launches specialized agents (subprocesses) that autonomously handle complex tasks. Each agent type has specific capabilities and tools available to it.
-
-Available agent types and the tools they have access to:
-- general-purpose: General-purpose agent for researching complex questions, searching for code, and executing multi-step tasks. When you are searching for a keyword or file and are not confident that you will find the right match in the first few tries use this agent to perform the search for you. (Tools: *)
-- statusline-setup: Use this agent to configure the user's Claude Code status line setting. (Tools: Read, Edit)
-- Explore: Fast agent specialized for exploring codebases. Use this when you need to quickly find files by patterns (eg. "src/components/**/*.tsx"), search code for keywords (eg. "API endpoints"), or answer questions about the codebase (eg. "how do API endpoints work?"). When calling this agent, specify the desired thoroughness level: "quick" for basic searches, "medium" for moderate exploration, or "very thorough" for comprehensive analysis across multiple locations and naming conventions. (Tools: All tools except Agent, ExitPlanMode, Edit, Write, NotebookEdit)
-- Plan: Software architect agent for designing implementation plans. Use this when you need to plan the implementation strategy for a task. Returns step-by-step plans, identifies critical files, and considers architectural trade-offs. (Tools: All tools except Agent, ExitPlanMode, Edit, Write, NotebookEdit)
-- claude-code-guide: Use this agent when the user asks questions ("Can Claude...", "Does Claude...", "How do I...") about: (1) Claude Code (the CLI tool) - features, hooks, slash commands, MCP servers, settings, IDE integrations, keyboard shortcuts; (2) Claude Agent SDK - building custom agents; (3) Claude API (formerly Anthropic API) - API usage, tool use, Anthropic SDK usage. **IMPORTANT:** Before spawning a new agent, check if there is already a running or recently completed claude-code-guide agent that you can resume using the "resume" parameter. (Tools: Glob, Grep, Read, WebFetch, WebSearch)
-
-When using the Agent tool, you must specify a subagent_type parameter to select which agent type to use.
-
-When NOT to use the Agent tool:
-- If you want to read a specific file path, use the Read or Glob tool instead of the Agent tool, to find the match more quickly
-- If you are searching for a specific class definition like "class Foo", use the Glob tool instead, to find the match more quickly
-- If you are searching for code within a specific file or set of 2-3 files, use the Read tool instead of the Agent tool, to find the match more quickly
-- Other tasks that are not related to the agent descriptions above
-
-Usage notes:
-- Always include a short description (3-5 words) summarizing what the agent will do
-- Launch multiple agents concurrently whenever possible, to maximize performance; to do that, use a single message with multiple tool uses
-- When the agent is done, it will return a single message back to you. The result returned by the agent is not visible to the user. To show the user the result, you should send a text message back to the user with a concise summary of the result.
-- You can optionally run agents in the background using the run_in_background parameter. When an agent runs in the background, you will be automatically notified when it completes — do NOT sleep, poll, or proactively check on its progress. Continue with other work or respond to the user instead.
-- **Foreground vs background**: Use foreground (default) when you need the agent's results before you can proceed — e.g., research agents whose findings inform your next steps. Use background when you have genuinely independent work to do in parallel.
-- Agents can be resumed using the `resume` parameter by passing the agent ID from a previous invocation. When resumed, the agent continues with its full previous context preserved. When NOT resuming, each invocation starts fresh and you should provide a detailed task description with all necessary context.
-- When the agent is done, it will return a single message back to you along with its agent ID. You can use this ID to resume the agent later if needed for follow-up work.
-- Provide clear, detailed prompts so the agent can work autonomously and return exactly the information you need.
-- Agents with "access to current context" can see the full conversation history before the tool call. When using these agents, you can write concise prompts that reference earlier context (e.g., "investigate the error discussed above") instead of repeating information. The agent will receive all prior messages and understand the context.
-- The agent's outputs should generally be trusted
-- Clearly tell the agent whether you expect it to write code or just to do research (search, file reads, web fetches, etc.), since it is not aware of the user's intent
-- If the agent description mentions that it should be used proactively, then you should try your best to use it without the user having to ask for it first. Use your judgement.
-- If the user specifies that they want you to run agents "in parallel", you MUST send a single message with multiple Agent tool use content blocks. For example, if you need to launch both a build-validator agent and a test-runner agent in parallel, send a single message with both tool calls.
-- You can optionally set `isolation: "worktree"` to run the agent in a temporary git worktree, giving it an isolated copy of the repository. The worktree is automatically cleaned up if the agent makes no changes; if changes are made, the worktree path and branch are returned in the result.
-
-Example usage:
-
-<example_agent_descriptions>
-"test-runner": use this agent after you are done writing code to run tests
-"greeting-responder": use this agent to respond to user greetings with a friendly joke
-</example_agent_descriptions>
-
-<example>
-user: "Please write a function that checks if a number is prime"
-assistant: Sure let me write a function that checks if a number is prime
-assistant: First let me use the Write tool to write a function that checks if a number is prime
-assistant: I'm going to use the Write tool to write the following code:
-<code>
-function isPrime(n) {
-  if (n <= 1) return false
-  for (let i = 2; i * i <= n; i++) {
-    if (n % i === 0) return false
-  }
-  return true
-}
-</code>
-<commentary>
-Since a significant piece of code was written and the task was completed, now use the test-runner agent to run the tests
-</commentary>
-assistant: Now let me use the test-runner agent to run the tests
-assistant: Uses the Agent tool to launch the test-runner agent
-</example>
+## Parametreler
 
-<example>
-user: "Hello"
-<commentary>
-Since the user is greeting, use the greeting-responder agent to respond with a friendly joke
-</commentary>
-assistant: "I'm going to use the Agent tool to launch the greeting-responder agent"
-</example>
-</textarea>
+- `description` (string, zorunlu): Görevi tanımlayan kısa 3-5 kelimelik etiket; arayüzde ve günlüklerde gösterilir.
+- `prompt` (string, zorunlu): Ajanın yürüteceği eksiksiz, kendi kendine yeterli brifing. Gerekli tüm bağlamı, kısıtları ve beklenen dönüş formatını içermelidir.
+- `subagent_type` (string, opsiyonel): `general-purpose`, `Explore`, `Plan`, `claude-code-guide` veya `statusline-setup` gibi önceden tanımlı persona. Varsayılan olarak `general-purpose`.
+- `run_in_background` (boolean, opsiyonel): True ise ajan eş zamansız çalışır ve üst ajan çalışmaya devam edebilir; sonuçlar daha sonra alınır.
+- `model` (string, opsiyonel): Bu ajan için modeli geçersiz kılar — `opus`, `sonnet` veya `haiku`. Varsayılan olarak üst oturum modelini kullanır.
+- `isolation` (string, opsiyonel): Ajanı izole bir git worktree içinde çalıştırmak için `worktree` olarak ayarlayın; böylece dosya sistemi yazımları üst ile çakışmaz.
+- `team_name` (string, opsiyonel): Var olan bir ekibe dahil edilirken, ajanın katılacağı ekip tanımlayıcısı.
+- `name` (string, opsiyonel): Ekip içinde adreslenebilir takım arkadaşı adı; `SendMessage` için `to` hedefi olarak kullanılır.
+
+## Örnekler
+
+### Örnek 1: Açık uçlu kod araması
+
+```
+Agent(
+  description="Find auth middleware",
+  subagent_type="Explore",
+  prompt="Locate every place in this repo where JWT verification is performed. Return a bulleted list of absolute file paths with a one-line note about each site's role. Do not modify any files."
+)
+```
+
+### Örnek 2: Paralel bağımsız incelemeler
+
+Aynı mesajda iki ajan başlatın — biri derleme hattını inceler, diğeri test altyapısını gözden geçirir. Her biri kendi bağlam penceresini alır ve bir özet döndürür. Tek bir tool-call bloğunda toplu iletişim kurmak onları eş zamanlı çalıştırır.
+
+### Örnek 3: Çalışan bir ekibe takım arkadaşı dahil etme
+
+```
+Agent(
+  description="Data layer specialist",
+  team_name="refactor-crew",
+  name="db-lead",
+  prompt="You are db-lead on team refactor-crew. Audit all Prisma schema files and propose a migration plan. Use SendMessage to report findings to the team leader."
+)
+```
+
+## Notlar
+
+- Ajanların önceki çalıştırmalara dair belleği yoktur. Her çağrı sıfırdan başlar, bu yüzden `prompt` tamamen kendi kendine yeterli olmalıdır — dosya yollarını, kuralları, soruyu ve istediğiniz yanıtın tam şeklini ekleyin.
+- Ajan tam olarak tek bir nihai mesaj döndürür. Çalışma sırasında açıklayıcı sorular soramaz, bu yüzden prompttaki belirsizlik sonuçta tahmine dönüşür.
+- Alt görevler bağımsız olduğunda birden fazla ajanı paralel çalıştırmak sıralı çağrılardan önemli ölçüde daha hızlıdır. Onları tek bir tool-call bloğunda toplu olarak gönderin.
+- Ajan dosya yazacaksa ve değişiklikleri ana çalışma ağacına birleştirmeden önce incelemek istiyorsanız `isolation: "worktree"` kullanın.
+- Yalnızca okumalı keşifler için `subagent_type: "Explore"`, tasarım çalışmaları için `Plan` tercih edin; `general-purpose` karışık okuma/yazma görevleri için varsayılandır.
+- Arka plan ajanları (`run_in_background: true`) uzun süren işler için uygundur; bir sleep döngüsünde yoklama yapmaktan kaçının — üst ajan tamamlandığında bildirim alır.