Skip to main content

Change what a playbook stage hands back

A stage's Deliverable is what it hands back when it's done. It also decides the rest: when the stage ends, whether it may change code, and what it may file. Change it when a stage should, for example, write up a root cause as a Document instead of fixing it in a Pull request.

Who can do this: the Owner or Admin role in your organization, on one of your own playbooks. The built-in playbooks are read-only; duplicate one first, as in Create a playbook.

  1. In the sidebar, select Settings, then Playbooks under Customize.

  2. Under Your playbooks, select ⋯ at the end of the playbook's row, then Edit.

  3. Select the Stages tab, for example Stages (3), and select ▸ at the start of the stage's card to open it. The line under its name, such as Analyst × Document · High tier, shows its expert and deliverable.

  4. Check Expert. Deliverable can be set only when it reads Always this expert; with User selects it reads Follows the expert, and each expert hands back its own.

  5. Open Deliverable and pick one:

    • Pull request: can change code; ends when its pull request merges.
    • Document: read-only; ends when its document is uploaded.
    • Mockup: read-only; ends when its HTML report is uploaded.
    • Plan: read-only; files the per-item and finish stages.
    • Review: read-only; may file follow-ups into the implement stage.
    • Conversation: ends only when it is completed by hand.
  6. If the card now shows May file, tick what the stage may create. Changing the deliverable clears these ticks.

  7. Read Set by the deliverable at the bottom of the card: Ends when, Mode, Model tier, Receives and Hands off now follow your pick. Only an Analyst or Architect stage that delivers a Document hands off a PRD or Architecture document to the stages that wait for it.

    An open stage card: Investigate, Analyst with Document as its Deliverable, and Set by the deliverable reading Ends when its document is uploaded, Read-only, High, Nothing and PRD

  8. Select Preview prompt to read the instructions the stage now gets, then Close.

  9. Select Save. If Save stays unavailable, the new deliverable doesn't fit the rest of the playbook; the card names the problem, as in Fix a playbook's errors.