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