Platform Specific Architecture

Cursor Prompt Guide

Maximize codebase indexing, @Files context referencing, and targeted diff generation.

View Cursor on AlsoClick → Compatible Skills & Extensions (3+)

Ideal Use Cases & Strengths

Multi-file feature development, inline surgical edits (Cmd+K), codebase-wide reasoning (Composer / Cmd+I), and automated unit test authoring.

Recommended Prompt Architecture

### The Cursor In-Context Engineering Pattern 1. **Target Files**: Explicitly reference files using @filename (e.g. `@lib/db.ts`, `@app/api/route.ts`). 2. **Current State & Invariant**: What is currently happening and what must NOT change. 3. **Target Enhancement**: The exact behavioral modification required. 4. **Execution Rule**: Smallest safe contiguous change, maintaining existing types.

Output Formatting Tips

• Always mention existing test files so Cursor runs or updates them. • Specify contiguous line edits to avoid unnecessary refactoring of whole files.

Common Pitfalls to Avoid

• Asking Cursor to 'improve the code' without specifying target files or measurable goals. • Ignoring lint feedback when Cursor proposes large multi-file diffs.

Advanced Techniques & Power Features

• `.cursorrules` file: Place repository invariants, formatting guidelines, and architectural rules in the project root. • `@Symbols`: Reference specific TypeScript types or functions directly to save token context. • Terminal Command Execution: Allow Cursor to run `npm run typecheck` to verify changes autonomously.

Tested Cursor Templates

Copy, customize, and paste these verified templates directly into Cursor.

CodingCursor

Test-Driven Bug Fix with Minimal Diff

Guides Cursor to make surgical, minimal diffs with accompanying unit tests.

Review @lib/auth.ts and @app/api/auth/route.ts.

Problem:
We are encountering intermittent race conditions during concurrent session refresh requests.

Task:
Implement a mutual exclusion lock or idempotent token check to guarantee single-execution session updates.

Constraints:
- Make the smallest safe contiguous change (under 30 lines).
- Do not introduce external dependencies.
- Update @tests/auth.test.ts with a concurrent simulation test.

Ready to paste