Skip to content

Review and ship a change

Use this workflow after an agent finishes coding. The goal is to verify the change, save it to the task branch, and publish it deliberately.

Resolve review findings

AICoder runs its configured review checks after a clean coding session. Open the task from Needs you in the Queue and inspect each finding.

  • Use Fix with AI for a genuine issue. The agent receives the outstanding findings and the reviews run again after its fix.
  • Dismiss a finding only when you have confirmed that no code change is needed.
  • Do not ship while an important finding remains unexplained.

See Reviews for the available checks and finding states.

Inspect and verify the change

Open Review changes and check:

  1. The summary matches the task's intended outcome.
  2. Each changed file has a sensible rationale.
  3. The diff contains no unrelated edits, secrets, or generated artifacts.
  4. Relevant automated tests pass.
  5. UI changes work in the Preview panel when the project has a preview command.

The review pipeline supports your judgment; it does not replace it.

Save, publish, and open a PR

The task flow keeps each state-changing step separate:

  1. Save merges the approved agent work into the task branch.
  2. Publish pushes that branch to origin.
  3. Open PR creates a pull request into the project's base branch.

Nothing is pushed before Publish. Check the generated commit message and the target branch before continuing.

For the exact controls and states, see Shipping.