chore: prepare public release

Author: Cheerego7

AGENTS.md

@@ -9,6 +9,31 @@ files, snapshots, or render masters to Git. Third-party application and Agent no
 generated neutral geometry. OOMOL and Open Connector artwork is excluded from the MIT
 code license; read `assets/ATTRIBUTION.md` before replacing or redistributing it.
 
+## Agent Reading Workflow
+
+When the user asks to study, explain, or learn from this repository, stay read-only unless
+they also ask for a change. Read `docs/agent-reading-guide.md` first, classify the request,
+and follow the smallest matching route:
+
+- HyperFrames structure: `README.md`, `DESIGN.md`, `docs/hyperframes-patterns.md`, then the
+  composition contract in `index.html` and timeline registration in `src/timeline.js`.
+- Animation and motion: `docs/animation-breakdown.md`, then only the named constants and
+  `derive*State()` functions in `src/icon-data.js`, `src/timeline.js`, or `src/orbit-scene.js`.
+- Sound design: `docs/sound-design.md`, `assets/audio/sfx/cues.json`, and
+  `scripts/audio/generate-sfx.mjs`.
+- Customization: `docs/customization.md`, `assets/ATTRIBUTION.md`, then the source and tests
+  for the requested scene or sound.
+- Verification or release: `RELEASE_CHECKLIST.md`, `package.json`, the relevant tests, and
+  the current Git state.
+
+Do not read the largest source files from top to bottom before mapping their exported symbols
+with `rg`. In explanations, cite the exact file and symbol that supports each claim, separate
+observed behavior from inference, and name the command that verifies any runnable claim.
+
+The rendered SFX files and SFX-only timeline are released under CC0 1.0. They may be copied,
+modified, redistributed, or used commercially without permission or attribution. The audio
+synthesis scripts remain MIT licensed.
+
 ## Skills — USE THESE FIRST
 
 **Always invoke the relevant skill before writing or modifying compositions.** Skills encode framework-specific patterns (e.g., `window.__timelines` registration, `data-*` attribute semantics, shader-compatible CSS rules) that are NOT in generic web docs. Skipping them produces broken compositions.

README.md

@@ -14,8 +14,9 @@ procedurally generated sound. The repository contains the composition source,
 the isolated sound effects, the synthesis scripts, and runtime checks that
 protect its camera and handoff geometry.
 
-[中文说明](README.zh-CN.md) · [Animation breakdown](docs/animation-breakdown.md) ·
-[Sound design](docs/sound-design.md) · [HyperFrames patterns](docs/hyperframes-patterns.md)
+[中文说明](README.zh-CN.md) · [Read with an agent](docs/agent-reading-guide.md) ·
+[Animation breakdown](docs/animation-breakdown.md) · [Sound design](docs/sound-design.md) ·
+[HyperFrames patterns](docs/hyperframes-patterns.md)
 
 ## What this demonstrates
 
@@ -26,6 +27,16 @@ protect its camera and handoff geometry.
 - A 30-second SFX timeline synthesized locally from JavaScript.
 - Runtime assertions for camera continuity, high-density canvas output, and semantic carriers.
 
+## How I made this film
+
+I set the product story and motion direction, then made the visual calls in each iteration.
+The agent turned those decisions into HTML animation addressed by absolute frame. I reviewed
+key frames, transition boundaries, and object continuity while iterating, then rendered the
+full film once the picture was settled. Programmatic sound and picture share one timeline.
+HyperFrames can also create background music in a chosen style and place it on that timeline.
+This repository keeps the public composition SFX-only; any other audio used in a separately
+hosted release cut is mixed later in editing software and is not part of this repository.
+
 ## Requirements
 
 - Node.js 22 or newer
@@ -44,6 +55,20 @@ npm run dev
 `npm run dev` builds the deterministic textures and JavaScript bundle, then starts the
 HyperFrames preview server. It is a long-running process; stop it with `Ctrl+C`.
 
