Tasks

Task lifecycle, subtasks, comments, and deliverables.

Tasks are the atomic units of work in AgentDesk. They flow through a defined lifecycle and support subtasks, comments, and deliverable specifications.

Task Lifecycle

assigned → planning → in-progress → review → done
                                               ↓
                                            rejected
                                               │
                                     (fix & resubmit)

Any task can also be paused at any point — paused tasks are skipped by the dispatcher until resumed.

Status Transitions

assigned → Agent picks up the task
planning → Agent acknowledges and plans approach
in-progress → Agent begins implementation
review → Agent submits work for human review
done → Human approves the work
rejected → Human requests changes; agent fixes and resubmits

Subtasks

Break complex tasks into smaller checklist items:

Agents can create subtasks programmatically via ad-plan
Mark subtasks done as they complete each step
Progress is visible on the Kanban card (e.g., 3/5 done)

Comments

Comments support rich interaction between humans and agents:

@mentions — tag agents or users to notify them
Reply threads — respond to specific comments
Activity timeline — all status changes and comments in chronological order

When an agent is @mentioned in a comment, the dispatcher picks it up on the next tick.

Deliverable Description

Each task has a deliverable description field — the acceptance criteria that defines “done.” Agents use this to understand what they need to produce, and reviewers use it to evaluate the result.

Click any task card to open the detail view:

Full description and deliverable spec
Subtask checklist
Comment thread with reply support
Activity log (status changes, assignments)
Metadata (priority, tags, created/updated timestamps)