Integration

Windsurf Export from Idea Validation: Run Your Playbook Through Codeium's IDE

Stage 9 of the ShipFit playbook ships your validated decisions to Windsurf so Cascade works from your buyer, V1 scope, pricing, and launch plan from the first prompt.

What Windsurf does

Windsurf is Codeium’s agentic IDE: a VS Code fork built around a chat agent called Cascade. Cascade can read multiple files, write multi-file diffs, run tests, and commit. Compared to Cursor, the contrast is Cascade’s appetite for large refactors in one pass; compared to Claude Code, the contrast is that Windsurf is GUI-first while Claude Code is terminal-first.

Windsurf reads project-level configuration on session start and uses it as context for every Cascade conversation. ShipFit’s stage-9 export uses that mechanism to keep your validated decisions in front of the agent for the life of the project.

What ShipFit ships to Windsurf

When you reach stage 9 (What to Export?) and pick Windsurf, the export takes the validated playbook produced by the previous 8 stages and lands it in your repo as Windsurf configuration. Cascade then works from your validated decisions, not generic defaults.

What carries over from the playbook into the export:

  1. Buyer persona from stage 2 (Who Pays?), with verbatim quotes from your interviews.
  2. Above-the-line pains from stage 3 (What Hurts?), with frequency × intensity scores.
  3. Winning angle from stage 4 (How to Win?), tied to which of the 7 Powers the business will have at maturity.
  4. V1 scope from stage 5 (What’s V1?). Differentiator + Operational features; Delights held back for V2.
  5. Pricing model from stage 6 (How to Charge?). Tier structure, entry price, the Pricing Position verdict.
  6. Launch plan from stage 8 (How to Launch?). Primary channels and message.

ShipFit also installs project-level shortcuts that re-apply the framework gates during development, so Cascade’s appetite for big diffs stays bounded by the validated V1 scope.

Install

After running stage 9, unzip the export into your repo root, commit, and restart Windsurf. The next Cascade session loads the new context automatically.

Why bother

Cascade is built to ship big diffs. That’s its strength when you’re doing a known refactor with clear scope, and its weakness when the scope hasn’t been defined. Without project-level context, asking Cascade to “build the user dashboard” produces a 12-file shipset that includes admin features, settings panels, and notification preferences, none of which were in your validated V1.

Loading the validated playbook into Windsurf prevents that. The big-diff capability stays useful; the diffs are now constrained to the validated scope.

Common mistakes

1. Treating the export as a one-time setup. Re-export after any meaningful pivot.

2. Letting the framework gates collect dust. The first time the gate flags scope creep, the temptation is to dismiss it. The flag means it caught real drift. Investigate.

3. Mixing engineering conventions with validation context in the wrong place. Re-exporting refreshes the validation context; your engineering conventions stay where you put them.

Further reading

Frequently asked questions

What is Windsurf and how is it different from Cursor?
Windsurf is Codeium's agentic IDE, also a VS Code fork, with the Cascade chat as the headline AI feature. The main contrast vs Cursor: Cascade is more aggressive about multi-file refactors and tends to ship larger diffs in one shot. Cursor's tab autocomplete is generally tighter; Cascade is generally better at 'rebuild this whole flow.' ShipFit's export plugs into both with the same validated decisions so the choice between them is style, not playbook fidelity.
Why use a ShipFit export instead of telling Cascade about my idea each session?
Telling Cascade once works for one session. The validation context decays the next time you open the IDE. A persistent project context loads automatically into every Cascade session for the lifetime of the project, so the V1 scope and the buyer's pain phrasing are in front of the model every time it ships a diff.
Do I need a paid Windsurf plan?
Yes for production. The free Windsurf tier is rate-limited. The ShipFit export works on every paid tier (Pro, Pro Ultimate, Team, Enterprise) and adds no separate API consumption beyond what Cascade already uses.
Can I edit the export after ShipFit generates it?
Yes. The export captures your validated decisions; you add engineering conventions on top. Re-running stage 9 in ShipFit refreshes the validation parts without disturbing the engineering parts you added by hand.
What if I'm using Windsurf alongside Cursor or Claude Code?
Pick all the tools you want in stage 9 and ShipFit emits the right configuration for each. All of them share the same source-of-truth validation state, so the tools agree about what's in scope. Common pattern: Cursor for editing, Claude Code for terminal/CI, Windsurf for big multi-file refactors.

Ready to make your next product a success?

9 decisions between your idea and a product worth building.

No credit card required.

Try an example: