---
title: Tasks — Reference
---

# Tasks — Reference

The Tasks page shows all tasks across every workplan and domain, with live
filtering, a workstation distribution chart, and a waiting-tasks highlight
section.

A **task** is a work-record kind: the smallest executable unit (work-item).
Tasks always belong to a workplan. Umbrella: [Work Records](/docs/work-records).
Implementation-readiness: [DoR](/policy/work-item-dor).

---

## Task workstations

Tasks expose their current lifecycle position through the `status` field (flow
tooling may call that position a workstation).

| Workstation | Meaning |
|--------|---------|
| **wait** | Waiting on another actor, event, decision, input, or condition |
| **todo** | Not yet started |
| **progress** | Actively being worked on |
| **done** | Completed |
| **cancel** | Stopped; not counted toward totals |

---

## Task priorities

| Priority | Use for |
|----------|---------|
| **critical** | Must be resolved immediately; blocks a release or governance gate |
| **high** | Should be resolved this session or next |
| **medium** | Normal backlog priority |
| **low** | Nice-to-have; deferred is acceptable |

---

## Filter bar

| Filter | Effect |
|--------|--------|
| **Status** | Multi-select — show only chosen statuses |
| **Priority** | Multi-select — show only chosen priorities |
| **Domain** | Multi-select — filter by domain slug |
| **Assignee** | Case-insensitive substring match on the assignee field |

All filters are applied client-side after each poll.

---

## Workstation Distribution chart

A horizontal bar chart (Observable Plot) showing the count of filtered tasks
per stored workstation/status label, colour-coded:

| Colour | Status |
|--------|--------|
| orange | wait |
| grey-blue | todo |
| purple | progress |
| green | done |
| light grey | cancel |

---

## Waiting Tasks section

Shows cards for every task currently in the `wait` workstation within the
active filter. Each card displays:

- Priority badge and status
- Domain and workplan context
- Task title
- Wait reason (amber background)

---

## KPI sidebar card

Shows counts for the unfiltered dataset: open (`wait` + `todo` + `progress`),
waiting, progress, done, and a done-% of total.

---

## Sorting

Tasks are sorted by status (wait first, then progress, todo, done, cancel) then
by priority (critical → high → medium → low) within each
status group.

---

## Data sources

Polls every **15 seconds**:
- `GET /tasks/?limit=500`
- `GET /workplans/`
- `GET /topics/`
