02 · Shape

When to leave the prototype

refinedprinciple → decision → workflow → artifact

Principle

Vibe prototyping tools are learning accelerators, not ownership layers. They help you find shape fast. They punish you if you mistake generated UI for a billable, testable, multi-engineer product.

Most teams switch too early (editing build config while still guessing the problem) or too late (the Lovable app is the product — except it cannot bill, test, or survive a second engineer).

The decision

DEC_003

  Idea
│
▼
Vibe prototype ──(learn)──► still guessing? ──yes──► stay
│                           │
│                           no
│                           ▼
└──────────────────► own codebase + tests + deploy
The fork most founders hit between demo and product.

Workflow

  1. Time-box the prototype (days, not months). Name what you are trying to falsify.
  2. Record the workflow as a checklist, not a screen recording.
  3. When a limitation appears, write it down before switching tools — that note becomes the first engineering ticket.
  4. Migrate vertically: auth → data → payments → polish. Not “rewrite everything because AI said so.”
  5. Keep the prototype URL as a tombstone — what you learned, not what you ship.

Tooling

Lovable, Bolt, v0, Figma Make — same decision framework. Pick whichever gets you to the three exit criteria fastest. None of them are the destination.

Common mistakes

Scenario (composite)

A founder built a client portal in a vibe tool in four days — impressive demo, one design-agency pilot user. After three weeks the pilot ran onboarding eight times (good signal) but hit: no role separation for junior staff, no invoice webhook, export blocked by the tool’s row limits.

They stayed in vibe one more week to confirm the workflow checklist, then migrated vertically: auth first, Postgres schema second, Stripe third. The vibe URL stayed live with a tombstone note. Total migration took twelve days; they did not rewrite screens that were not on the ten-run path.

Artifacts

Falsify this

Further reading