wehub-resource-sync
36 lines
1.6 KiB
Markdown
36 lines
1.6 KiB
Markdown
# AGENTS.md - Vue demo parity rules
|
|
|
|
## Scope
|
|
|
|
- Scope: `examples/v2/vue/demo/**`.
|
|
- Goal: mirror `examples/v2/react/demo/**` behavior and flow as closely as possible.
|
|
|
|
## Source of truth
|
|
|
|
- Treat the React demo as canonical for routes, runtime wiring, and UI interaction patterns.
|
|
- Prefer equivalent structure and naming when Nuxt conventions allow it.
|
|
- Prefer route-local composition in `pages/*.vue` to mirror React's page-level ownership.
|
|
- Avoid introducing shared wrapper/scaffold components when React does not have an equivalent abstraction.
|
|
|
|
## Parity constraints
|
|
|
|
- Do not add Vue-only product features, routes, or workflow changes.
|
|
- Keep runtime endpoint behavior aligned with React (`/api/copilotkit`, `/api/copilotkit-single`, `/api/copilotkit-mcp`).
|
|
- If a React behavior cannot be mirrored yet because package primitives are missing, keep the route scaffolded and minimal until parity primitives land.
|
|
- Keep file and page responsibilities as close to React as possible so cross-framework diffs are easy to track.
|
|
- If a temporary divergence is unavoidable, make it explicit in the page file and remove it once the matching Vue primitive exists.
|
|
|
|
## Implementation guidance
|
|
|
|
- Mirror route coverage first: `/`, `/single`, `/mcp-apps`, `/sidebar`, `/popup`.
|
|
- Mirror interaction semantics second (thread behavior, tool handling, suggestions, dev console usage).
|
|
- Keep deviations explicit and temporary.
|
|
- For scaffold content, mirror React page copy/layout intent first; avoid inventing alternate demo flows.
|
|
|
|
## Validation
|
|
|
|
Run after meaningful changes:
|
|
|
|
1. `pnpm -C examples/v2/vue/demo dev`
|
|
2. `pnpm -C examples/v2/vue/demo build`
|