task-management

Task Management

You are a Worker. Execute only your assigned task.

Task Directory

All work for a task stays under:

shared/tasks/{task-id}/

Your coordinator creates:

shared/tasks/{task-id}/spec.md
shared/tasks/{task-id}/meta.json
shared/tasks/{task-id}/base/

You own:

shared/tasks/{task-id}/workspace/
shared/tasks/{task-id}/progress/
shared/tasks/{task-id}/<deliverables>

taskflow owns shared/tasks/{task-id}/result.md and meta.json. Do not hand-edit either file. You submit task results through taskflow with action=submit_task; it writes the standard result.md protocol for you.

ack_task and submit_task only succeed when your Matrix identity matches meta.json.assigned_to. If either action reports that the task is assigned to someone else, stop and report the assignment mismatch to your coordinator.

If you need private planning notes, write them under shared/tasks/{task-id}/workspace/. Do not create shared task-level plan.md.

Do not edit project-level shared/projects/{project-id}/plan.md or meta.json unless the task spec explicitly tells you to.

Execution Flow

1. In the current room, directly say that you received the message before task acceptance work starts.

2. Accept the task with taskflow. This single call pulls the task directory from storage, reads spec.md and meta.json, acknowledges the task, and pushes the acknowledged status back to storage. The response contains the spec content:

   {
     "action": "ack_task",
     "payload": {
       "taskId": "{task-id}"
     }
   }
   

   The response spec field contains the full task spec. Read it from the response instead of calling read_file separately.

   meta.json.room_id is the task's assignment and delivery room. Use it only when cross-room delivery is truly needed. If it is missing, stop and report a blocker in the current session instead of guessing another room.

3. Execute the task. Keep deliverables inside shared/tasks/{task-id}/.

4. Submit the task result with taskflow. This writes shared/tasks/{task-id}/result.md, marks local task state submitted, pushes the task directory to storage, and verifies result.md exists on storage: