windsurf-local-dev-loop

# Windsurf Local Dev Loop ## Overview Set up a fast, AI-augmented local development workflow using Windsurf's Cascade, Turbo mode, Previews, and terminal integration. The goal is a tight loop: edit with Cascade, preview in-IDE, iterate, test, commit. ## Prerequisites - Windsurf authenticated and project open - Node.js 18+ or Python 3.10+ - Git initialized in project ## Instructions ### Step 1: Create .windsurfrules for Project Context ```markdown <!-- .windsurfrules - placed at project root, committed to git --> # Project: my-app ## Stack - Language: TypeScript (strict mode) - Framework: Next.js 14 (App Router) - Styling: Tailwind CSS v3 - Testing: Vitest + Testing Library - Package manager: pnpm ## Architecture - Server Components by default - Client Components only when state/interactivity needed - API routes in app/api/ - Business logic in lib/services/ - Types in lib/types/ ## Conventions - Named exports, never default - async/await, never raw .then() - zod for all runtime validation - Error handling: Result pattern in services ``` ### Step 2: Configure .codeiumignore ```gitignore # .codeiumignore - exclude from AI indexing (same syntax as .gitignore) node_modules/ .next/ dist/ build/ coverage/ *.min.js *.map .env .env.* ``` ### Step 3: Set Up Turbo Mode for Fast Terminal Execution Turbo mode lets Cascade auto-execute terminal commands without asking permission for each one. **Enable:** Windsurf Settings > Cascade > Terminal Execution Level > Turbo **Config...