Open-source platform for 3D AI agents. Turn text or a photo into a rigged, animated GLB avatar, give it an LLM brain, memory and a wallet, and embed it anywhere with one web component. Remote MCP server, x402 payments, Three.js, browser-native.
JavaScript 3d-generationai-agentsanimationavatardigital-humangenerative-aiglbgltfimage-to-3dllmmcpmcp-servermodel-context-protocolsolanatext-to-3dthreejsweb-componentswebglwebxrx402
prompts(swarm): add the /showcase route work order and the generation-suite gate report
nirholasee55618ed74d
diff --git a/prompts/finish/swarm-100-route-showcase.md b/prompts/finish/swarm-100-route-showcase.mdnew file mode 100644index 000000000..c025930c6--- /dev/null+++ b/prompts/finish/swarm-100-route-showcase.md@@ -0,0 +1,119 @@+# Route audit: /showcase (Showcase)++How to run: paste this file's repo path into a fresh Claude Code chat in this+repository and say "run this work order". This file is fully self-contained:+it depends on no other prompt file anywhere. If sibling swarm-100 files in+prompts/finish/ are gone, that work is done; if present, ignore them.+Every claim below rots; step 0 re-measures, and what you measure wins.++## Operating clause (binding)++- Read CLAUDE.md first. Its rules override everything, including this file.+- Finish 100% in this session. Never end the turn with a question, an option+ list, or an unexecuted plan. A judgment call goes in one line of the final+ report; it never becomes a question that halts work.+- The only permitted stops are the CLAUDE.md stop-and-ask gates: spending real+ funds or any irreversible on-chain write, git push or a production deploy,+ committing content that references a crypto project other than $THREE, and+ destroying unrecoverable data.+- No mocks, no fake data, no placeholder stubs, no unfinished-work markers, no+ commented-out code. Real APIs and real integrations only.+- The em-dash and en-dash characters are banned in everything you write.+- Concurrent agents share this worktree: stage explicit paths only (never a+ bare add-everything), and commit finished work promptly.+- Before committing, run: npm run check:rules -- --paths <files you touched>.+ It must exit 0.++## Step 0: re-derive the current state++1. This route's declared entry (path, description, added date):++ node -e "const p=require('./data/pages.json');for(const s of p.sections)for(const g of s.pages)if(g.path==='/showcase')console.log(JSON.stringify(g,null,2))"++2. Find the serving implementation: grep "/showcase" in vercel.json (the live+ route table server/index.mjs boots from), then list matching files in+ pages/ and src/. STRUCTURE.md maps every surface to its directory if the+ grep is ambiguous.+3. Production right now:++ curl -so /dev/null -w '%{http_code}\n' https://three.ws/showcase++4. Start (or reuse) the local dev server: npm run dev (vite, port 3000).++## Task: audit this one route end to end, then fix everything found++Route: /showcase ("Showcase", section "main").+Declared purpose: AI-powered 3D model viewer showcase: drop in a model and explore it live.++Drive the page in a real headless browser. Playwright is already a dev+dependency; keep your probe script in the session scratchpad, never in the+repo.++1. Load http://localhost:3000/showcase. Record the HTTP status, every console+ error and warning, and every failed network request.+2. Exercise it like a first-time user: click the primary actions, run the+ primary flow if one exists, follow the page's internal links. Every button+ must do something real; every link must resolve. If the page renders data,+ prove in the network log that it came from a live endpoint, not a baked-in+ fallback array.+3. States: verify populated, empty, loading, and error states are designed and+ reachable. Block the page's primary fetch in Playwright and confirm an+ actionable error state appears, not a blank void or a raw exception.+4. Responsive: render at 320, 768, and 1440 px. No horizontal page scroll, no+ overlapping or clipped controls.+5. Accessibility basics: one h1; interactive elements are real buttons or+ links with visible focus states; images carry alt text; form fields have+ labels.+6. Head: a specific title tag and meta description that match the declared+ purpose above.+7. Fix every defect at its root in the page's real source files and re-run the+ probe until clean. Defects in shared modules are in scope when this route+ exercises them.++## Definition of done++- [ ] Local load of /showcase: HTTP 200, zero console errors, zero unhandled+ failed requests (a third-party outage must land in a designed fallback,+ not a broken page).+- [ ] No dead interactive element on the page: no stub href="#", no button+ without a handler, no link to a missing path.+- [ ] Empty, loading, error, and populated states verified.+- [ ] 320 / 768 / 1440 px renders verified clean.+- [ ] Title and meta description present and specific.+- [ ] npm test passes; npm run check:rules -- --paths <touched files> exits 0.+- [ ] Production status from step 0 recorded in the report; if production+ needs a deploy to pick up a fix, the report says so (deploys stay+ owner-gated).++## Never blocked++| Blocker | Resolution (act, do not ask) |+|---|---|+| Missing env var or credential | Check .env and .env.local, then the Cloud Run service env, then Secret Manager (the CLAUDE.md self-unblock playbook has the exact commands). If it truly exists nowhere, wire the code fully behind the env var, prove the wiring with a dry run, and name the single missing var in the report. |+| gcloud not on PATH | Run: export PATH="$HOME/google-cloud-sdk/bin:$PATH" |+| Dev server port 3000 busy | Another agent may be serving this repo; probe it and reuse if so. Otherwise start your own on a free port: npx vite --port 3101 |+| Playwright browser missing | npx playwright install chromium |+| A surface needs a signed-in user | Register a fresh account through the real /register flow against the real API and use it. Never mock the session. |+| A defect sits in code you did not touch | Fix it if it blocks a Definition of done line (root cause it, never mask it). Otherwise note it in the report and continue. |+| An unrelated test is red | Same rule. Never pipe npm test through tail; it masks exit codes. |++## Close out (required)++1. Verify every Definition of done line with the actual command output in+ front of you. Never claim a line you did not verify.+2. Commit with explicit paths and a subject that describes the diff (house+ style: type(scope): what changed and why a reader cares).+3. Delete this prompt file in that same commit:++ git rm prompts/finish/swarm-100-route-showcase.md++ The shrinking directory is this campaign's only progress ledger; there is+ no progress log to update.+4. Final report: what step 0 measured, what changed (file list), evidence per+ Definition of done line, and any one-line judgment calls. No trailing+ questions, no unexecuted plans.++If a line genuinely cannot pass inside this session (an external party must+respond, or an owner-gated action is the final step), finish everything else,+leave this file in place, and state exactly which line remains and who owns+it. Never delete this file on a partial.diff --git a/prompts/roadmap/_generated/generation-suite/gate-after.txt b/prompts/roadmap/_generated/generation-suite/gate-after.txtnew file mode 100644index 000000000..9fe93ab0a--- /dev/null+++ b/prompts/roadmap/_generated/generation-suite/gate-after.txt@@ -0,0 +1,150 @@++> [email protected] gate+> npm run check:conflicts && npm run check:claude && npm run check:vendored && npm run check:fetch-timeouts && npm run check:tdz-bootstrap && npm run check:event && npm run check:cron-syntax && npm run check:studio-openapi && npm run test:gate && npm run test:gate-3d && npm run audit:mcp && npm run audit:mcp-golden && npm run audit:mcp-safety && npm run audit:mcp-catalog && npm run audit:mcp-listing && npm run audit:routes && npm run audit:handlers && npm run audit:pages && npm run audit:links && npm run audit:docs && npm run audit:upstreams && npm run check:tutorials && npm run audit:hidden-guard && npm run audit:inline-handlers && npm run audit:x402-catalog && npm run audit:tokens && npm run audit:guards && npm run audit:tour-atlas && npm run check:ios-icons && npm run check:macos-icon && npm run check:apple-widget+++> [email protected] check:conflicts+> node scripts/check-merge-conflicts.mjs++check:conflicts: no unresolved merge-conflict markers in tracked files++> [email protected] check:claude+> node scripts/check-claude-md.mjs++[check-claude] OK: every script, path, and typography rule in CLAUDE.md matches the repo++> [email protected] check:vendored+> node scripts/check-vendored-workers.mjs++[check-vendored-workers] OK: 27 vendored file copies across 32 workers are byte-identical++> [email protected] check:fetch-timeouts+> node scripts/check-fetch-timeouts.mjs++check:fetch-timeouts: every external fetch, and every fetch under api/, is bounded by a deadline++> [email protected] check:tdz-bootstrap+> node scripts/check-tdz-bootstrap.mjs++check:tdz-bootstrap: no bootstrap-before-state ordering in 1601 browser module(s)++> [email protected] check:event+> node scripts/check-event-window.mjs++[check-event] OK: public/event.json carries the explicit no-event state, so no event is configured (a supported state)++> [email protected] check:cron-syntax+> node scripts/check-cron-drift.mjs --offline++Declared crons in vercel.json: 114+Most frequent:+ every 1m /api/cron/economy-tick+ every 1m /api/cron/three-market-refresh+ every 1m /api/cron/avaturn-seed-cron+ every 1m /api/cron/flush-usage-events+ every 1m /api/cron/forge-finalize++All cron expressions are valid (offline mode: live jobs not compared).++> [email protected] check:studio-openapi+> node scripts/sync-studio-openapi.mjs --check++3D Studio OpenAPI in sync: prompts/store-submissions/_generated/openai-actions.yaml matches public/.well-known/3d-studio-openapi.yaml.++> [email protected] test:gate+> node scripts/test-gate.mjs++[test-gate] running 7 critical-path test files…++ RUN v4.1.9 /workspaces/three.ws+++ Test Files 7 passed (7)+ Tests 86 passed (86)+ Start at 07:48:12+ Duration 5.38s (transform 6.82s, setup 0ms, import 15.23s, tests 3.68s, environment 1ms)++[test-gate] ✓ all critical-path tests passed++> [email protected] test:gate-3d+> vitest run tests/glb-canonicalize.test.js tests/animation-retarget.test.js tests/animation-retarget-rest-pollution.test.js tests/viewer-framing.test.js+++ RUN v4.1.9 /workspaces/three.ws+++ Test Files 4 passed (4)+ Tests 559 passed (559)+ Start at 07:48:19+ Duration 1.49s (transform 716ms, setup 0ms, import 1.79s, tests 1.10s, environment 1ms)+++> [email protected] audit:mcp+> node scripts/audit-mcp-manifests.mjs++[audit:mcp] 50 MCP manifests consistent++> [email protected] audit:mcp-golden+> node scripts/audit-mcp-golden.mjs++[audit:mcp-golden] 307 hosted MCP tool contracts match the golden fixture++> [email protected] audit:mcp-safety+> node scripts/audit-mcp-safety.mjs++[audit:mcp-safety] 307 MCP tool annotations verified against handler behavior across 248 files, 6 reviewed exemption(s)++> [email protected] audit:mcp-catalog+> node scripts/build-mcp-catalog.mjs --check++[audit:mcp-catalog] catalog matches source: 307 tools across 40 servers++> [email protected] audit:mcp-listing+> node scripts/build-mcp-listing-source.mjs --check++[mcp-listing-source] up to date: 50 servers (7 remote, 43 stdio)++> [email protected] audit:routes+> node scripts/verify-routes.mjs --strict++Route verify: 793 catalog pages, 1313 main routes, 1 post-filesystem routes.+ modeled dist files: 2936 · canonical-covered: 793 · literal page routes checked for shadows: 580+ filesystem boundary (handle:filesystem) present: yes++✓ static checks pass: every catalog page reachable, unknown paths → designed 404, no shadowed page routes.++> [email protected] audit:handlers+> node scripts/audit-empty-handlers.mjs++✓ audit-empty-handlers: all API handlers export a body (2195 checked)++> [email protected] audit:pages+> node scripts/audit-page-index.mjs --strict++Route audit: 166 auditable page routes, 793 documented in pages.json.+✓ Every auditable page route is documented.++> [email protected] audit:links+> node scripts/audit-links.mjs++Link audit: scanned 2253 files++Broken internal links : 0++Stub hrefs (#, void(0)) : 0++Dangling routes (→ missing file) : 0++External links collected : 556+ (run with --external to probe liveness)++Dynamic targets skipped : 1376++> [email protected] audit:docs+> node scripts/audit-docs.mjs+++Public docs missing from data/pages.json (live but undiscoverable) (1):+ docs/sim-readiness.md served at /docs/sim-readiness but absent from data/pages.json, so no crawler can find it. Add an entry there, or add the slug to UNPUBLISHED_DOCS in this script with the reason it stays unpublished.++docs audit: 1 finding(s) across 1514 files.