+## Read with an agent
+
+Start an agent in this repository and paste:
+
+```text
+Read AGENTS.md and docs/agent-reading-guide.md first. Stay read-only. Explain how this
+composition uses HyperFrames, absolute-frame state, DOM-to-Three.js handoff, and procedural
+sound. Cite the exact files and symbols I should study next. Do not summarize files that are
+unrelated to my question.
+```
+
+The [agent reading guide](docs/agent-reading-guide.md) also includes shorter routes for motion,
+sound design, customization, and release verification.
+
 Useful commands:
 
 ```bash
@@ -102,12 +127,13 @@ after changing geometry or timing.
 ## Licensing
 
 - Composition source, scripts, tests, and documentation: MIT, see `LICENSE`.
-- Rendered isolated SFX and the SFX-only timeline: Creative Commons Attribution 4.0, with the
-  exact credit line in `assets/audio/LICENSE.md`.
+- Rendered isolated SFX and the SFX-only timeline: CC0 1.0. They may be copied, changed,
+  redistributed, or used commercially without permission or attribution. See
+  `assets/audio/LICENSE.md`.
 - Manrope and IBM Plex Mono font files: SIL Open Font License 1.1, see the
   license files under `assets/fonts/`.
 - The bundled OOMOL and Open Connector artwork is included with OOMOL's approval for
-  identifying this repository and demo. It is excluded from MIT and CC BY 4.0.
+  identifying this repository and demo. It is excluded from MIT and the CC0 audio dedication.
 - No third-party application or Agent logo artwork is bundled. Their visible nodes are
   generated neutral geometry; names retained in source data are nominative identifiers.
 - GSAP is installed under its own Standard “No Charge” License, not MIT.

README.zh-CN.md

@@ -7,8 +7,9 @@
 仓库同时公开成片源码、独立音效、合成脚本，以及保护相机和交接几何的运行时验证。
 公开版中的第三方应用与 Agent 节点均为程序生成的中性占位图形；带品牌图标的原片不随仓库分发。
 
-[English](README.md) · [动画拆解](docs/animation-breakdown.md) ·
-[声音设计](docs/sound-design.md) · [HyperFrames 模式](docs/hyperframes-patterns.md)
+[English](README.md) · [让 Agent 阅读项目](docs/agent-reading-guide.md) ·
+[动画拆解](docs/animation-breakdown.md) · [声音设计](docs/sound-design.md) ·
+[HyperFrames 模式](docs/hyperframes-patterns.md)
 
 ## 这个案例展示了什么
 
@@ -19,6 +20,14 @@
 - 完全由 JavaScript 振荡器、包络与确定性噪声生成的 30 秒音效时间线。
 - 对相机连续性、DPR=2 画布、语义载体和公开安全资产的自动验证。
 
+## 我是怎么完成这支片子的
+
+我负责产品叙事、运动方向和每轮的画面判断，Agent 负责把这些要求实现成可定位到绝对帧的 HTML
+动画。迭代时主要检查关键帧、转场边界和对象连续性，确认画面后再渲染整片。程序化音效和画面使用
+同一条时间轴生成。HyperFrames 也可以按想要的风格生成背景音乐，并放进同一条时间轴。这个仓库
+公开的版本只包含程序化音效；另行托管的发布版本如需其他音频，则在剪辑软件中完成最终混音，相关
+素材不属于本仓库。
+
 ## 环境要求
 
 - Node.js 22 或更新版本
@@ -37,6 +46,18 @@ npm run dev
 `npm run dev` 会先生成确定性纹理和 JavaScript bundle，再启动 HyperFrames 预览服务。
 这是一个常驻进程，使用 `Ctrl+C` 停止。
 
+## 让 Agent 阅读项目
+
+在仓库中启动 Agent，然后把下面这段话发给它：
+
+```text
+先阅读 AGENTS.md 和 docs/agent-reading-guide.md。只做分析，不修改文件。解释这个项目如何使用
+HyperFrames、绝对帧状态、DOM 到 Three.js 的交接和程序化音效。每个结论都标出对应的文件和符号，
+最后告诉我下一步最值得阅读的源码。不要总结与问题无关的文件。
+```
+
+[Agent 阅读指南](docs/agent-reading-guide.md)还提供了动画、声音、自定义和发布验证的短路径。
+
 常用命令：
 
 ```bash
