source dump of claude code
1export const DESCRIPTION = 'Update a task in the task list'
2
3export const PROMPT = `Use this tool to update a task in the task list.
4
5## When to Use This Tool
6
7**Mark tasks as resolved:**
8- When you have completed the work described in a task
9- When a task is no longer needed or has been superseded
10- IMPORTANT: Always mark your assigned tasks as resolved when you finish them
11- After resolving, call TaskList to find your next task
12
13- ONLY mark a task as completed when you have FULLY accomplished it
14- If you encounter errors, blockers, or cannot finish, keep the task as in_progress
15- When blocked, create a new task describing what needs to be resolved
16- Never mark a task as completed if:
17 - Tests are failing
18 - Implementation is partial
19 - You encountered unresolved errors
20 - You couldn't find necessary files or dependencies
21
22**Delete tasks:**
23- When a task is no longer relevant or was created in error
24- Setting status to \`deleted\` permanently removes the task
25
26**Update task details:**
27- When requirements change or become clearer
28- When establishing dependencies between tasks
29
30## Fields You Can Update
31
32- **status**: The task status (see Status Workflow below)
33- **subject**: Change the task title (imperative form, e.g., "Run tests")
34- **description**: Change the task description
35- **activeForm**: Present continuous form shown in spinner when in_progress (e.g., "Running tests")
36- **owner**: Change the task owner (agent name)
37- **metadata**: Merge metadata keys into the task (set a key to null to delete it)
38- **addBlocks**: Mark tasks that cannot start until this one completes
39- **addBlockedBy**: Mark tasks that must complete before this one can start
40
41## Status Workflow
42
43Status progresses: \`pending\` → \`in_progress\` → \`completed\`
44
45Use \`deleted\` to permanently remove a task.
46
47## Staleness
48
49Make sure to read a task's latest state using \`TaskGet\` before updating it.
50
51## Examples
52
53Mark task as in progress when starting work:
54\`\`\`json
55{"taskId": "1", "status": "in_progress"}
56\`\`\`
57
58Mark task as completed after finishing work:
59\`\`\`json
60{"taskId": "1", "status": "completed"}
61\`\`\`
62
63Delete a task:
64\`\`\`json
65{"taskId": "1", "status": "deleted"}
66\`\`\`
67
68Claim a task by setting owner:
69\`\`\`json
70{"taskId": "1", "owner": "my-name"}
71\`\`\`
72
73Set up task dependencies:
74\`\`\`json
75{"taskId": "2", "addBlockedBy": ["1"]}
76\`\`\`
77`