Next.js 15 & React 19 .cursorrules: The Definitive Guide to Eradicating Server Action Slop

The Root Cause of Next.js 15 AI Hallucinations

When asking AI tools like Cursor or Copilot to create a data mutation in Next.js 15, models trained predominantly on 2021-2023 codebases fall back to legacy anti-patterns:

1. **Unnecessary Client Boundary Pollution:** Automatically prepending `'use client'` to every file, which breaks React Server Component (RSC) streaming and inflates client bundle sizes. 2. **Zombie useEffect Data Fetching:** Generating client-side `fetch()` inside `useEffect()` hooks without cleanup or caching, causing layout shifts and race conditions. 3. **Unvalidated Server Actions:** Treating Server Action arguments as trusted inputs without running runtime validation.

// ❌ WHAT UNCONSTRAINED AI GENERATES:
'use client';
import { useEffect, useState } from 'react';

export default function UserProfile({ id }: any) { const [data, setData] = useState(null); useEffect(() => { fetch('/api/user?id=' + id).then(r => r.json()).then(d => setData(d)); }, []); return <div>{data?.name}</div>; } ```

The Zero-Slop Architecture Solution

By placing a strict `.cursorrules` file in your repository root, you force Cursor's AST parser to bind model output to modern React 19 and Next.js 15 standards:

// ✔ WHAT FCKAISLOP RULES FORCE THE AI TO WRITE:
import { z } from 'zod';
import { db } from '@/lib/db';
import { auth } from '@/lib/auth';

const UserQuerySchema = z.object({ id: z.string().uuid() });

export async function UserProfile({ id }: { id: string }) { const session = await auth(); if (!session?.userId) return null;

const parsed = UserQuerySchema.safeParse({ id }); if (!parsed.success) return <div>Invalid user identity</div>;

const user = await db.user.findUnique({ where: { id: parsed.data.id } }); return <div>{user?.name}</div>; } ```

Key Architectural Takeaways: - **Server by Default:** Only add `'use client'` if listening to browser events. - **Strict Zod Boundary:** Never mutate database state without `safeParse()`. - **Structured Error Contracts:** Return typed Result objects rather than unhandled server throws.