@@ -93,11 +114,11 @@ npm run audio:encode
 ## 许可边界
 
 - composition 源码、脚本、测试和文档：MIT，见 `LICENSE`。
-- 渲染后的独立音效与音效时间线：Creative Commons Attribution 4.0，准确署名方式见
-  `assets/audio/LICENSE.md`。
+- 渲染后的独立音效与音效时间线：CC0 1.0。无需申请或署名，可以复制、修改、商用和再分发，
+  详见 `assets/audio/LICENSE.md`。
 - Manrope 与 IBM Plex Mono 字体：SIL Open Font License 1.1，见 `assets/fonts/` 下的许可文件。
 - OOMOL 与 Open Connector 自有美术经 OOMOL 批准，用于标识本仓库与 Demo；它们不属于
-  MIT 或 CC BY 4.0 的授权范围。
+  MIT 或音效的 CC0 权利放弃范围。
 - 仓库不包含第三方应用或 Agent 的 Logo 美术。画面中使用程序生成的中性几何节点；源码中
   保留的产品名称仅用于说明集成对象。
 - GSAP 使用它自己的 Standard “No Charge” License，不属于 MIT。

RELEASE_CHECKLIST.md

@@ -1,16 +1,17 @@
 # Public Release Checklist
 
-**Status: ready for public repository creation; not yet pushed.** The OOMOL release
-owner has approved the source, audio, and owned-brand boundaries below, and the final
-public-safe package has passed the reproducibility checks. Creating a remote and pushing
-the repository remain deliberate release-owner actions.
+**Status: approved public-source package.** The OOMOL release owner has approved the
+source, audio, and owned-brand boundaries below, and the final public-safe package has
+passed the reproducibility checks. GitHub is the source of truth for the current repository
+visibility, branch, CI, tag, and release state.
 
 ## Rights and attribution
 
-- [x] Audio owner approval recorded: Copyright 2026 OOMOL; rendered isolated SFX and
-  the SFX-only timeline are licensed under Creative Commons Attribution 4.0.
+- [x] Audio reuse approval recorded: rendered isolated SFX, the SFX-only timeline,
+  and rendered audio derivatives are released under CC0 1.0 without a permission or
+  attribution requirement.
 - [x] Brand approval recorded: OOMOL and Open Connector artwork may identify this
-  repository and demo, while remaining outside MIT and CC BY 4.0.
+  repository and demo, while remaining outside MIT and the CC0 audio dedication.
 - [x] Agent logo artwork replaced with deterministic public-safe placeholders.
 - [x] Third-party application logo artwork replaced with deterministic public-safe placeholders.
 - [x] License, NOTICE, third-party notices, and attribution wording reviewed and approved
@@ -22,8 +23,8 @@ the repository remain deliberate release-owner actions.
 - [x] Render `npm run render:preview` and inspect the video and both audio channels.
 - [x] Confirm no private paths, temporary exports, credentials, or unrelated files
   appear in the commit selected for release.
-- [ ] Create the public repository, push only after the rights checks above are
-  complete, then attach the curated 1080p demo to the `v1.0.0` release.
+- [x] Public repository target and first source push approved after the rights checks above.
+- [ ] After public CI passes, create the `v1.0.0` release and attach the curated 1080p demo.
 
-The absence of an npm `publish` script is intentional. Publishing is a deliberate
-release-owner action after this checklist is fully cleared.
+The absence of an npm `publish` script is intentional. Repository visibility, tags,
+and release assets remain deliberate release-owner actions.

THIRD_PARTY_NOTICES.md

