update_task
Updates a task's status, owner, or validation notes on the shared blackboard so you can claim work, hand off responsibility, or mark tasks completed with verification proof.
Instructions
Updates the status, owner, or validation notes of a task in the Tier 3 Task Graph.
Call this tool to claim work, hand off responsibility to another agent, or mark work as completed with proof of verification.
Status Conventions:
'pending': Queued task waiting to be started.
'in_progress': Currently being worked on. MUST have an 'assigned_to' owner to avoid triggering '⚠️ Attention Required' health warnings.
'completed': Finished work. MUST include validation notes (e.g., test results, verification commands) for audit trail compliance.
Args: task_id: Unique task identifier (e.g., 'task-04', 'FEAT-BLACKBOARD'). status: Target status ('pending', 'in_progress', 'completed'). title: Optional updated title if creating or renaming the task. assigned_to: Agent or user claiming the baton (e.g., 'claude', 'antigravity', 'human'). notes: Progress updates or verification proof (e.g., '46/46 tests passed in 0.41s').
Returns: str: Confirmation message reflecting the updated task state.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"task_id": "<task_id>",
"status": "<status>"
},
"name": "update_task"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| notes | No | ||
| title | No | ||
| status | Yes | ||
| task_id | Yes | ||
| assigned_to | No |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |