windsurf-core-workflow-a

# 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. ```bash git add -A && git commit -m "checkpoint: before cascade session" # Or for uncommitted work: 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 wi...