The board
The Tasks view is a board of cards. Each card is one task, and its column is its status. Agents move the cards as they work. You can also add, edit and move cards yourself.
Columns
The board shows the columns in this order.
| Column | The board’s own description | What it means |
|---|---|---|
| Todo | “Queue upcoming work” | The task is waiting to be picked up. |
| In Progress | “Active implementation” | The Unreal coder is working on it. |
| Review | “Validation and QA checks” | Unreal QA is checking the work. |
| Blocked | “Waiting on dependencies or decisions” | The task stopped and needs you. |
| Done | “Shipped and verified” | QA passed. |
What moves a task
| Move | Cause |
|---|---|
| Todo to In Progress | The task is picked up. |
| In Progress to Review | The coder finishes: the change builds and is committed. |
| Review to Done | Unreal QA passes it. |
| Review to Todo | Unreal QA finds a defect. The task returns to the coder with a comment that starts [QA REJECTED], and the coder reads it as feedback on the next pass. |
| Stays in Review | QA hit an environment problem, such as an editor it could not reach. QA runs again, and the coder is not blamed. |
| To Blocked | The task failed its checks too many times, or no QA agent applies to the project. |
For how QA decides, see Agents.
Add a task by hand
Open the form
In a column, choose + Add a card.
Fill it in
Enter a title and a description. You can also set the status, the priority and the tasks it depends on.
Add it
Choose Add card.
Move, open and edit a card
- Drag a card to another column. With a card focused, Alt and an arrow key also moves it.
- From a card’s menu, choose Details to open the task. The task page has four tabs: Details, Activity, Dependencies and Budget. ‹ Back to Tasks returns to the board.
- On the Details tab, edit the title, description, status and priority, then choose Save changes. Saving does not re-run the task.
Unblock a task
A blocked card shows a warning icon. Hover it to read the full reason. Open the task to see the banner, which starts with “Blocked” and a short reason such as Needs a human, Not applicable here or a count of QA rejections.
| What you see | What to do |
|---|---|
| A count of QA rejections or trigger retries | Choose Last QA report in the banner to read what QA found. Fix the cause or rewrite the task, then choose Reset QA bounces or Reset retries. |
| Needs a human | Read the reason and the task’s comments, and do what they ask. Then choose Retry from the card’s menu. |
| Not applicable here | An agent concluded the task cannot be done in this project. Rewrite the task against what the project contains, or close it. |
A card in Todo or Blocked has Retry in its menu. A blocked card also has Rewind to checkpoint….
Next steps
Last updated on