docs: パッケージング構想の design log を追加#16
Open
neguse wants to merge 7 commits into
Open
Conversation
配信は最後の hot reload という定義、cook を作らず冪等キャッシュで 賄う原則、ビルドシステム非依存のデフォルト経路、逃げ道としての ライブラリ化、および案の段階のもの(Lua contract 説、IDL 生成、 lubx の Lua 実装化、Haxe の処遇)を 2026-07-23 時点の到達点として記録。 Co-Authored-By: Claude Fable 5 <[email protected]> Claude-Session: https://claude.ai/code/session_013sFK4dWaEuumcJW2uBZ8NS
主張だけで帰結がなかったので、「player はゲームに依存しない → パッケージにコンパイル工程が存在しない」という導出と、要求した 場合に何が起きるかを書く。 Co-Authored-By: Claude Fable 5 <[email protected]> Claude-Session: https://claude.ai/code/session_013sFK4dWaEuumcJW2uBZ8NS
キー設計、生成器を player に同梱するかの選択(native は同梱継続 / web は外して cache を load-bearing に)、Linux から DXIL を温める 場合の要検証点と cache-not-cook の利点を書く。 Co-Authored-By: Claude Fable 5 <[email protected]> Claude-Session: https://claude.ai/code/session_013sFK4dWaEuumcJW2uBZ8NS
現状のコード上の実体(直パス .lua entry、boot.lua 探索、serve の 初回 SSE ペイロード、シェーダキャッシュ不在、手動プリキャッシュの 前例)を冒頭に置き、各方針を「現状 → 差分」として導出し直す。 「開発中に cache が温まる」等、現状の性質のように読めた構想は 設計要件であることを明示した。 Co-Authored-By: Claude Fable 5 <[email protected]> Claude-Session: https://claude.ai/code/session_013sFK4dWaEuumcJW2uBZ8NS
file:line の引用は時間が経つとずれる。挙動そのものを文章で書き切り、 コードを参照せずに読める記録にする。事実の内容は変えていない。 Co-Authored-By: Claude Fable 5 <[email protected]> Claude-Session: https://claude.ai/code/session_013sFK4dWaEuumcJW2uBZ8NS
完全なリストは動的コンテンツがある以上ゲームにしか作れないので、 温め用起動オプション(--warm 仮称)でゲームが自分の閉包をコードで 宣言する形にする。実行ベースの完全性検証(golden / headless は 数フレーム)は担保にならないことを明記。 Co-Authored-By: Claude Fable 5 <[email protected]> Claude-Session: https://claude.ai/code/session_013sFK4dWaEuumcJW2uBZ8NS
会話の消化物になっていたのを設計文書として再構成する。要求 → 決める こと・決めないことの宣言 → 用語定義 → 現状 → 設計(各決定を要求への 応答と帰結で記述)→ 未決、の構成。議論の反駁や比較の経緯は落とし、 語彙を定義してから一貫して使う。スコープ外だった言語まわりの案は language-architecture-notes.md に分離。 Co-Authored-By: Claude Fable 5 <[email protected]> Claude-Session: https://claude.ai/code/session_013sFK4dWaEuumcJW2uBZ8NS
neguse
force-pushed
the
agent/packaging-design-log
branch
from
July 23, 2026 13:20
1214cbb to
5f185b8
Compare
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
概要
roadmap の「4 本移植 + win/web 配信」駆動(#15)を受けて、配信パッケージの設計を
docs/log/に記録する。2026-07-23-packaging-design.md— パッケージング設計。要求(R1-R5)→ 決めること・決めないことの宣言 → 用語定義(パッケージ / player / snapshot / 生成キャッシュ / 事前生成 / export)→ 現状の実体(コードを確認した挙動)→ 設計 → 未決、の構成2026-07-23-language-architecture-notes.md— 同じ議論から派生した言語まわりの案(Lua contract 説、IDL 生成、lubx の Lua 実装化、Haxe の処遇)。すべて未決として分離roadmap.md / api-glue.md には手を入れていない(未決が固まってから)。
🤖 Generated with Claude Code
https://claude.ai/code/session_013sFK4dWaEuumcJW2uBZ8NS