feat: add AGENTS.md for all packages and apps (9 files)

packages/cms-client/AGENTS.md

@@ -0,0 +1,39 @@
+# @repo/cms-client — Dual-Mode Payload Client
+
+Provides typed access to Payload CMS via Local API (primary) or HTTP REST (fallback).
+
+## THIS PACKAGE IS STANDALONE
+
+- NEVER import from: `@repo/cms-core`, `@repo/core`, `apps/*`
+- The Payload instance is INJECTED, not imported
+- Types are generated via `payload generate:types`
+
+## Initialization
+
+| Context | Mode | How |
+|---|---|---|
+| apps/cms server | Local | `getPayload({config})` from @repo/cms-core |
+| apps/web-next server | Local | `getPayload({config})` from @repo/cms-core |
+| apps/web-tanstack server | Local | `getPayload({config})` from @repo/cms-core |
+| Client-side (browser) | N/A | Goes through tRPC — server handles it |
+| External services | HTTP | `createPayloadClient({mode:"http",baseURL})` |
+
+```typescript
+// In app startup (e.g., apps/web-next/src/lib/payload.ts):
+import { getPayload } from "payload";
+import { config } from "@repo/cms-core";
+import { createPayloadClient } from "@repo/cms-client";
+
+const payload = await getPayload({ config });
+const client = createPayloadClient({ mode: "local", payload });
+```
+
+## Available Methods
+
+All methods support full Payload query capabilities (where, sort, limit, depth, page, populate):
+
+- `find(collection, options)` — paginated query
+- `findByID(collection, id, options)` — single document
+- `create(collection, data, options)` — create document
+- `update(collection, id, data, options)` — update document
+- `delete(collection, id)` — delete document