AGENTS.md-Regeln für eine Next.js SaaS-App
Ein einsatzbereites AGENTS.md, das KI-Codierungsagenten im Stack und im Einklang mit den Konventionen einer Next.js SaaS-Codebasis hält.
CursorClaude CodeCodex Next.jsTypeScriptTailwind
Fügen Sie dies als AGENTS.md in Ihr Repository-Root ein. Die meisten Agenten (Codex, Cursor, Claude Code) lesen es automatisch und behandeln es als Projektregeln.
AGENTS.md
# Project Rules
## Stack- Next.js (App Router) + TypeScript (strict).- Tailwind CSS v4. No CSS-in-JS.- PostgreSQL via the existing db client in `src/lib/db.ts`.
## Hard rules- Never add a dependency without listing it and why first.- Server Components by default. Only add `"use client"` when you need state, effects, or browser APIs — and keep those components small.- All env vars go through `src/lib/env.ts` (zod-validated). Never read `process.env` directly in app code.- Never put secrets or server-only code in a Client Component.
## Conventions- Co-locate route code under `app/`. Shared logic lives in `src/lib/`.- Use the existing UI primitives in `src/components/ui/` before adding new ones.- Write the diff and wait for approval before editing more than 3 files.
## Definition of done- `bun run typecheck` and `bun run lint` pass.- No new `any`. No unused exports.Warum diese Regeln
- “Server Components als Standard” ist der größte Hebel für die Qualität in App Router-Projekten — siehe das zugehörige Fehlermuster bei Server-in-Client-Code.
- Zentrale Umgebungsvariablenvalidierung verhindert die häufigste Klasse von KI-Fehlern: das stille Auslesen eines undefinierten
process.env-Werts.
Geeignet für
- Mittelgroße Next.js SaaS-Apps mit einem etablierten Konventionsset.
Nicht geeignet
- Greenfield-Prototypen, bei denen der Agent schnell und locker agieren soll.