39 typescript rules available
Thirty-nine Windsurf rules match typescript, spanning React, Next.js, Angular, NestJS, Prisma, Supabase, Playwright and more; 28 are short. Windsurf's rules documentation now redirects to Devin docs, which use .devin/rules/; legacy .windsurfrules files are still imported. The glob-triggered file below is the strict-typing baseline.
Windsurf's rules documentation (docs.windsurf.com/windsurf/cascade/memories) now redirects to Devin documentation, which describes rules for the Devin Local agent in Devin Desktop. Current rules live in .devin/rules/*.md with a trigger setting, and the legacy Windsurf files (.windsurf/rules/*.md, .windsurf/global_rules.md and .windsurfrules) are still imported by default. AGENTS.md files are read as always-on rules.
.devin/rules/typescript.mdStarting point, not a tested configuration for your repository. Applied when files matching globs are involved (trigger: glob). Review the instructions, adapt the file paths and run your project's existing checks.
--- trigger: glob globs: "**/*.ts,**/*.tsx" --- # TypeScript instructions for Windsurf ## Focus for this project - Define runtime schemas with the project's validator (for example Zod) and derive types with z.infer instead of duplicating interfaces. - Parse external data (API responses, env vars, form input) at the boundary and pass typed values inward. - Do not suppress errors with @ts-ignore; use @ts-expect-error with a reason only when unavoidable. ## TypeScript conventions - Keep "strict": true. Note that noUncheckedIndexedAccess is a separate flag that strict does not enable; respect whichever setting tsconfig.json has. - Use unknown, not any, for untrusted data and narrow it with type guards or a schema validator before use. - Model variants as discriminated unions and end switch statements with an exhaustive never check. - Do not add non-null assertions (!) or as casts to silence an error; fix the type instead and explain any cast that remains. ## Before you finish - Run npx tsc --noEmit plus the project's lint and test scripts and report the actual output. If you cannot run them, say so and list the exact commands instead of saying they pass. - Summarize which of the rules above affected the change. - If a legacy .windsurfrules or .windsurf/rules file gives conflicting guidance, point out the conflict instead of silently choosing one.
Create your own Windsurf rules for TypeScript and share with the community.
Ask for a small change to one matching file. Check the tool's loaded context or instruction view, inspect the diff for the requested convention, and run the relevant build or test. A well-formatted file does not guarantee the model follows every instruction.
The docs recommend keeping rules short and specific. The current docs say AGENTS.md, AGENTS.local.md and AGENT.md are read as always-on rules, including files in subdirectories. Use .devin/rules/ when you need glob, model-decision or manual triggers.
Documentation checked 2026-11-05: Devin docs: Local customizations (redirect target of Windsurf memories docs)Windsurf docs: Cascade memories (redirects)
Illustrative input and expected result. This example is a verification guide, not a recorded model run.
You use the Windsurf agent on a TypeScript codebase with Zod and want validated boundaries and inferred types.
Validate environment variables at startup.
An env schema with required and optional variables, a parse at startup that exits with a readable error, a typed env export used elsewhere, and tsc output.
Content reviewed 2026-11-05. Confirm instruction activation in your installed client before relying on it.
Generate React forms with react-hook-form and Zod: shared schemas, labelled field components, accessible error messages, async validation, submission state and tests.