@@ -29,7 +29,7 @@ files under `assets/fonts/`.
 
 OOMOL and Open Connector artwork is owned by OOMOL and is included with OOMOL's
 approval solely to identify this repository and demo. That artwork is excluded from
-the MIT source-code grant and the CC BY 4.0 audio grant.
+the MIT source-code grant and the CC0 1.0 audio dedication.
 
 No OpenAI/Codex, Anthropic/Claude, Nous Research/Hermes, or third-party application
 logo artwork is bundled. The corresponding visible nodes are original, deterministic

assets/ATTRIBUTION.md

@@ -17,8 +17,8 @@ their respective owners and do not imply endorsement.
 - Open Connector ginkgo — owned by OOMOL and included on the same limited basis.
 
 These owned-brand assets are excluded from the repository's MIT license and
-the audio's CC BY 4.0 license. Their inclusion does not grant a general trademark or
-brand-artwork license.
+the audio's CC0 1.0 dedication. Their inclusion does not grant a general trademark
+or brand-artwork license.
 
 ## Public-safe Agent and application nodes
 
@@ -50,9 +50,10 @@ under the SIL Open Font License 1.1. See the corresponding license files under
 
 ## Audio
 
-The rendered isolated SFX and SFX-only timeline are Copyright 2026 OOMOL and licensed
-under Creative Commons Attribution 4.0. See `assets/audio/LICENSE.md` for the exact
-credit line. The JavaScript synthesis source is covered by MIT.
+The rendered isolated SFX, SFX-only timeline, and rendered audio derivatives are
+released under CC0 1.0. They may be used for any purpose without permission or
+attribution. The JavaScript synthesis source is covered by MIT. See
+`assets/audio/LICENSE.md` for the exact boundary.
 
 The original branded film and its third-party logo artwork are retained outside this
 repository. They are not part of the public-source package or either public license.

assets/audio/LICENSE.md

@@ -1,16 +1,13 @@
-# Open Connector Audio License
-
-Copyright 2026 OOMOL.
+# Open Connector Audio Dedication
 
 The isolated sound effects, SFX-only timeline, and rendered audio derivatives in
