docs: add root AGENTS.md with Cursor Cloud setup notes

[erikconnect]

Summary

Sets up and verifies the Velora development environment (pnpm + Turborepo monorepo). Adds a root AGENTS.md capturing durable, non-obvious startup/run notes for future Cursor Cloud agents.

No application code was changed — only AGENTS.md was added.

Environment

• Node v22 and pnpm 10.33.0 satisfy repo engines (Node ≥20, pnpm ≥10).
• Update script: pnpm install.
• Note: the Ignored build scripts (esbuild, sharp) warning during install is benign here — build, dev, and docs all work without pnpm approve-builds.

Verification

Service / Check	Command	Result
Install	pnpm install	✅
Contract/lint	pnpm verify:contract	✅ 0 issues
Compiler tests	pnpm --filter @velora/compiler test	✅ 8/8
Showcase library tests	pnpm --filter showcase test:library	✅ 10/10
Build	pnpm build	✅
Showcase dev (Vite)	pnpm dev → :5173	✅ HTTP 200
Docs dev (Astro)	pnpm dev:docs → :4321	✅ HTTP 200

Hello-world: opened the showcase, scrolled the animated homepage, configured a scene in the interactive Scene Creator, and exported (copy + download) generated HTML.

velora_showcase_scene_creator_demo.mp4

Velora homepage
Scene Creator configured
Scene export copied

_{To show artifacts inline, enable in settings.}

  

[vercel]

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Actions	Updated (UTC)
velora-showcase	Ready	Preview, Comment	Jun 20, 2026 10:30am