viz-lab
Build best-in-class, real-data-grounded visualizations of YURI's own systems — energy/ΔU surfaces, quantum Q-spheres, circuitry graphs (2D edge-bundling + 3D die), telemetry cockpits, embedding atlase
SKILL.mdskills/viz-lab/SKILL.md
GitHubYURI Viz-Lab
Best-tool-per-depiction visualization of YURI's own math, quantum, graph, and telemetry layers. Quality over friction: pick the genuinely strongest tool for each depiction (Python / Rust / JS — whatever wins), and ground every visual in YURI's real code/data, never a lookalike.
Method (the loop that produced the demos/)
- Ground in real data — never synthesize a stand-in. Write a generator under
demos/build/*.mjsthat imports the real YURI module (e.g.computeUfrom_SYSTEM/Scripts/math/yuri-energy.mjs, the exports of_SYSTEM/Scripts/quantum-hypothesis-tracker.mjs) or reads the real artifact (e.g.02_RESOURCES/RESEARCH/yuri-die-graph.json), and emitdemos/data/<x>.jsas awindow.<GLOBAL> = …script. The visual then provably reflects the live system. - Best tool per depiction — map the depiction to its strongest tool (table below); do not default to the readiest one. Stack-agnostic.
- Standalone-first,
file://-safe — one self-contained.htmlthat opens by double-click. CDN module imports (CORS-enabled) + local data loaded as a<script src>global. NEVER a relative ES-module import orfetch()— both are blocked onfile://. - Adversarially verify —
node --checkthe extracted script; confirm everygetElementByIdid resolves; prove fidelity (recompute a data cell against the real function; confirm a real invariant, e.g. the quantum order-effect P(A→B) ≠ P(B→A) with qq ≈ 0); then an independent render-review before claiming it works. First-run success is a hypothesis. - Port, don't rewrite — the standalone renderer ports into the Vite + react-three-fiber app (
_SYSTEM/src/scenes/); the generator re-points from snapshot to live stream.
Depiction → best tool
| YURI object | Depiction | Best tool |
|---|---|---|
| energy gate ΔU / U | 3D surface · isosurface · ridgeline · particle field | three.js (+ bloom) / VTK.js |
| quantum hypothesis sim | Q-sphere · Wigner · Hinton (coupling) | three.js (embed the real tracker) / Qiskit ref |
| circuitry / code graph | hierarchical edge bundling · 3D layered die · GPU force | D3 (HEB) · three.js (strata) · cosmos.gl (scale) |
| alpha factors | correlation clustermap · embedding atlas | seaborn / ECharts · regl-scatterplot + UMAP |
| prediction ledger / decision-sim | calibration diagram · quantile dotplot · fan cone | D3 / Vega · ArviZ |
| lane telemetry / tokens | uPlot + LTTB · horizon · streaming pivot | uPlot · FINOS Perspective |
Default JS stack (drops into the existing three.js@0.173 + R3F + Vite): three.js / R3F for 3D, D3 for graphs/bundling, uPlot for time-series, ECharts-GL / regl / Sigma at scale.
Reference assets (read first)
- Landscape survey — 12 families, every technique mapped to a YURI domain, with sources:
02_RESOURCES/RESEARCH/visualization-landscape-2026-06-16.md(ai search "visualization"). - Proven demos:
demos/vol-surface.html,demos/energy-surface.html,demos/qsphere.html,demos/circuitry-heb.html,demos/circuitry-die-3d.html; generatorsdemos/build/gen-*.mjs.
Rules (failure-anchored)
file://-safe loading only: CDN module imports + local-data globals; no relative module imports /fetch(). <!-- @anchor: v1 | failure: file:// CORS blocks relative ES-module imports + fetch (demos session 2026-06-16) | regression: the node --check + open-in-browser step of this skill -->- Real data, not lookalikes; quality over friction: pick the BEST tool and the MOST COMPLETE real source, not the readiest. <!-- @anchor: v1 | failure: grabbed the 126-node projected graph (least-friction) when the owner wanted the 242-node die/merge — "best results, not least friction" (Marcel 2026-06-16) | regression: the ground-in-real-data + completeness check in this skill -->
- Verify fidelity, not just syntax: recompute a real value, confirm a real invariant, independent render-review before "it works".
- No HUD/Kagami design tokens — style with self-contained purpose-built CSS (standing owner preference).
Session Notes
2026-06-16
- session: 155m | peak ctx: 0% | compacts: 0
- tools: Bash×338, Read×113, Edit×60, Write×21, Agent×14, TodoWrite×5, AskUserQuestion×3, ToolSearch×2, WebSearch×2
- corrections: none
- errors: none