What problem does it solve?
Workers in a multi-agent team need a consistent protocol for acknowledging assigned tasks, keeping deliverables in the right shared directories, and reporting completion or blockers back to the Leader without corrupting project-level state.
Core Features & Use Cases
- Task Acknowledgment: Claims assigned tasks with the taskflow ack_task action and reads the task spec before starting work.
- Scoped Deliverables: Keeps all Worker-owned files under shared/tasks/{task-id}/workspace, progress, and result.md while protecting Leader-owned project files from edits.
- Structured Submission: Submits results with taskflow submit_task using SUCCESS, SUCCESS_WITH_NOTES, REVISION_NEEDED, or BLOCKED statuses, and publishes deliverables as Matrix room file events.
- Use Case: A Worker agent receives TASK_ASSIGNED in a Matrix room, acknowledges the task, writes an analysis report to the task directory, submits it with deliverables listed, and posts a TASK_COMPLETED message mentioning the Leader.
Quick Start
Acknowledge the task assigned to you with taskflow ack_task, read the spec in shared/tasks/{task-id}/spec.md, write your deliverables in the task workspace, then submit with taskflow submit_task and notify the Leader in the room.