vhs-demolisted

# vhs-demo CLI デモ GIF を VHS で作る。`.tape` をリポに同梱し、`nix-shell --run 'vhs path/to/demo.tape'` で再生成できる状態を保つ（vhs は home.nix 導入済み）。 ## 0. 撮る前に決める（必須��tape を書くより先） 対象モジュールの README・コードを読み、以下を確定させる。**これが決まっていない tape は「コマンドを順に打つだけの映像」になり、作る意味がない。** 1. **示したいこと1文**: この GIF から何が読み取れればよいか（例: 「YAML の `セル番地: 項目名` に従い、JSON の値が該当セルに流し込まれる」）。 2. **絵コンテ**: 場面列挙。**before/after の対比を必ず含める**（実行前の状態 → 実行 → 同じ場所の変化）。1文に寄与しない場面は削る。 3. **尺目安: 約10秒**（±2秒程度は可。厳密に切り詰めるより対比の見やすさを優先する）。Sleep 合計 + タイプ時間（文字数 × TypingSpeed）で事前に概算する。約10秒に収まるのは実質「before → 実行 → after」の3場面のみ。大きく超えるのは示したいことが2つ以上ある兆候であり、GIF を分けるか場面を捨てる。 ## 1. tape の規範 - **ナレーションはコメント行**（`Type "# ..."`）で冒頭に1行だけ（= 示したいこと1文）。場面ごとの解説は入れない（尺を食う）。 - **コマンドは短く**。`.venv/bin/python` のような長いパスは冒頭で `alias py=...` を張って画面から消す。タイプが長いコマンドは `TypingSpeed` を局所的に速める（`Set TypingSpeed 10ms` → 打鍵後に戻す）か、`Hide`〜`Show` で仕込む。 - **before/after は同じ形式で見せる**（例: 同じセルの値を実行前後で print する）。差分が視覚的に対比できることが本体。 - **モジュール境界を壊さない**: 汎用モジュールのデモが上位層（app 等）を import するコマンドを含めない。デモ用の `--exec` は `echo` 等の自己完結コマンドにする。 - デモ素材（mapping・data 等）は最小に刈り込む（3項目程度。画面で全体が一瞥できる量）。 - `Set` 値（FontSize/Width/Theme）はリポ内の既存 tape に合わせる。 ## 2. レンダリング前に素で流す（必須） VHS は 10 秒の tape でも生成に 1〜2 分かかるため、コマンドの試行錯誤を tape の再生成で回さない。tape に書くコマンド列を先に素の bash で実行し、before/after の出力・エラーの有無・絶対パス（ホームディレクトリ）の露出を確認してから tape に固める。tape 化以降の直しは Set 値・間・タイプ演出の範囲に収まっているのが正常で、コマンド自体を tape 上で直し始めたらこの工程に戻る。 ## 3. 生成する ```bash nix-shell --run 'vhs packages/<mod>/demo.tape' ``` 前提（Gotenberg・venv 等）が要る場合は tape 冒頭のコメントに明記する。 ## 4. 検証する（必須）