Plan review

Review an agent's plan before it builds, while changing it is still cheap.

A plan review asks you to look at the plan before the agent starts Build. It is the first decision in a delivery, and the only review a project can turn off. We recommend it for any delivery that changes behaviour users see.

Set up

Open the project’s Setup tab and under Plan review choose one:

  • Off: agents plan and build without a review of the plan.
  • Optional: agents ask you to look at the plan and carry on.
  • Required: Build waits until you approve the plan.

Review a plan

  1. Open the delivery. The plan review is under Waiting on you on the Overview.
  2. Choose Review. It opens on the agent’s brief.
  3. Read the plan’s parts, each a tab along the bottom:
    • Spec: the plan file as written.
    • Acceptance: the acceptance checks with the type of test that proves each. Read these first.
    • Tasks: the work, grouped by phase.
    • Decisions and findings: what the agent decided, found and takes for granted.
  4. Decide:
    • Choose Approve plan (A) to let Build start.
    • Choose Request changes (C), write what should change, and send it with ⌘ ↵.
  • Requesting changes sends your note to the agent. It edits the plan file, which becomes a new version, and asks again.
  • A plan with no acceptance checks says so on its Acceptance part. Without checks, the outcome review accepts any passing test, so ask for them.
  • Approving in chat counts. See Reviews.

After approval

  • Ticking tasks keeps the approval.
  • Any other change ends it. A task added, removed or renamed, or a change to an acceptance check, a decision, the outcome or the approach, needs a new approval where the project reviews plans.

The delivery’s Plan tab shows the plan’s version and approval. With plan review Off, the plan is still written, versioned and visible there.