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
- Open the delivery. The plan review is under Waiting on you on the Overview.
- Choose Review. It opens on the agent’s brief.
- 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.
- 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.