| name | windsurf-core-workflow-a |
| description | Execute Windsurf's primary workflow: Cascade Write mode for multi-file agentic coding.
Use when building features, refactoring across files, or performing complex code tasks.
Trigger with phrases like "windsurf cascade write", "windsurf agentic coding",
"windsurf multi-file edit", "cascade write mode", "windsurf build feature".
|
| allowed-tools | Read, Write, Edit, Bash(npm:*), Grep |
| version | 1.11.0 |
| license | MIT |
| author | Jeremy Longshore <jeremy@intentsolutions.io> |
| tags | ["saas","windsurf","cascade","write-mode","agentic"] |
| compatibility | Designed for Claude Code |
Windsurf Core Workflow A — Cascade Write Mode
Overview
Cascade Write mode is Windsurf's primary productivity tool. It acts as an autonomous agent that can create files, modify code across multiple files, run terminal commands, install dependencies, and debug errors -- all from a single natural language prompt. This is the "money-path" workflow for Windsurf users.
Prerequisites
- Windsurf IDE with Cascade enabled
.windsurfrules configured (see windsurf-sdk-patterns)- Git initialized with clean working tree
Instructions
Step 1: Create a Git Checkpoint
Always commit or stash before a Cascade session. Cascade writes directly to your files.
git add -A && git commit -m "checkpoint: before cascade session"
git stash push -m "pre-cascade stash"
Step 2: Open Cascade in Write Mode
Press Cmd/Ctrl+L to open the Cascade panel. Ensure "Write" mode is selected (not "Chat"). Write mode allows Cascade to:
- Create and modify files
- Run terminal commands (with Turbo or per-command approval)
- Install dependencies
- Read terminal output for debugging
- Open browser previews
Step 3: Write an Effective Prompt
Structure your prompt with scope, specifics, and constraints:
"In src/services/, create a NotificationService that:
1. Sends email via Resend API (already in package.json)
2. Sends Slack messages via webhook URL from env
3. Uses the Result<T,E> pattern from src/types/result.ts
4. Includes retry logic with exponential backoff (max 3 retries)
5. Add unit tests in tests/services/notification.test.ts
Don't modify any existing files except to add exports."
Step 4: Review Cascade's Plan and Execution
Cascade shows its reasoning and plan before executing:
Cascade output flow:
1. "I'll create the notification service with email and Slack support..."
2. Creates src/services/notification.ts (shows diff)
3. Creates tests/services/notification.test.ts (shows diff)
4. Runs: npm install resend (if needed)
5. Runs: npx vitest run tests/services/notification.test.ts
6. Reports results
Review each file diff in the Cascade output. You can:
- Revert individual steps by hovering over a step and clicking the revert arrow
- Revert all to return to the state before the Cascade session