-this repository are licensed under the
-[Creative Commons Attribution 4.0 International License](https://creativecommons.org/licenses/by/4.0/).
-You may share and adapt them, including commercially, provided that you give
-appropriate credit, link to the license, and indicate whether changes were made.
-
-Use this credit line:
+this repository are released under
+[CC0 1.0 Universal](https://creativecommons.org/publicdomain/zero/1.0/).
 
-> “Open Connector sound design” by OOMOL, licensed under CC BY 4.0.
+To the extent that copyright or related rights exist in these audio files, OOMOL
+waives those rights under CC0 1.0. You may copy, modify, distribute, perform, sell,
+or use the audio for any other purpose without asking permission or giving credit.
 
-The JavaScript synthesis source under `scripts/audio/` is software and is covered
-by the repository's MIT license rather than CC BY 4.0.
+This dedication applies only to the audio. It does not grant rights in OOMOL or
+Open Connector names, trademarks, or visual brand assets. The JavaScript synthesis
+source under `scripts/audio/` remains covered by the repository's MIT license.

docs/agent-reading-guide.md

@@ -0,0 +1,81 @@
+# Read This Project with an Agent
+
+You do not need to read every source file before asking useful questions. Tell the
+agent what you want to understand or change, then require it to read `AGENTS.md` and
+this guide first. The agent should stay read-only unless you ask it to modify files.
+
+## Start with one prompt
+
+Chinese:
+
+```text
+先阅读 AGENTS.md 和 docs/agent-reading-guide.md。只做分析，不修改文件。解释这个项目如何使用
+HyperFrames、绝对帧状态、DOM 到 Three.js 的交接和程序化音效。每个结论都标出对应的文件和符号，
+最后告诉我下一步最值得阅读的源码。不要总结与问题无关的文件。
+```
+
+English:
+
+```text
+Read AGENTS.md and docs/agent-reading-guide.md first. Stay read-only. Explain how this
+composition uses HyperFrames, absolute-frame state, DOM-to-Three.js handoff, and procedural
+sound. Cite the exact files and symbols I should study next. Do not summarize files that are
+unrelated to my question.
+```
+
+## Route by intent
+
+| Goal | Read first | Inspect only when needed |
+| --- | --- | --- |
+| Understand HyperFrames structure | `README.md`, `DESIGN.md`, `docs/hyperframes-patterns.md` | The root contract in `index.html`, timeline registration in `src/timeline.js` |
+| Study animation and camera motion | `docs/animation-breakdown.md` | Named timing constants and `derive*State()` functions in `src/icon-data.js`, then their consumers in `src/timeline.js` or `src/orbit-scene.js` |
+| Study sound design | `docs/sound-design.md`, `assets/audio/sfx/cues.json` | `scripts/audio/generate-sfx.mjs`, then `scripts/audio/ginkgo-assembly.mjs` |
+| Customize a scene or sound | `docs/customization.md`, `assets/ATTRIBUTION.md` | Only the requested source module, its tests, and the matching cue or texture data |
+| Verify a release | `RELEASE_CHECKLIST.md`, `package.json` | `.github/workflows/check.yml`, relevant tests, current Git status, generated assets |
+
+## Reading contract for agents
+
+1. Classify the request before opening large source files.
+2. Use `rg` to map exported constants, functions, and call sites. Do not read
+   `src/icon-data.js` or `src/orbit-scene.js` from top to bottom by default.
+3. Trace one event through data, derived state, renderer, test, and sound cue. For
+   example, frame 380 moves through `deriveCodexComposerState()`, the DOM renderer,
+   `createOrbitScene()`, runtime fixtures, and the SFX cue sheet.
+4. Cite exact files and symbols. State whether each conclusion comes from source,
+   tests, documentation, or a command run in the current session.
+5. Keep explanation separate from modification. Do not edit, render, publish, or
+   regenerate assets unless the user asks.
+6. If a change is requested, read `docs/customization.md`, follow the HyperFrames skill
+   routing in `AGENTS.md`, make the smallest relevant change, and run `npm run check`.
+
+## Focused prompts
+
+Animation:
+
+```text
+Read AGENTS.md and docs/agent-reading-guide.md. Explain the motion chain from typing through
+the frame-380 DOM-to-Three.js handoff. Cite the state derivation, renderer, and tests for each
+boundary. Stay read-only.
+```
+
+Sound:
+
+```text
+Read AGENTS.md and docs/agent-reading-guide.md. Explain how the isolated SFX and 30-second
+timeline are synthesized, seeded, aligned to picture, rebuilt, and verified. Cite the cue data
+and generator functions. Stay read-only.
+```
+
+Modification:
+
+```text
+Read AGENTS.md, docs/agent-reading-guide.md, and docs/customization.md. Before editing, tell me
+which timing constant, derived-state function, renderer, tests, and sound cue the requested
+change touches. Preserve the 30-second, 1920x1080, 30fps contract unless I explicitly change it.
+```
+
+## Expected answer shape
+
+A useful answer should give you the event chain, exact source symbols, the tests that
+protect it, and the shortest next reading path. It should not dump every constant, retell
+the README, or claim that a command passed without running it.

docs/sound-design.md

@@ -56,5 +56,6 @@ asset; the synthesis scripts are the source of truth. Use `ffprobe` to confirm a
 ## License
 
 The synthesis scripts use MIT. The rendered isolated effects and SFX-only timeline
-are Copyright 2026 OOMOL and licensed under Creative Commons Attribution 4.0.
-See `assets/audio/LICENSE.md` for the exact attribution line.
+are released under CC0 1.0. They may be copied, modified, redistributed, or used
+commercially without permission or attribution. See `assets/audio/LICENSE.md` for
+the exact boundary.