> ## Documentation Index
> Fetch the complete documentation index at: https://docket.hypertext.studio/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Tasks

> Track one piece of work, from capture through completion.

A Task is one piece of work. It can stand alone, belong to a Project or Program, or sit in Triage
until someone files it.

## Set the task properties

| Property     | What it controls                                                |
| ------------ | --------------------------------------------------------------- |
| **Assignee** | The person or agent responsible for the task.                   |
| **Delegate** | An optional agent doing the work on behalf of the assignee.     |
| **Status**   | One state from the owning Team's workflow.                      |
| **Priority** | None, low, medium, high, or urgent.                             |
| **Due date** | An optional date when the task is due.                          |
| **Estimate** | A time estimate or point estimate, based on workspace settings. |
| **Labels**   | Workspace terms used for filtering and grouping.                |

The Team controls the status workflow. A Project is optional.

## Capture before you organize

Create a Task from Today, the command palette, or a Task list. If you do not know where it belongs,
leave it in Triage. You can move it to a Project or Program later without rewriting it.

See [Tasks](/docs/guides/daily/tasks) for list controls. See [Triage](/docs/guides/daily/triage) for filing
unfiled work.

## Break down the work

Add subtasks when one Task needs several concrete steps. Docket shows the parent and child
relationship in the Task detail and in [Graph](/docs/guides/daily/graph).

Use parent and child relationships to describe decomposition. Use dependencies to describe order.
A Task can block or be blocked by another Task in the same workspace. Docket rejects a dependency
that would create a loop.

## Add context

Attach a file or link as a resource. You can also link an item from a connected provider when that
connection supports it. The Task shows direct resources and related references without copying the
source content into its description.

Threaded comments keep the discussion with the Task. Type `@` in a supported field to mention
another object.

## Plan and track the task

Add the Task to [Today](/docs/guides/daily/home-today) when you intend to work on it. Timebox it in
[Calendar](/docs/guides/daily/calendar-and-scheduling) when it needs a place in the day. Start a timer
when the work begins so [Time](/docs/guides/daily/time) records the interval.

Planning, timeboxing, and timing do not change the Task's status automatically.

## Repeat a task

Set a recurrence when the same work returns on a cadence. Docket creates occurrences from the
series while preserving each occurrence as work that can be completed on its own.

## Assign work to Athena

Assign the Task to Athena when Athena owns the result. Keep yourself as the assignee and set Athena
as the delegate when Athena works on your behalf. Review any proposed changes before Docket applies
them.