diff --git a/AGENTS.md b/AGENTS.md
index 95d8f22..5f43ae7 100644
--- a/AGENTS.md
+++ b/AGENTS.md
@@ -32,6 +32,8 @@ Useful root scripts:
 Guidance for `apps/web` and related frontend work:
 
 - **shadcn UI primitives** live under `apps/web/src/components/ui/`. **Do not edit files in that directory** unless it is clearly necessary (for example, a defect that cannot be fixed by composing or wrapping components elsewhere). Prefer new or adjusted code outside `ui/`.
+- Playground examples live in `examples/`. Do not edit the generated `apps/web/src/assets/examples.json` manually; regenerate it with `bun run --filter @playground/web gen:examples`. The initial example is selected by `DEFAULT_FILE` in `apps/web/src/components/file-route-sync.tsx`; update it when changing the default example.
+- Example output is covered by Playwright golden files in `e2e/fixtures/examples/`. After an intentional example or runtime-output change, refresh and review them with `bun test:e2e:update-examples`. Update service-example requests and responses in `e2e/tests/examples.spec.ts` when applicable.
 
 ## Task completion