// Full project workflow for the three.ws platform. Use when: developing features, debugging, modifying UI, understanding architecture, running dev server, or making code changes anywhere in the repo (viewer, agent runtime, API, contracts).
| name | 3d-viewer |
| description | Full project workflow for the three.ws platform. Use when: developing features, debugging, modifying UI, understanding architecture, running dev server, or making code changes anywhere in the repo (viewer, agent runtime, API, contracts). |
| argument-hint | Describe what you want to do |
three.ws started as a glTF 2.0 / GLB viewer and grew into a full embodied-agent platform. Live at three.ws. Read /CLAUDE.md first — this skill is an index; the CLAUDE.md files are the source of truth.
agent-identity.js), memory (agent-memory.js), skills (agent-skills.js), avatar emotion (agent-avatar.js), LLM runtime (runtime/), wallet identity (erc8004/), protocol bus (agent-protocol.js).The viewer never imports the agent half. The agent layer wraps the viewer through runtime/scene.js (SceneController).
| Area | Path | Scoped doc |
|---|---|---|
| Browser app (viewer + agent) | src/ | src/CLAUDE.md |
| Vercel serverless API | api/ | api/CLAUDE.md |
| ERC-8004 Solidity registries | contracts/ | contracts/CLAUDE.md |
| Format specs | specs/ | — |
| Priority-stack build prompts | prompts/ | prompts/INDEX.md |
| User-facing docs | docs/ | — |
| Static pages / assets | public/ | — |
| SDK package | sdk/ | — |
Top-level HTML entries: index.html, features.html, embed.html, agent-home.html, agent-embed.html. Additional routes are rewritten by the vercel-rewrites middleware in vite.config.js and mirrored in vercel.json.
GLTFLoader, DRACOLoader, KTX2Loader, MeshoptDecoder, OrbitControlsapp and lib)npm install
npm run dev # app dev server on :3000
npm run dev:lib # library build watch
npm run build # app → dist/
npm run build:lib # web component → dist-lib/
npm run build:all # both
npm run deploy # build + vercel --prod
npx prettier --write <file>
node --check <file.js>
No automated test suite (npm test exits 0). Verify with node --check, npm run build, and manual smoke at localhost:3000.
src/ or api/)sdk/ may use TS.jsx files, jsxFactory: 'vhtml'src/app.js: model, widget, agent, kiosk, brain, proxyURL, preset, cameraPosition, register{ ok: true, ... } or { ok: false, error: 'msg' }_underscore privateThe order of work is fixed in prompts/INDEX.md:
If a task isn't in a band, ask first. Side lanes (pretext/, scalability/, widget-studio/ polish, CLI, AR, screenshot export) are explicitly deprioritized.
src/viewer.js and src/viewer/*.js (see 3d-features)src/validator.js + src/components/validator-*.jsx (see model-validation)src/agent-*.js, src/runtime/, src/skills/, src/memory/ — read src/CLAUDE.mdapi/ — read api/CLAUDE.mdcontracts/ — read contracts/CLAUDE.mdsrc/app.js (don't create a new routing layer).md files unless asked.node --check every modified JS. npm run build before reporting done. Report both outputs.Files off-limits in prompt files — parallel work may touch them.forge script --broadcast without explicit user approval. Deployed contract addresses are immutable.Drives live avatar movement from the real pump.fun PumpPortal feed.
Inspect and manage creator fees on pump.fun — determine fee destinations (cashback, shared config, or direct creator), collect fees, distribute shared fees to shareholders, and query vault balances. Prefer runnable Node scripts in this skill folder; use @pump-fun/pump-sdk and @pump-fun/pump-swap-sdk for custom integrations.
Create coins on pump.fun — standard create with initial buy. Prefer runnable Node scripts in this skill folder; use @pump-fun/pump-sdk for custom integrations.
Buy and sell tokens on pump.fun bonding curve and pump swap AMM pool, and query SOL/token balances. Prefer runnable Node scripts in this skill folder; use @pump-fun/pump-sdk and @pump-fun/pump-swap-sdk for custom integrations.
Build, deploy, and configure the 3D viewer app. Use when: running dev server, building for production, deploying to Vercel, configuring CORS, editing vercel.json routes, managing static assets, or troubleshooting build issues.
Add or modify Three.js 3D features in the viewer. Use when: adding rendering features, new GUI controls, camera behavior, loaders, post-processing, environment maps, animation features, display toggles, materials, or extending the Viewer class.