AGENTS.md for Monorepos

# ROOT FILE: AGENTS.md at the repository root:

# [MONOREPO NAME]

[One sentence: what this monorepo contains, e.g. "pnpm workspace: customer web app, public API, and shared packages."]

## Map
- `apps/web` ([Next.js customer app]) has its own AGENTS.md
- `apps/api` ([Fastify service]) has its own AGENTS.md
- `packages/ui`: [shared component library]
- `packages/config` ([shared tsconfig/eslint) do not modify without asking]

## Repo-wide commands
```bash
pnpm install          # always from the root, never npm/yarn
pnpm turbo run typecheck test lint --filter=[package]...  # verify only affected packages
```

## Repo-wide rules
- Cross-package imports only via workspace aliases (`@repo/ui`), never relative paths reaching into another package's src.
- Shared code changes (`packages/*`) require running the affected downstream apps' tests, not just the package's own.
- One package per PR unless the change is atomic across packages. Say so in the PR title.
- Never edit: `pnpm-lock.yaml` by hand, generated files (`*.gen.ts`), or another package's internals to fix your package's problem.

---

# PACKAGE FILE: apps/web/AGENTS.md (repeat the pattern per package):

# apps/web: [Customer web app]

## Commands (run from repo root)
```bash
pnpm --filter web dev
pnpm --filter web test [path]
pnpm --filter web typecheck
```

## Stack + rules for THIS package
- [Next.js 16 App Router: server components by default; "use client" only at interactive leaves.]
- [Data fetching in server components via `lib/api`, never fetch() directly in components.]
- [Styling: Tailwind only; design tokens come from @repo/ui, no local color values.]
- UI components: check `@repo/ui` first; build locally only what's app-specific, and flag candidates for promotion to the shared package.

## Boundaries
- May import: `@repo/ui`, `@repo/config`, its own code.
- May NOT import: `apps/api` internals. API access goes through [the client in lib/api / generated types].