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

# Tasks

> What a GPR task is, how the pipeline runs, and how board lanes map to status.

A **task** is a unit of work on the kanban board. It can be created in-app or synced from GitHub, Jira, or Slack.

## Identity

* Internal id: `tsk_*`
* Display id: human-facing label such as `TRA-1`
* Optional `source_provider`: `github`, `jira`, or `slack`

## Three dimensions

| Dimension | Answers |
| - | - |
| **Status** | Which board lane? |
| **Phase** | Which pipeline step is active? |
| **Checkpoint** | Where can work resume after a drop? |

Full tables: [Task states](https://getpullrequest.com/docs/reference/task-states.md).

### Status (board lane)

`backlog` · `awaiting_user` · `waiting_for_agent` · `in_progress` · `interrupted` · `in_review` · `completed` · `errored`

### Phase

`idle` · `planning` · `implementing` · `testing` · `opening_pr` · `done`

### Checkpoint (resume barrier)

```text theme={null}
none → plans_complete → generation_complete → verification_complete
  → reviews_addressed → summary_complete → pr_complete → notified
```

## Pipeline

When claimed:

1. **Plan** (may ask clarifying questions → `awaiting_user`)
2. **Implement** on a durable ACP session in a worktree
3. **Verify** (tests; retries then `errored` if exhausted)
4. Address pending review comments if any
5. Draft summary
6. Open / update PR → park `in_review`
7. On merge (or notify with no host) → `completed`

## Board projection

The mobile board folds several statuses into fewer columns. Expect Backlog to include parked states such as `awaiting_user`, `waiting_for_agent`, and `interrupted`, plus In Progress, In Review, Done, and Failed.

## Task vs session

The **task** owns board state and checkpoints. The **session** owns the live agent process and stream. Chat UI follows the session; the board follows the task.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.