跳至正文
OpenAgentSkill
浏览已开放 · 目录记录日期 2026-11-21 · 自动更新和账户服务暂时关闭。
其他技能

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/landing is now the self-contained static site with no src/ and no GL surface, owned by project-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 on feat/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/animation useFrame loops.
  • shader-engineer: all GLSL, custom postprocessing Effect/Pass classes, onBeforeCompile material patches, src/post/**, the Gerstner/caustics/godrays/VAT-decode shader math. Hand those to shader-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.

PackagePinWhy / peer note
three0.185.1the ~0.185 line R3F v9 + drei target
@react-three/fiber9.6.1pairs with React 19 (peer react >=19 <19.3, three >=0.156)
@react-three/drei10.7.7peer @react-three/fiber ^9.0.0, three >=0.159, react ^19
postprocessing6.39.2pmndrs composer; peer three >= 0.168.0 < 0.186.0 (0.185.1 OK). See caveat below
three-good-godrays0.12.0shadow-map raymarched shafts. PEER MISMATCH - see caveat, unresolved pin
gsap3.15.0ONE ScrollTrigger master timeline, scrub:true
lenis1.3.25owns document scroll; rAF driven from gsap.ticker
detect-gpu5.0.70startup quality tier (no three peer)
zustand5.0.14per-frame scroll/store reads via getState(), never a per-frame hook selector
VAT playbackin-housethree-vat does NOT exist on npm. In-house shader; see VAT caveat below
react / react-dom19.2.7R3F v9 requires React 19 (peer >=19 <19.3)
next16.2.10static export (output: 'export')
typescript
阅读完整来源 ↗