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:
- Buyer persona from stage 2 (Who Pays?), with verbatim quotes from your interviews.
- Above-the-line pains from stage 3 (What Hurts?), with frequency × intensity scores.
- Winning angle from stage 4 (How to Win?), tied to which of the 7 Powers the business will have at maturity.
- V1 scope from stage 5 (What’s V1?). Differentiator + Operational features; Delights held back for V2.
- Pricing model from stage 6 (How to Charge?). Tier structure, entry price, the Pricing Position verdict.
- 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
- Windsurf documentation, the official Codeium spec.
- Cursor integration, same playbook, IDE-native alternative.
- Claude Code integration, terminal-native version of the same export.
- Validating a business idea with AI, the workflow this export plugs into.
Frequently asked questions
What is Windsurf and how is it different from Cursor?
Why use a ShipFit export instead of telling Cascade about my idea each session?
Do I need a paid Windsurf plan?
Can I edit the export after ShipFit generates it?
What if I'm using Windsurf alongside Cursor or Claude Code?
Ready to make your next product a success?
9 decisions between your idea and a product worth building.