example-authoring

name	example-authoring
description	Add, update, or review Agent UI examples, recipes, fixture routes, docs-site examples, Next.js/Vite integrations, local Codex web demos, theming recipes, uploads examples, dynamic tools examples, or example documentation. Use when working in examples/, docs/examples/, docs/recipes/, fixture routes, or browser-visible sample apps.

Example Authoring

Use this skill for examples, recipes, fixture routes, and example docs. Examples are validation surfaces for the library, not independent product experiments.

First Pass

1. Classify the example using example types.
2. Read the existing example README and matching docs page.
3. Keep the product boundary in example boundaries.
4. Use --aui-* tokens and the public stylesheet contract.
5. Add or update focused tests/docs when the example changes public guidance or browser-visible contracts.

Implementation Rules

• Use package public imports only.
• Import @nyosegawa/agent-ui-react/styles.css once.
• Keep route/example CSS token-based.
• Keep fixture routes deterministic and separate from real App Server coverage.
• Keep real-local examples focused on bridge, auth/account/model/thread/turn, approvals, uploads, streaming, steer, interrupt, and token usage behavior.
• Keep host-owned runtime decisions in examples or docs, not public package internals.

Validation

Run the example's typecheck/build when available. For visible changes, run the relevant Playwright suite or browser QA. For package export or stylesheet changes, use release-validation guidance.

Report the example type, changed routes, public guidance updated, commands run, and any remaining manual browser checks.