webgl-standards
DORMANT (ADR-0017, 2026-07-20) - the TERMINAL VELOCITY scroll-film was retired and apps/landing is a static site with no GL surface; this skill is preserved for any future WebGL rebuild (conventions, verified version pins, playhead/scroll-rig/VAT/Gerstner/post-chain patterns, budgets, gate + semantic-layer machinery). Do not load for current apps/landing work - the static site routes to project-steward.
saeedkolivand · 已有静态检查记录
安装与使用
运行命令前先阅读来源与依赖说明。复制命令不会自动安装或执行。
npx skills add saeedkolivand/ai-job-hunter-app --skill webgl-standards技能说明
name: webgl-standards description: DORMANT (ADR-0017, 2026-07-20) - the TERMINAL VELOCITY scroll-film was retired and apps/landing is a static site with no GL surface; this skill is preserved for any future WebGL rebuild (conventions, verified version pins, playhead/scroll-rig/VAT/Gerstner/post-chain patterns, budgets, gate + semantic-layer machinery). Do not load for current apps/landing work - the static site routes to project-steward.
apps/landing WebGL standards (TERMINAL VELOCITY)
DORMANT — ADR-0017 (2026-07-20). The scroll-film was retired mid-M4;
apps/landingis now the self-contained static site with nosrc/and no GL surface, owned byproject-steward. Everything below is preserved verbatim as the starting point for a future WebGL rebuild (M1-M3 remain in git history at #720-#722; the M4 tree is stashed onfeat/tv-m4-robot). Do not apply it to the static site.
The single source both GL authors (webgl-author, shader-engineer) and their critics
(webgl-reviewer, gate-auditor, webgl-perf-profiler) read before touching apps/landing.
Experience contract + rationale: docs/knowledge/decision-records/0016-terminal-velocity-scroll-film-landing.md (the
source of truth). Still-binding structural machinery (Next 16 static export, Semantic layer,
Experience gate, landing/ passthrough, staged flip): docs/knowledge/decision-records/0014-landing-gl-takeover.md.
The ADR holds the decisions; this skill holds the tunable numbers and their current starting
values. Every constant below marked tunable may move within its ADR envelope during M1..M6.
What TERMINAL VELOCITY is
A realistic CG scroll-film (~2:40). Scroll IS the playhead (native-scroll -> timeline 0->1), fully reversible: scrolling up rewinds. One camera, one continuous vertical world, zero cuts - a burned-out job hunter tips off his chair at 2:47 AM and falls through a canyon of rejection towers into a paper ocean to the lightless bottom, where a robot finds him and carries him back up to dawn. It does everything except press send (the finale SEND button is the one real action). Copy is diegetic and in-world; the prerendered Semantic layer keeps the machine-readable and crawlable copy. RIPBOOK (the notebook / rip / boil / in-canvas SDF model) is fully retired - see ADR 0016 Supersessions; do not carry any RIPBOOK rule forward.
Ownership split (who edits what)
webgl-author: the R3F scene graph, the scroll rig + store + governor wiring, instancing and DataTexture bookkeeping, glTF-clip mixer scrub, asset loading + KTX2/DRACO decoder wiring, the a11y overlay + semantic layer, camera/animationuseFrameloops.shader-engineer: all GLSL, custom postprocessingEffect/Passclasses,onBeforeCompilematerial patches,src/post/**, the Gerstner/caustics/godrays/VAT-decode shader math. Hand those toshader-engineer; the author wires the material + uniforms, never authors the shader.
The stack + version pins (verified 2026-07-18 - do NOT drift)
Full-canvas R3F v9 + three 0.185 on a WebGL2 lane for v1 (TSL/WebGPU is a deliberate tier-up
experiment only - it would force rebuilding the whole post chain). Every pin below was verified
with npm view <pkg> version / ... peerDependencies; the lockfile must match apps/landing/package.json.
| Package | Pin | Why / peer note |
|---|---|---|
| three | 0.185.1 | the ~0.185 line R3F v9 + drei target |
| @react-three/fiber | 9.6.1 | pairs with React 19 (peer react >=19 <19.3, three >=0.156) |
| @react-three/drei | 10.7.7 | peer @react-three/fiber ^9.0.0, three >=0.159, react ^19 |
| postprocessing | 6.39.2 | pmndrs composer; peer three >= 0.168.0 < 0.186.0 (0.185.1 OK). See caveat below |
| three-good-godrays | 0.12.0 | shadow-map raymarched shafts. PEER MISMATCH - see caveat, unresolved pin |
| gsap | 3.15.0 | ONE ScrollTrigger master timeline, scrub:true |
| lenis | 1.3.25 | owns document scroll; rAF driven from gsap.ticker |
| detect-gpu | 5.0.70 | startup quality tier (no three peer) |
| zustand | 5.0.14 | per-frame scroll/store reads via getState(), never a per-frame hook selector |
| VAT playback | in-house | three-vat does NOT exist on npm. In-house shader; see VAT caveat below |
| react / react-dom | 19.2.7 | R3F v9 requires React 19 (peer >=19 <19.3) |
| next | 16.2.10 | static export (output: 'export') |
| typescript |