AGENTS.md@apps/web · diff

git:20260827.ca77bd1 to git:20260918.f718b41

10 added, 0 removed. Audit A to A.

# AGENTS.md — apps/web

Execution contract for the authenticated dashboard app.

## Scope

Applies to everything under `apps/web/`.

## Source Of Truth

- App Router structure: `src/app`

- Shared web auth helpers and tenant resolution: `src/lib/auth.ts`

- Organization and workspace state helpers: `src/lib/active-organization.ts`,

`src/lib/workspace-selection.ts`

- API client generation target: `src/lib/api/types.generated.ts`

- Settings and shell behavior: `src/components`, route handlers under `src/app/api`

If a frontend behavior is derived from API contracts, regenerate types from

`backends/gateway` instead of hand-editing generated API types.

## Defaults

- Default to Server Components. Add `"use client"` only when interactivity or

browser APIs are required.

- Reuse `@nebutra/ui` and tokenized styling. Do not create app-local visual

primitives unless the package boundary is clearly wrong.

- Keep server actions and route handlers predictable and testable. Prefer stable

JSON or redirect contracts over ad hoc exceptions.

- When touching auth, organization, notifications, or settings flows, add or

update route or action contract tests.

## Do Not Edit Directly

- `.next/`

- generated API types in `src/lib/api/types.generated.ts`

Regenerate generated API types with:

```bash

pnpm --filter @nebutra/gateway generate:spec

pnpm --filter @nebutra/web generate:api-types

```

## Validation

Use the smallest relevant set:

```bash

pnpm --filter @nebutra/web exec vitest run <targeted-tests>

pnpm --filter @nebutra/web exec tsc --noEmit --pretty false

```

If you modify route handlers or server actions, prefer targeted tests before

typecheck.

+

+ # This is NOT the Next.js you know

+ This version has breaking changes — APIs, conventions, and file structure may all differ from your training data. Read the relevant guide in `node_modules/next/dist/docs/` (resolved from this file's directory; in monorepos the `next` package may not be visible from the repo root) before writing any code. Heed deprecation notices.

+ This block is written and re-added by `next dev` — verify at `node_modules/next/dist/server/lib/generate-agent-files.js`. Removing it from a diff only re-creates the uncommitted change; committing it with your work keeps the tree clean.

+