Should CLAUDE.md for a Next.js project repeat the AGENTS.md content?
No. Keep the content in AGENTS.md and import it from CLAUDE.md with the @AGENTS.md line, so Claude Code and every other agent read the same rules and you only edit one file.
A Next.js App Router project backed by Supabase for Postgres, Auth and Storage. These files teach a coding agent where the server and client boundary sits, how to talk to Supabase safely, and which commands prove a change works.
# AGENTS.md
Project: nextjs-supabase-app. A Next.js App Router app backed by Supabase (Postgres, Auth, Storage), deployed on Vercel.
This file is the single source of truth for every coding agent working in this repository. The tool-specific files (CLAUDE.md, GEMINI.md, .github/copilot-instructions.md and .cursor/rules/project.mdc) point here. Edit this file, not those.
## Stack
- Languages: TypeScript, SQL
- Framework: Next.js (App Router)
- Database: Supabase (Postgres)
- Hosting: Vercel
- Tests: Vitest
- Package manager: pnpm
## Commands
Run these from the repository root.
- Install dependencies: `pnpm install`
- Run locally: `pnpm dev`
- Build: `pnpm build`
- Run all tests: `pnpm test`
- Run one test file: `pnpm vitest run path/to/file.test.ts`
- Lint: `pnpm lint`
- Type-check: `pnpm tsc --noEmit`
- Format: `pnpm prettier --write .`
## Project layout
- `app/`: App Router routes, layouts, loading and error boundaries
- `components/`: Shared React components
- `lib/supabase/`: Supabase clients: server.ts for Server Components and actions, client.ts for the browser
- `supabase/migrations/`: SQL migrations, applied with the Supabase CLI
- `types/database.ts`: Generated database types (do not edit by hand)
## Code style
- Indent with 2 spaces. Never tabs.
- TypeScript runs in strict mode. Do not use `any`; use `unknown` and narrow it, or write the real type.
- Match the style and patterns of the surrounding code, even where you would personally choose differently.
- Use named exports. Do not add default exports.
- Never swallow an error. Handle it where you can act on it, or rethrow it with context about what failed.
- Commit messages follow Conventional Commits: `feat:`, `fix:`, `refactor:`, `test:`, `docs:`, `chore:`, with an imperative summary under 72 characters.
## Working rules
- Before you say a task is done, run the test, lint and type-check commands above and make sure they pass. If you could not run them, say so.
- Never write secrets, API keys, tokens or passwords into code, tests, fixtures, logs or commits. Read them from environment variables, and never commit `.env` files.
- Do not add a new dependency without asking first. Prefer the standard library and what is already installed.
- Ask before creating, editing or running database migrations, and never edit a migration that has already been applied.
- Do not hand-edit generated files or lockfiles; change the source and regenerate.
- Change only what the task needs. Do not refactor, rename or reformat unrelated code.
## Product constraints
- Validate all input at the boundary, use parameterized queries only, and treat every external payload as untrusted.
## Project-specific notes
- Components are Server Components by default. Add "use client" only for state, effects, event handlers or browser APIs, and keep client components small and at the leaves.
- Never import the service-role key, or any module that reads it, from client code. Only `NEXT_PUBLIC_` variables may reach the browser.
- Row Level Security is enabled on every table. A new table ships with its RLS policies in the same migration.
- Use the server client from `lib/supabase/server.ts` in Server Components, Route Handlers and Server Actions; use the browser client only in client components.
- Schema changes go in a new file under `supabase/migrations/` created with `supabase migration new`; then regenerate types with `supabase gen types typescript`.
- Mutations go through Server Actions or Route Handlers that re-check the user session; never trust a user id sent from the client.
- Call `revalidatePath` or `revalidateTag` after a mutation that changes cached data.
## Project phase
This project is in active development. Follow the patterns that already exist; consistency beats novelty.
# CLAUDE.md
@AGENTS.md
## Claude Code
- The shared project instructions are imported from AGENTS.md on the line above. Edit AGENTS.md, not this file, so every agent stays in sync.
- Put Claude-only preferences below this line. Personal, uncommitted notes belong in CLAUDE.local.md.
# GEMINI.md
@./AGENTS.md
## Gemini CLI
- The shared project instructions are imported from AGENTS.md on the line above. Edit AGENTS.md, not this file.
- Alternative: delete this file and set "context": { "fileName": ["AGENTS.md"] } in .gemini/settings.json so Gemini CLI reads AGENTS.md directly.
# Copilot instructions
Project: nextjs-supabase-app. A Next.js App Router app backed by Supabase (Postgres, Auth, Storage), deployed on Vercel.
The full instructions are in AGENTS.md at the repository root. Read it before you change code; if anything here disagrees with it, AGENTS.md wins. The essentials are repeated below for Copilot surfaces that only read this file.
## Stack
- Languages: TypeScript, SQL
- Framework: Next.js (App Router)
- Database: Supabase (Postgres)
- Hosting: Vercel
- Tests: Vitest
- Package manager: pnpm
## Commands
- Install dependencies: `pnpm install`
- Run locally: `pnpm dev`
- Build: `pnpm build`
- Run all tests: `pnpm test`
- Run one test file: `pnpm vitest run path/to/file.test.ts`
- Lint: `pnpm lint`
- Type-check: `pnpm tsc --noEmit`
- Format: `pnpm prettier --write .`
## Working rules
- Before you say a task is done, run the test, lint and type-check commands above and make sure they pass. If you could not run them, say so.
- Never write secrets, API keys, tokens or passwords into code, tests, fixtures, logs or commits. Read them from environment variables, and never commit `.env` files.
- Do not add a new dependency without asking first. Prefer the standard library and what is already installed.
- Ask before creating, editing or running database migrations, and never edit a migration that has already been applied.
- Do not hand-edit generated files or lockfiles; change the source and regenerate.
- Change only what the task needs. Do not refactor, rename or reformat unrelated code.
---
description: Project instructions for every task (mirrors AGENTS.md)
globs:
alwaysApply: true
---
# Project rules
The project instructions live in @AGENTS.md at the repository root, which Cursor loads automatically. They are not repeated here, so they cost context only once. Edit AGENTS.md, not this rule.
Before you change code, check the Commands and Working rules sections of AGENTS.md, and run its test and lint commands before you say a task is done.
Put Cursor-only rules below, or add scoped rules as more .mdc files with `globs` (for example `src/components/**/*.tsx`).
These are the exact files the generator writes for this preset. Change any command or rule in the generator and download your own set.
The preset describes a a Next.js App Router app backed by Supabase (Postgres, Auth, Storage), deployed on Vercel. Its AGENTS.md is 52 non-empty lines with 8 exact commands, 5 key directories, and 7 stack-specific rules on top of the shared working rules.
pnpm install, pnpm dev, pnpm build, pnpm test, pnpm vitest run path/to/file.test.ts, pnpm lint, pnpm tsc --noEmit, pnpm prettier --write ..app/, components/, lib/supabase/, supabase/migrations/, types/database.ts.Agents trained on older React habitually add "use client" to the top of every file that imports a hook, which silently turns whole route trees into client bundles and leaks server-only imports. Stating the default explicitly, and asking for client components at the leaves, keeps data fetching on the server where the Supabase session and secrets already live.
The service-role key bypasses Row Level Security entirely. If an agent imports it into a file that a client component also imports, it is bundled and shipped to every visitor. The rule names both the key and the NEXT_PUBLIC_ prefix so the agent can check the boundary mechanically.
A table created without policies is either unreadable or, if RLS is off, readable by anyone with the anon key. Agents often create the table in one step and forget the policies. Requiring both in one migration makes the omission visible in review.
The database types file is regenerated from the schema. When an agent edits it by hand to make a type error go away, the next regeneration erases the fix and the real schema mismatch stays hidden.
NEXT_PUBLIC_ variables may reach the browser.lib/supabase/server.ts in Server Components, Route Handlers and Server Actions; use the browser client only in client components.supabase/migrations/ created with supabase migration new; then regenerate types with supabase gen types typescript.revalidatePath or revalidateTag after a mutation that changes cached data.Want different commands or rules? Load this preset into the generator, change anything, and download your own set.
AGENTS.md is read directly by Codex, Cursor, Windsurf, Cline, Zed and Jules, and by GitHub Copilot's cloud agent, code review and CLI. Claude Code reads it through the generated CLAUDE.md, and Gemini CLI through GEMINI.md. See the compatibility table for details, last verified 2026-11-13.
All presets are on the stacks page.
No. Keep the content in AGENTS.md and import it from CLAUDE.md with the @AGENTS.md line, so Claude Code and every other agent read the same rules and you only edit one file.
Mostly not. The rules assume the App Router, Server Components and Server Actions. For a Pages Router project, change the layout and the client boundary rule in the generator before you download.
The working rules ask the agent to ask before creating or running migrations. That is deliberate: a wrong migration against a shared database is hard to undo. Remove the rule if you work only against a local Supabase instance.
Yes. Copy them into any project, commercial or not, without attribution. They are a starting point: adjust the commands and rules to match your repository.
You do not have to take our word for it. Developer tools show every request a page makes, so you can watch this page work and confirm that nothing you type is sent. The check takes under a minute.
F12, or Cmd+Option+I on a Mac, and select the Network tab.Only the feedback form can add a line to that log, and it sends only the vote and comment you type into it. 2prompt has no server code at all: no API, no model and no database of your files. The production site also sends a Content-Security-Policy header that tells your browser to refuse connections to anywhere except this site, the fonts and the anonymous analytics endpoint.