AGENTS.md for a Next.js App Router project
A starting AGENTS.md that tells coding agents how to build, test and change a Next.js App Router codebase safely: commands, boundaries and what never to do without asking.
Type: AGENTS.md
KitLocal never writes files to your computer. Copy the result or download it yourself.
Fill in the variables
What you type stays in this browser. It is not added to the URL, saved, or sent anywhere.
Preview
Still needed: Project name
# {{projectName}}: agent guide
Next.js 16 (App Router), TypeScript, managed with npm.
## Commands
- Install: `npm install`
- Test: `npm test`
- Lint and type-check: `npm run lint && npx tsc --noEmit`
Run the lint/type-check and the tests you touched before saying a change is done.
## Architecture rules
- Pages and layouts are Server Components by default. Add `"use client"` only to the smallest
interactive leaf component.
- Never import server-only modules, secrets or non-`NEXT_PUBLIC_` environment variables into a
Client Component.
- `params` and `searchParams` are async in current Next.js versions: await them.
- Do not read `window`, `localStorage` or `Date.now()` during render.
## Working agreement
- Keep diffs focused on the request. Do not reformat or refactor unrelated files.
- Do not upgrade framework dependencies or change build/cache configuration unless asked.
- Do not commit, push or deploy; propose the commit message instead.
- If a requirement is ambiguous, ask before guessing.
## Project-specific rules
About this catalog
Bundled snapshot · published Nov 15, 2026, 6:05 AM · Catalog revision 5bc079fe355af2214bc0
Showing the snapshot bundled with this app (no content source is configured). Newer content may exist at the source.