Docs

Reviewing a proposal

Every change an agent proposes waits for you. Here’s how to read it and what each choice does.

Where proposals appear

• The agent gives you a review link. It opens the proposal straight on your schema.
• In the editor, the Agent proposals button shows how many are waiting, and a notice appears when a new one arrives.

Reading the canvas

The proposed schema is drawn over yours. New tables and columns are green, changed ones amber, and dropped columns are struck through in red. Nothing is saved while you look.

The panel below lists every change with its level and a reason, and shows the migration SQL for your database. Apply is the change; Roll back is how to undo it.

Your three choices

• Approve. The change is saved to your schema and the agent can fetch the migration.
• Edit first. The proposal becomes editable on the canvas. Adjust anything, then press Approve as edited; the agent gets the migration for your version. Discard edits puts everything back.
• Reject. Optionally add a note. The agent reads it and can propose again.

Warnings worth reading

• Possible rename. When a column disappears and a similar one appears, it may have been meant as a rename. Approving as-is deletes the old column’s data; use Edit first to make it a rename.
• Your schema changed. If you edited the schema after the agent proposed, step-by-step proposals are reapplied to your current schema when you approve. Proposals sent as full SQL ask you to edit first or reject.