# 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.

**Type:** Rule  
**Tools:** Cursor, Claude Code, Codex  
**Stack:** Next.js, TypeScript, Tailwind  
**Updated:** 2026-06-08

---

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

```md title="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.