Review and merge

Once an agent delivers all its cards, it moves to Review. Review lives on the agent’s own page — a deck of everything it delivered, one card open for reading at a time, with the decision at the foot.

Reading the work

Each card in the deck shows what changed. For a code card, that’s the diff on the agent’s branch; for a design or research card, it’s the mockup or write-up itself. Step through the deck before deciding.

Sending a card back

If one card isn’t right, send it back on its own row: type what needs changing and press Send back. Your words become the agent’s next prompt and the merge is held: the agent goes back to Working, and returns to Review when it delivers again. An agent is approved as a whole, on one branch, so nothing merges until every card is right.

Approving

For a code agent, the button reads Approve & merge: it asks the machine to merge the agent’s branch into your base branch. The card only moves to Done once Flowviant sees the merge actually land — if the merge fails, the agent comes back to Review with its own turn to resolve the conflict, and you approve again once it’s back.

For a design or research agent, there’s nothing to merge — the button reads Accept, and it closes the card once the artifact exists.

If your project has the ship review quiz turned on, approving or accepting asks a few questions about the change first. A failed attempt doesn’t say which answers were wrong; passing it is what lets the decision go through.

See Agents and branches for how a branch gets there in the first place.