Skip to content

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.

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.md
new file mode 100644
index 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.txt
new file mode 100644
index 000000000..9fe93ab0a
--- /dev/null
+++ b/prompts/roadmap/_generated/generation-suite/gate-after.txt
@@ -0,0 +1,150 @@
+
+> 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.