Pillar Specification & Hub DirectoryWindsurf Cascade Rules Directory & Generator
Targeted workflow rules for Windsurf Cascade. Guide AI code agents through context inspection, architectural alignment, and surgical diffs.
.windsurf/rules/<rule-name>.mdHow Windsurf Cascade Rules Operates in Production
Windsurf Cascade rules (.windsurf/rules/*.md) provide structured, phase-driven instructions for Codeium's Windsurf editor. They define agent personas, execution checklists, and negative constraints to keep Cascade focused and prevent hallucinated patterns.
Windsurf Cascade thrives on explicit step-by-step checklists to guide agent reasoning across files.
## Cascade Execution Workflow
1. Inspect surrounding files and project manifests.
2. Formulate surgical edits adhering to repository conventions.
3. Run test suites and typecheck verification..windsurf/rules/nextjs.mdGlobal repository / Cascade active flowsEnforces React Server Components, Server Actions, and Next.js conventions in Windsurf.
.windsurf/rules/backend.mdBackend services, APIs, and database migrationsEnforces schema validation, parameterized queries, and defensive error propagation.
Available Tech Stack Presets (27)
Click any tech stack below to open the client-side editor preloaded with this verified configuration.
Next.js 15 App Router
Generate production Windsurf Cascade rules for Next.js 15 App Router.
"Enforce React Server Components (RSC) by default; restrict 'use client' strictly to interactive leaf components."
React 19 & Vite
Generate production Windsurf Cascade rules for React 19 & Vite.
"Use React 19 action hooks (useActionState, useOptimistic, useFormStatus) for async mutations."
Python FastAPI & Pydantic v2
Generate production Windsurf Cascade rules for Python FastAPI & Pydantic v2.
"Use strict Pydantic v2 BaseModels with Field validation for all input and output schemas."
Supabase & PostgreSQL
Generate production Windsurf Cascade rules for Supabase & PostgreSQL.
"Always include `ENABLE ROW LEVEL SECURITY;` on every created table."
Prisma ORM
Generate production Windsurf Cascade rules for Prisma ORM.
"Always use `select` to specify required fields; avoid raw `findMany()` fetching unused relations."
Drizzle ORM
Generate production Windsurf Cascade rules for Drizzle ORM.
"Define schemas using pgTable/sqliteTable with explicit foreign keys and constraints."
Go (Golang) & Fiber
Generate production Windsurf Cascade rules for Go (Golang) & Fiber.
"Check every `if err != nil` explicitly; never swallow errors or ignore returned values."
Rust & Axum
Generate production Windsurf Cascade rules for Rust & Axum.
"Never call `.unwrap()` or `.expect()` in production route handlers; propagate errors via `Result<T, AppError>`."
Tailwind CSS v4
Generate production Windsurf Cascade rules for Tailwind CSS v4.
"Configure themes directly in globals.css using `@theme` and `@import 'tailwindcss';`."
Vue 3 & Nuxt 3
Generate production Windsurf Cascade rules for Vue 3 & Nuxt 3.
"Always use `<script setup lang='ts'>` and the Composition API; ban legacy Options API."
SvelteKit 5 & Svelte 5
Generate production Windsurf Cascade rules for SvelteKit 5 & Svelte 5.
"Use Svelte 5 runes: `$state()`, `$derived()`, and `$props()`."
Universal Cursor Pro
Generate production Windsurf Cascade rules for Universal Cursor Pro.
"Deliver surgical, targeted diffs; never replace entire files unnecessarily."
Pragmatic Rapid Prototyping
Generate production Windsurf Cascade rules for Pragmatic Rapid Prototyping.
"Prioritize working software over complex design patterns or deep inheritance hierarchies."
Zero-Trust Security
Generate production Windsurf Cascade rules for Zero-Trust Security.
"Flag and prevent any dynamic SQL query string interpolation."
Docker & CI/CD
Generate production Windsurf Cascade rules for Docker & CI/CD.
"Always use multi-stage Docker builds to separate builder tools from the lean production image."
Vitest & Playwright TDD
Generate production Windsurf Cascade rules for Vitest & Playwright TDD.
"Write unit tests covering happy paths and at least two edge/error cases for every new function."
Automated Code Reviewer
Generate production Windsurf Cascade rules for Automated Code Reviewer.
"Scan repository manifests to map stack idioms before evaluating logic."
Multi-Agent System Orchestration
Generate production Windsurf Cascade rules for Multi-Agent System Orchestration.
"Define subagent roles: Lead Architect, Frontend Engineer, Backend Specialist, Security Reviewer."
Django 5 & Ninja / DRF
Generate production Windsurf Cascade rules for Django 5 & Ninja / DRF.
"Use asynchronous ORM operations (aget(), acreate(), afirst()) inside async def view handlers."
Bun & Elysia / Hono
Generate production Windsurf Cascade rules for Bun & Elysia / Hono.
"Use Elysia's native t schema builder (powered by TypeBox) for request body, query, and parameter validation."
React Native & Expo Router
Generate production Windsurf Cascade rules for React Native & Expo Router.
"Use Expo Router file-based filesystem routing (app/_layout.tsx, app/(tabs)/index.tsx); ban legacy React Navigation container boilerplate."
Flutter 3 & Riverpod / Dart
Generate production Windsurf Cascade rules for Flutter 3 & Riverpod / Dart.
"Always add const constructors wherever possible to maximize Flutter element rebuild caching."
Kubernetes & Helm Charts
Generate production Windsurf Cascade rules for Kubernetes & Helm Charts.
"Always specify explicit resources.requests and resources.limits (both CPU and memory) on every container."
Terraform & OpenTofu IaC
Generate production Windsurf Cascade rules for Terraform & OpenTofu IaC.
"Pin explicit version constraints for all providers and required Terraform/OpenTofu core versions (required_providers)."
Playwright End-to-End Testing
Generate production Windsurf Cascade rules for Playwright End-to-End Testing.
"Strictly ban hardcoded delays (page.waitForTimeout()); rely exclusively on Playwright web-first auto-waiting assertions (expect(locator).toBeVisible())."
Spring Boot 3 & Java 21
Generate production Windsurf Cascade rules for Spring Boot 3 & Java 21.
"Use jakarta.* packages for persistence, validation, and servlets; ban legacy javax.* imports."
.NET 8 & C# 12 Minimal APIs
Generate production Windsurf Cascade rules for .NET 8 & C# 12 Minimal APIs.
"Use modern C# 12 features: primary constructors, collection expressions, file-scoped namespaces, and nullable reference types (#nullable enable)."
Where are Windsurf rules stored?
Save rule markdown files directly in `.windsurf/rules/` in your project root directory.
Does Windsurf Cascade auto-load rules?
Yes, Windsurf Cascade reads rules inside `.windsurf/rules/` automatically whenever interacting with matching codebase contexts.