메뉴
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).
Codex 또는 Claude로 설치 이 Prompt를 복사해 Codex, Claude 또는 다른 어시스턴트에 붙여 넣으면 Skill 페이지를 검토하고 설치를 진행할 수 있습니다.
SOC 직업 분류 기준
Drives live avatar movement from the real pump.fun PumpPortal feed.
Use when the user wants to charge users for actions. Use @pump-fun/agent-payments-sdk, to build Solana payment transactions, verify on-chain invoice payments, or integrate Solana wallet adapters for agent payment flows.
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.
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.
Wave at the user with context-appropriate enthusiasm.
| 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.