Cursor Project Rules

Requires: Cursor installed · A project folder

1. 1

   Create the rules directory

   Add a `.cursor/rules/` folder at your project root and create a `.mdc` file per rule.

   shellCopy

   mkdir -p .cursor/rules && touch .cursor/rules/conventions.mdc

2. 2

   Write the rule with frontmatter

   The frontmatter's globs/alwaysApply control when the rule loads; the body is the instruction.

   configCopy

   ---
   description: Enforce our TypeScript API conventions
   globs: ["**/*.ts", "**/*.tsx"]
   alwaysApply: false
   ---
   
   - Validate all request bodies with zod.
   - Return typed Result objects; do not throw across module boundaries.
   - Co-locate a Vitest test with every new module.

You want new endpoints to always include validation and a test.

What to expect: With the conventions rule in place, Cursor scaffolds the endpoint with zod validation and a co-located test without you spelling out each convention.

• Keep each rule short and single-purpose; several focused rules beat one giant file.