Skip to main content

Plan Mode

In Plan Mode, the AI proposes a plan and waits for your approval before making any schema changes.

When to use Plan Mode

Plan Mode is ideal when you want to:

  • Understand what the AI will do before it does it
  • Make significant structural changes (renaming tables, changing relationships)
  • Discuss requirements with the AI before committing
  • Have a back-and-forth conversation before applying changes

How Plan Mode works

  1. Toggle the mode switch to on (Plan Mode)
  2. Type your schema request
  3. The AI responds with a proposed plan in plain English
  4. Review the plan — ask follow-up questions if needed
  5. The AI waits for confirmation
  6. Once you approve (say "yes", "looks good", etc.), the AI applies the changes
  7. The Schema Changes Banner appears with "Keep all" / "Undo all" options

The approval flow

You: I want to add carbon offset credit tracking to our supply chain schema
AI: Here's my plan:
1. Add a `carbon_offset_credits` table (id, supplier_id, tonnes_co2, vintage_year, verified_by, created_at)
2. Add a foreign key from `carbon_offset_credits.supplier_id` to `suppliers.id`
3. Add a `carbon_tier` enum (A, B, C, D) to the `suppliers` table
4. Add a unique constraint on (supplier_id, vintage_year) in carbon_offset_credits
Shall I proceed?

You: Yes, but skip step 4 — a supplier can have multiple credits per year
AI: Got it. [applies changes without the unique constraint]

Tips for Plan Mode

  • Ask clarifying questions before approving — "What happens to existing users without an organization?"
  • Request alternatives — "Show me another approach that doesn't require migrating existing data"
  • Partial approval — "Yes, but skip step 3"
  • Reject and redirect — "Actually, let's use a different approach — use a junction table instead"

Schema Changes Banner

After the AI applies approved changes, the Schema Changes Banner appears:

  • "Keep all" — accept all changes and dismiss banner
  • "Undo all" — roll back all changes from this response

The banner is disabled during active AI processing.