Skip to main content

Review a task's work before it ships

An Interactive task does not ship on its own. The runner asks you its questions as a Guided task would, and when the work is done it uploads its report and asks you to pick Finish or Request changes. A task that changes code opens its pull request as a draft first, so you can read the change before anything merges. Nothing merges until you pick Finish.

Use it when you want to see the result before it lands: a change you are unsure how to word, a report you want to steer, or work for someone who will judge it by eye.

Who can do this: anyone with permission to create tasks in the project.

  1. In the sidebar, select the project, then select New task on the board.

  2. Describe the work in the description box. See Write a good task.

  3. Open the involvement list, the second list under the description, and pick Interactive. Hover it to read Interactive โ€” asks you, then waits for your Finish before it ships.

    The settings row under a new task's description: the size list on Task, the involvement list on Interactive, the attach button and From issue

  4. Select Go. The task is saved and started.

  5. While it works, the runner may stop to ask before key decisions. The task shows Asking and sits in the board's Questions section. Answer as in Answer a task's question.

  6. When the work is done, the task shows Asking again. Open it: it opens on the Q&A tab, with the runner's report on the Artifacts tab. For a code change, its draft pull request is open in the project's repository for you to read.

  7. If something should change, pick Request changes, type what to change in Note, then select Send. Picking Request changes does not send by itself; it waits for your note.

  8. The runner revises its latest work rather than starting over, uploads it again and asks again. Repeat step 7 until you are happy.

  9. Pick Finish. The runner carries on as usual: a code change leaves draft and goes through the project's merge rules, and the task ends Done once it is merged.

If the finished work offers several versions, the question lists one option for each. Pick the one you want, and add a Note if it still needs changes.

Things to knowโ€‹

  • Interactive is not offered on an epic. An epic's subtasks run as Unattended or Guided.
  • An Interactive task waits for you at the end, so it holds its worktree until you answer. Leave it waiting too long and other tasks in the project may queue behind it.
  • A Sketch task starts as Interactive for you. For a mockup, follow Refine a mockup round by round instead.
  • To change an answer you already sent, see Change an answer you gave a task.