@squadbase/vantage 0.6.2-dev1.05a930b → 0.6.2-dev1.100dfeb

package/skills/vantage-design/references/format.md

@@ -1,172 +1,12 @@
-# DESIGN.md の書式
-
-`DESIGN.md` はプロジェクトルートに置く、**ユーザーが所有する**ファイル。アプリの見た目の意図と
-使い分けのルールを、エージェントが UI を書く前に読める形で残す。`vantage upgrade` も
-`vantage add agents` も書き換えない。
-
-## 原則
-
-- **値を書かない。トークン名だけを書く。** 色コード(`#…`・`oklch(…)`・`rgb(…)`・`hsl(…)`)や
-  px 値の色・書体の実値は `styles.css` の持ち物。`DESIGN.md` には `--primary` のようなトークン名と、
-  Tailwind のセマンティッククラス(`text-muted-foreground`)・サイズの段階(`text-2xl`)だけを書く。
-  パレット名で色味を説明するのは可(「青 → ティール → …」)。
-- **150 行以内。** 超えると `vantage check` が `DESIGN_MD_TOO_LONG` を警告する。エージェントが
-  毎回全文を読むファイルなので、網羅より判断に効くルールを優先する。
-- **YAML frontmatter は付けない。** 先頭は下の「冒頭のコメント」から始める。
-- **会話中の指示が優先。** `DESIGN.md` は既定値であって、個別の依頼を拒む根拠にしない。
-- ロゴ・画像は `public/` 配下のパスで参照する(`public/brand/logo.svg`)。画像を埋め込まない。
-
-## 節の順番と見出し
-
-見出しは日本語 + 英語の括弧書き(外部の DESIGN.md — Stitch など — の節と対応づけやすくするため)。
-この順番を崩さない。無い情報の節は消さずに「特になし」と書く。
-
-| # | 見出し | 書くこと |
-| --- | --- | --- |
-| 0 | 冒頭のコメント(`<!-- … -->`) | 何のファイルか / 値は styles.css / 会話の指示が優先 / 「このサイトに合わせて」で更新できること / upgrade が触らないこと |
-| 1 | `## 全体のトーン (Overview)` | 2〜4 行のトーン。最後に「ブランド素材:」行(任意。`public/` のパス) |
-| 2 | `## 色 (Colors)` | 役割 → トークンの表。行は **主色 / 強調 / 良い / 悪い / 注意 / 背景の段階 / 境界 / 文字**。専用トークンが無い役割は「専用トークンなし」+ 代替 |
-| 3 | `## チャート (Charts)` | 系列の順番(`--chart-1..5` とその色味)、1 系列だけ強調するときの色、良い / 悪いの色、禁止の組み合わせ、プリセット名 |
-| 4 | `## 書体 (Typography)` | 見出し / 本文 / 数字 / スライドの書体(`--slide-font-display` / `--slide-font-body`)と、サイズの段階(Tailwind クラス・`--slide-size-*`) |
-| 5 | `## レイアウトと密度 (Layout)` | カード・余白(`gap-*`)・`--radius`・並べ方・密度 |
-| 6 | `## 成果物の種類ごとの規則 (Per-artifact)` | `### ダッシュボード` と `### スライド` の小節(他の種類があれば小節を足す) |
-| 7 | `## Do / Don't` | 3 つずつ程度 |
-
-外部の DESIGN.md の対応: Overview / Colors / Typography / Layout(Spacing・Elevation 含む)/
-Components → 「成果物の種類ごとの規則」/ Do's and Don'ts。値は `styles.css` へ移す
-(→ `extract.md` の「外部の DESIGN.md」)。
-
-## 使えるトークン
-
-| 系統 | トークン |
-| --- | --- |
-| 面と文字 | `--background` `--foreground` `--card` `--card-foreground` `--popover` `--popover-foreground` |
-| 主色など | `--primary` `--primary-foreground` `--secondary` `--secondary-foreground` `--accent` `--accent-foreground` `--muted` `--muted-foreground` `--destructive` `--destructive-foreground` |
-| 境界 | `--border` `--input` `--ring` |
-| チャート | `--chart-1` 〜 `--chart-5` |
-| 形 | `--radius` |
-| サイドバー | `--sidebar` `--sidebar-foreground` `--sidebar-primary` … |
-| スライド | `--slide-bg` `--slide-fg` `--slide-accent` `--slide-muted` `--slide-radius` `--slide-font-display` `--slide-font-body` `--slide-size-hero` `--slide-size-body` |
-
-- `--muted` `--accent` `--secondary` `--border` は背景・境界用。文字色の役割に割り当てない。
-- 良い / 注意の専用トークンは無い。`--chart-*` の中から割り当てるか、「専用トークンなし」と書く。
-- ページ本文の書体はトークンではなく `body` の `font-family`(`styles.css` の `body` セレクタで上書きする。
-  `:root` / `html` に書いても `theme.css` の `body` 指定に負けて効かない)。
-- `--slide-bg` などは既定で `--background` などの別名。`.dark` に書き直す必要は無い。
-
-## 雛形(中立の既定テーマ)
-
-ベーステンプレート(`packages/vantage-template/template/DESIGN.md`)と**同じ内容**。どちらかを
-直したらもう片方も合わせること。既定テーマ(無彩色の `--primary`、チャートは `blue` プリセット)を
-そのまま説明しているので、新規に作るときはこれを写して、変えた役割の行だけを書き換える。
-
-````markdown
-<!--
-DESIGN.md — このアプリの「見た目の意図」を書くファイルです。
-
-- 実際の色・角丸・書体の値は src/styles.css にあります。ここにはトークン名(--primary など)と
-  使い分けのルールだけを書き、色コードは書きません。
-- エージェントはページ・スライド・コンポーネントを書く前にこのファイルを読みます。
-  会話の中での指示はこのファイルより優先されます。
-- 「このサイトに合わせて」「色を落ち着いた感じに」と頼めば、このファイルと styles.css を
-  まとめて更新します。
-- このファイルはあなたのものです。`vantage upgrade` が書き換えることはありません。
--->
-
-# デザイン
-
-## 全体のトーン (Overview)
-
-- 落ち着いた無彩色のベースに、データだけが色を持つ業務ダッシュボード。
-- 装飾より読みやすさを優先する。影・グラデーション・アニメーションは最小限。
-- 数字が主役。1 画面で伝えたいことを 1 つに絞り、補足は小さく添える。
-- ブランド素材: なし(ロゴを使う場合は `public/brand/logo.svg` のように `public/` 配下のパスで書く)
-
-## 色 (Colors)
-
-色は必ずトークン(Tailwind のセマンティッククラス)で指定する。素のパレット(`bg-blue-600` など)や
-色コードを直接書かない。
-
-| 役割 | トークン | 使う場所 |
-| --- | --- | --- |
-| 主色 (Primary) | `--primary` / `--primary-foreground` | 主要ボタン、選択中の状態。既定は無彩色 |
-| 強調 (Accent) | `--chart-1` | 1 つだけ目立たせたい数値・系列・リンク的な強調 |
-| 良い (Positive) | `--chart-2` | 前期比のプラスなど、良い変化の小さな印 |
-| 悪い (Negative) | `--destructive` | 前期比のマイナス、エラー、削除操作 |
-| 注意 (Warning) | 専用トークンなし | 文言とアイコンで示し、色は `--muted-foreground` |
-| 背景の段階 | `--background` → `--card` → `--muted` | ページ → カード → カード内の区画・ホバー |
-| 境界 | `--border` / `--input` / `--ring` | 罫線、入力欄、フォーカス |
-| 文字 | `--foreground` / `--muted-foreground` | 本文 / 補足・ラベル・単位 |
-
-- `--muted`・`--accent`・`--secondary`・`--border` は背景・境界用。文字色に使わない。
-- 増減(▲▼・前期比)は向きで色を分ける: 増加・プラスは `--chart-2`(または `--primary`)、
-  減少・マイナスは `--destructive`。下向きの矢印やマイナスを `--primary` で塗らない。
-- ライトとダークの両方がトークンで決まるので `dark:` を並べない。
-
-## チャート (Charts)
-
-- 系列の順番は `--chart-1` → `--chart-2` → `--chart-3` → `--chart-4` → `--chart-5`
-  (現在はプリセット `blue`: 青 → ティール → フクシア → バイオレット → グレー)。
-- 1 系列だけを目立たせるときは、その系列を `--chart-1`、残りをすべて `--chart-5`(グレー)にする。
-- 良い / 悪いを色で塗り分けるときは `--chart-2` / `--destructive`。色だけに頼らず ▲▼ や符号も添える。
-- 系列は 5 つまで。それ以上はグループ化するか「その他」にまとめる。
-- 禁止: 同じチャートで `--destructive` を普通の系列色として使う(悪い値に見える)。
-- 禁止: 隣り合う系列に `--chart-3` と `--chart-4` を並べて細い線で描く(見分けにくい)。
-- 配色を丸ごと変えるときは `npx @squadbase/vantage-template chart <preset>` を使う
-  (`blue` / `ocean` / `sunset` / `forest` / `berry` / `mono`)。
-
-## 書体 (Typography)
-
-| 用途 | 指定 | 備考 |
-| --- | --- | --- |
-| 見出し・本文 | 日本語を含むシステムフォント(`body` の `font-family`) | Web フォントは使わない |
-| 数字 | 同上 + `tabular-nums` | 桁がそろうように必ず付ける |
-| スライドの見出し | `--slide-font-display` | 既定は日本語を含むシステムフォント |
-| スライドの本文 | `--slide-font-body` | 既定は見出しと同じ |
-
-サイズの段階(ダッシュボード):
-
-- ページ見出し: `text-2xl font-bold`
-- カード見出し・ラベル: `text-sm font-medium text-muted-foreground`
-- KPI の数値: `text-3xl font-semibold tabular-nums`
-- 本文・表: `text-sm`
-- 注釈・出典: `text-xs text-muted-foreground`
-
-スライドのサイズは `--slide-size-hero`(表紙・大きな数字)と `--slide-size-body`(本文)を基準にする。
-
-## レイアウトと密度 (Layout)
-
-- 情報はカード(`bg-card` + `border-border`)で区切る。角丸は `--radius` に従う(個別に変えない)。
-- グリッドの間隔は `gap-4`。セクション間は `gap-6` 程度。
-- KPI は 1 行に 2〜4 枚。その下にチャート、最後に明細の表。
-- 密度は「中」。余白を削って詰め込むより、ページを分ける。
-
-## 成果物の種類ごとの規則 (Per-artifact)
-
-### ダッシュボード
-
-- 先頭に KPI カード、次にトレンドのチャート、最後に明細の表。
-- 各 KPI には比較対象(前月比・目標比など)を 1 つ添える。
-- チャートのタイトルは結論を書く(「売上推移」より「売上は 3 か月連続で増加」)。
-
-### スライド
-
-- 1 枚に 1 メッセージ。見出しに結論を書く。
-- 色は `--slide-bg` / `--slide-fg` / `--slide-accent` / `--slide-muted` を使う
-  (既定では `--background` / `--foreground` / `--primary` / `--muted-foreground` に連動)。
-- 強調色は 1 枚につき 1 か所まで。
-
-## Do / Don't
-
-Do:
-
-- トークンと Tailwind のセマンティッククラスで色を指定する。
-- 数値には単位と比較対象を付ける。
-- 色の意味(良い / 悪い / 強調)をアプリ全体でそろえる。
-
-Don't:
-
-- 色コードや素のパレットクラスを直接書く。
-- 1 画面で強調色を何か所にも使う。
-- 3D チャート・円グラフの多用・装飾目的のグラデーション。
-````
+# 任意の DESIGN.md
+
+`DESIGN.md` は、プロジェクトルートに置く**ユーザー所有の任意のファイル**。新規プロジェクトには作らない。
+ユーザーが望んだときだけ、ユーザー固有の意図(密度・スライドの見出し方針・ブランド素材など)を書く。
+
+- 色・書体・角丸の値と色の割り当ては書かない。テーマ(`styles.css`、ThemeDialog、CLI の `theme` / `chart`)が持つ。
+  デザイン変更の依頼を `DESIGN.md` に記録しない。
+- 見た目の規則は `AGENTS.md` の「見た目の規約」節が正本。`DESIGN.md` はそれに**加えて**従われる。
+  色の割り当てが食い違うときはテーマを優先する。
+- 既存の `DESIGN.md` は消さない。`vantage upgrade` も `vantage add agents` も書き換えない。
+- 150 行以内(超えると `vantage check` が `DESIGN_MD_TOO_LONG` を警告する)。YAML frontmatter は付けない。
+- ロゴ・画像は `public/` 配下のパスで参照する(`public/brand/logo.svg`)。

package/skills/vantage-design/references/presets.md

@@ -1,110 +1,50 @@
-# 初期デザインのプリセット
-
-プロジェクト作成時に選ぶ 4 つの出発点。**id(`default` / `calm` / `vivid` / `mono`)はプロジェクト
-作成のワークフローが参照するので変えないこと。** どれも「チャートのプリセット 1 つ + `--primary` +
-`DESIGN.md` の差分」でできている。**`--primary` はどのプリセットでも必ず書く**(無彩色のプリセットも
-値を明示する)。チャートだけ変えるとホームのような色の少ない画面では見た目が変わらず、別のプリセットから
-切り替えたときに前の `--primary` が残るため。
-
-適用の手順は共通:
-
-1. `npx @squadbase/vantage-template chart <チャートのプリセット>` で `styles.css` のマーカーブロックを
-   差し替える。**マーカーブロックの中(`--chart-1..5`)は手で編集しない** ― コマンドの生成物で、
-   次の適用で消える。
-2. 各プリセットの `--primary` / `--primary-foreground` を、`styles.css` のマーカーの**外**(先頭の
-   `:root` ブロック)に `:root` と `.dark, [data-theme="dark"]` の両方で書く。既にある `--primary` は置き換える。
-3. `DESIGN.md` を `format.md` の雛形から作り、下の「DESIGN.md の差分」の行だけを書き換える。
-4. `scripts/contrast.mjs` で `--primary-foreground` / `--primary` をライトとダークで確かめる。
-
-| id | トーン | チャートのプリセット | `--primary` |
-| --- | --- | --- | --- |
-| `default` | 無彩色のベース。色を持つのはデータ(`blue` チャート)だけ | `blue` | 無彩色(`theme.css` の既定値を明示) |
-| `calm` | 落ち着いた寒色。報告書・経営向け | `ocean` | 深い青(スカイ 700 / 300) |
-| `vivid` | 明るい暖色。営業・マーケティング向け | `sunset` | 濃いオレンジ(オレンジ 700 / 400) |
-| `mono` | モノクロ。印刷・資料への貼り付け向け | `mono` | ジンク 900 / 200 |
-
-## `default`
-
-- トーン: 落ち着いた無彩色のベースに、データだけが色を持つ業務ダッシュボード。装飾より読みやすさ。
-- チャート: `blue`(青 → ティール → フクシア → バイオレット → グレー)。
-- `--primary`(フレームワークの既定と同じ無彩色。他のプリセットから戻すときのために明示する):
-
-  ```css
-  :root {
-    --primary: oklch(0.205 0 0);
-    --primary-foreground: oklch(0.985 0 0);
-  }
-  .dark,
-  [data-theme="dark"] {
-    --primary: oklch(0.922 0 0);
-    --primary-foreground: oklch(0.205 0 0);
-  }
-  ```
-
-- `DESIGN.md`: 雛形そのまま(`format.md` の雛形は `default` を説明している)。
-
-## `calm`
-
-- トーン: 寒色でまとめた静かな画面。強調は控えめにし、数字と罫線で読ませる。
-- チャート: `ocean`(スカイ → シアン → インディゴ → ティール → スレート)。
-- `--primary`(チャートのスカイに揃えた深い青):
-
-  ```css
-  :root {
-    --primary: var(--color-sky-700);
-    --primary-foreground: oklch(0.985 0 0);
-  }
-  .dark,
-  [data-theme="dark"] {
-    --primary: var(--color-sky-300);
-    --primary-foreground: oklch(0.205 0 0);
-  }
-  ```
-
-- `DESIGN.md` の差分: 「全体のトーン」を上の文に。チャートの色味を「スカイ → シアン → インディゴ →
-  ティール → スレート」に。良い = `--chart-4`(ティール)。1 系列の強調は `--chart-1` + 残り `--chart-5`。
-  禁止: `--chart-1` と `--chart-2` を隣り合う細い線で並べる(どちらも明るい青系)。
-
-## `vivid`
-
-- トーン: 明るく勢いのある暖色。KPI とトレンドを大きく見せ、強調色をはっきり使う。
-- チャート: `sunset`(オレンジ → アンバー → ローズ → イエロー → ストーン)。
-- `--primary`(オレンジ 600 は白文字で 4.5:1 に届かないので 700 を使う):
-
-  ```css
-  :root {
-    --primary: var(--color-orange-700);
-    --primary-foreground: oklch(0.985 0 0);
-  }
-  .dark,
-  [data-theme="dark"] {
-    --primary: var(--color-orange-400);
-    --primary-foreground: oklch(0.205 0 0);
-  }
-  ```
-
-- `DESIGN.md` の差分: トーンを上の文に。主色の行を「濃いオレンジ」に。良い = 専用色なし(▲ と
-  `--foreground`)、悪い = `--destructive`。禁止: `--chart-3`(ローズ)と `--destructive` を同じ
-  チャートに置く(悪い値と区別できない)。1 系列の強調は `--chart-1` + 残り `--chart-5`。
-
-## `mono`
-
-- トーン: 白黒と灰色だけ。色で意味を運ばず、太さ・順番・ラベルで読ませる。
-- チャート: `mono`(ジンク 900 → 200。ダークでは反転)。
-- `--primary`(チャートの両端と同じジンク):
-
-  ```css
-  :root {
-    --primary: var(--color-zinc-900);
-    --primary-foreground: oklch(0.985 0 0);
-  }
-  .dark,
-  [data-theme="dark"] {
-    --primary: var(--color-zinc-200);
-    --primary-foreground: oklch(0.205 0 0);
-  }
-  ```
-
-- `DESIGN.md` の差分: トーンを上の文に。強調 = `--chart-1`(最も濃い灰)。良い = 専用色なし(▲ と
-  符号)、悪い = `--destructive`(**画面で唯一の有彩色**として使う)。チャートは系列を 3 つまでにし、
-  それ以上は直接ラベルを付ける。禁止: 隣り合う `--chart-4` と `--chart-5`(明度差が小さい)。
+# 初期デザイン(テーマ)
+
+プロジェクトの見た目の出発点は、SquadKit の 7 テーマから選ぶ。**テーマ id はプロジェクト作成の
+ワークフローが参照するので変えないこと。** テーマは主色・背景・文字・境界・チャート 5 色・角丸・書体を
+まとめて持つ(ライトとダークの両方)。
+
+| id | トーン | 向く場面 |
+| --- | --- | --- |
+| `neutral` | 既定。Vantage の素の見た目(青の主色と無彩色の面) | 迷ったとき・おまかせ |
+| `ocean` | 青を基調にした落ち着いた信頼感。角丸はやや小さめ | 報告書・経営向け |
+| `forest` | 緑を基調にした自然な印象。丸ゴシック系の書体、角丸はやや小さめ | 環境・ヘルスケア・自然 |
+| `sunset` | 橙を基調にした温かみ。角丸はやや大きめ | 営業・マーケティング |
+| `violet` | 紫を基調にしたやわらかい印象。角丸は大きめ | 華やかさ・ポップ |
+| `rose` | 赤紫からピンクの落ち着いた色。角丸は大きめ(`--destructive` の赤とは別の色) | 華やかさ・ポップ |
+| `mono` | 無彩色寄り。チャートも彩度を抑え、角丸は最小。等幅フォント | 印刷・資料への貼り付け |
+
+## 当てる
+
+プロジェクトルートで次を実行する。`--dry-run` で書き込まずに結果を見られる。
+
+```bash
+npx @squadbase/vantage-template theme <id>
+npx @squadbase/vantage-template theme ocean --reset-chart   # chart コマンドで選んだ配色を捨て、テーマのチャート色に揃える
+```
+
+- `styles.css` の ``/* squadkit-theme — regenerated by `theme`; edits here are lost */`` 〜
+  `/* squadkit-theme:end */` の範囲(テーマ範囲)だけを差し替える。**範囲の中は手で編集しない**。
+  マーカーが無いファイルには自動で足される。同じ id を再実行しても変わらない。
+- テーマ範囲はファイル先頭の `:root` より後ろに置かれ、同じ詳細度なら後ろが勝つ。
+  先頭の `:root` に手書きした `--primary` などはテーマに負ける。
+- `chart <preset>` の範囲(`--chart-*` だけ)はテーマ範囲の**後ろ**に置かれ、テーマのチャート色に勝つ。
+  チャートの配色もテーマに任せるなら `--reset-chart` で外す。
+
+## 旧プリセット id の読み替え
+
+古い呼び出しの `default` / `calm` / `vivid` / `mono` は、`theme` コマンドがそのまま受けて次の id として扱う。
+
+| 旧 | 新 |
+| --- | --- |
+| `default` | `neutral` |
+| `calm` | `ocean` |
+| `vivid` | `sunset` |
+| `mono` | `mono` |
+
+## テーマに無い値(ブランド色など)
+
+テーマの `--primary` を変えたい、特定の色だけブランドに合わせたい、というときは、テーマを当てたうえで
+**`/* squadkit-theme:end */`(チャート範囲があればその終端)より後ろ**に、変えたいトークンだけ
+`:root` と `.dark, [data-theme="dark"]` の**両方**に書く。前に書くとテーマに負ける。
+`scripts/contrast.mjs` で `--primary-foreground` / `--primary` をライトとダークで確かめる。

package/skills/vantage-pitfalls/SKILL.md

@@ -94,6 +94,11 @@ Base UI の `SelectValue` は選択中の **value をそのまま描き**、`Sel
 - 表示ルート `/sales/:customerId`
 - リンク `to="/sales/$customerId"` + `params={{ customerId }}` / 取り出し `useParams().customerId`
 
+## 日本語アプリは `lang` を指定する
+
+ルート `src/_layout.tsx` に `export const lang = "ja"`(リテラル)が無いと `<html lang="en">` のままで、
+スライドの見出しが文節の途中で折れる。内容が日本語なら必ず指定する。
+
 ## ページ:`definePage` の値はリテラルで書く
 
 title/description/navLabel は**ビルド時に静的抽出**される。変数・関数呼び出し・テンプレート補間を

package/skills/vantage-slide/SKILL.md

@@ -43,9 +43,8 @@ export default function JuneDeck() {
 
 - **1 ファイル = 1 デッキ = 1 ルート。** `export default` は `<SlideDeck>` を返す React コンポーネント
   （通常のページと同じ契約なので、`vantage check` も `vantage routes` も特別扱いをしません）。
-- **スライドは `<SlideDeck>` の直下の `<Slide>`。** 深くネストした `<Slide>` は拾われません。
-- `definePage` の `title` / `navLabel` はビルド時に静的抽出されるので**リテラルで書く**（変数・
-  テンプレート補間は不可）。ナビの表示名はこれで決まります。
+- **ファイル形式の MUST / SHOULD（`<Slide>` は `<SlideDeck>` の直下、`<Step>` は `<Steps>` の直下、
+  `definePage` はリテラル など）は `agents/slide.md` と `agents/page.md` が正本**です。ここでは繰り返しません。
 - **`.slide` を付けられるのはルートになるページモジュールだけ。** `_layout.slide.tsx` や
   `deck.slide.ts` は `INVALID_PAGE_VARIANT` エラーになります。
 - **`june.slide.tsx` と `june.tsx` は同じ URL** になるので `ROUTE_CONFLICT` です。どちらかを消すこと。
@@ -56,10 +55,24 @@ export default function JuneDeck() {
   スライド専用のコンポーネントを `components/` に切り出すと、デッキ 1 本を読むのに 2 ファイル
   追わせることになります。
 
+## まず block を探す
+
+1 枚分の中身は、手で組む前に `@squadbase/vantage/slide` の block（`SlideCover` `SlideExecSummary`
+`SlideKpiHero` `SlideKpiGrid` `SlideChartInsight` `SlideScorecardTable` `SlideNextActions` `SlideSection` `SlideComparison` `SlideChartFull`）に
+合うものがないか探します。`<Slide>` の**中**に置き、props は `vantage docs <name>`（例:
+`vantage docs slide-cover`）で引く。一覧は `agents/slide.md` が正本です。
+- props は block 間で共通: `value: number | null` + `format`（上書きだけ `display`）、`delta: { value, format? }` + `betterWhen` + `comparisonLabel`、`target: number`、`source` は文字列、`asOf` は日付だけ（「時点」は block が付ける）。
+
+- block は `@squadbase/vantage/slide` から import する。**新しい import 元は増えない**（下の
+  「import してよいもの」と矛盾しない）。`vantage add` でコピーするものでもない。
+- block が合わない**1 枚だけ**を、この下の規約で手書きする。デッキ全体を手書きに切り替えない。
+- デッキ以外のファイルは作らない。block を使っても、デッキは 1 ファイルのままで、独自の
+  ヘルパーコンポーネントは同じ `.slide.tsx` に書く。
+
 ## import してよいもの
 
 - `@squadbase/vantage/slide` — `SlideDeck` `Slide` `Steps` `Step` `MorphElement` `useSlideNumber`
-  `useIsActiveSlide` `SlideCanvas` と、その型
+  `useIsActiveSlide` `SlideCanvas`、1 枚分の block（`SlideCover` ほか上の 10 個）、手書きの 1 枚に使う部品（`SlideHeading` `SlideSourceLine` `SlideColumns` `SlideColumn` `DeltaText`）と、その型
 - `@squadbase/vantage` — `definePage`
 - `@squadbase/vantage/components` の `EChart` — **チャートを載せるときはこれ**（→「チャート」）
 - `lucide-react` のアイコン
@@ -77,21 +90,25 @@ export default function JuneDeck() {
 - 各スライドのルート要素はキャンバスを埋める（`width: "100%"; height: "100%"`）
 - インライン `style={{ … }}` を使う。読み込んだ CSS はグローバルです
 
-### タイプスケール（ここから始めて調整する）
+以下の値がスライドの規約です。ヒーローと本文は `var(--slide-size-hero)` /
+`var(--slide-size-body)` としても読めます（→ `references/tokens.md`）。
+
+### タイプスケール
 
 | 要素 | サイズ |
 | --- | --- |
-| ヒーロータイトル | 140–200px |
-| セクション見出し | 80–120px |
-| ページ見出し | 56–80px |
-| 本文 | 32–44px |
-| キャプション / ラベル | 22–28px |
+| ヒーロータイトル | 168px |
+| セクション見出し | 88px |
+| ページ見出し | 64px |
+| 本文 | 36px |
+| キャプション / ラベル | 24px |
 
-### 余白
+### 余白とグリッド
 
-- コンテンツの padding: キャンバス端から **100–160px**。文字を端に触れさせない
-- line-height: 見出し 1.2、本文 1.5–1.7
-- 要素間: 32–64px
+- セーフエリア: キャンバス端から **左右 160px・上下 120px**。中身はこの内側の **1600 × 840px** に置き、文字を端に触れさせない
+- グリッド: 内容幅 1600px を **12 列**（列幅 104px・溝 32px）に割る
+- line-height: 見出し 1.2、本文 1.6
+- 要素間: 32 / 48 / 64px のどれか
 
 ### 縦方向の予算 — 中身は 1080px に収まらなければならない
 
@@ -99,33 +116,32 @@ export default function JuneDeck() {
 計算して収まることを確かめること。**これがスライドが壊れる原因の第 1 位**で、確かめない限り
 溢れていると思ってください。
 
-**使える高さ** = `1080 − 上 padding − 下 padding`。上下 120px なら **840px**、160px なら **760px**。
-先に padding を決めて、その予算の中で設計します。
+**使える高さ** = `1080 − 上下のセーフエリア（120px × 2）` = **840px**。この予算の中で設計します。
 
 **要素の高さ** = `文字サイズ × line-height × 行数`。2 行に折り返す箇条書きは 2 行と数えます。
-次の要素を足す前に、その下の gap（32–64px）を加算してください。
+次の要素を足す前に、その下の gap（32 / 48 / 64px）を加算してください。
 
-**計算例 — 本文 1 枚、padding 120px（予算 840px）:**
+**計算例 — 本文 1 枚（予算 840px）:**
 
 | 要素 | 高さ |
 | --- | --- |
-| 見出し: 80px × 1.2 × 1 行 | 96px |
+| ページ見出し: 64px × 1.2 × 1 行 | 76.8px |
 | gap | 64px |
-| 本文: 40px × 1.6 × 3 行 | 192px |
+| 本文: 36px × 1.6 × 3 行 | 172.8px |
 | gap | 48px |
-| 箇条書き 5 行: 40px × 1.6 × 1 行 | 320px（5 × 64px） |
-| 箇条書き間の gap 4 つ: 24px | 96px |
-| **合計** | **816px ✅ 840 に収まる** |
+| 箇条書き 5 行: 36px × 1.6 × 1 行 | 288px（5 × 57.6px） |
+| 箇条書き間の gap 4 つ: 32px | 128px |
+| **合計** | **777.6px ✅ 840 に収まる** |
 
-見出しを 120px にするか箇条書きを 6 つにすると溢れます。**書く前に毎ページこの検算をすること。**
+箇条書きを 6 つにすると 867.2px で溢れます。**書く前に毎ページこの検算をすること。**
 
 **ページ単位の規則:**
 
 - 「見出し + 本文」か「見出し + 5 つ以内の短い箇条書き」のどちらか。両方は載せない
 - 箇条書きは選んだ文字サイズで 1 行に収まること。折り返すなら短くするか別ページに割る
-- ヒーロータイトル（140–200px）はタイトル + サブタイトル 1 行 + アイブロウまで。それ以外は載せない
-- セクション見出し（80–120px）のページにはほとんど何も足さない
-- 収めるために padding を上げる・スケールの下限より小さい文字にする・本文の line-height を 1.4 未満に
+- ヒーロータイトル（168px）はタイトル + サブタイトル 1 行 + アイブロウまで。それ以外は載せない
+- セクション見出し（88px）のページにはほとんど何も足さない
+- 収めるためにセーフエリアを削る・タイプスケールより小さい文字にする・本文の line-height を 1.6 未満に
   詰める、をやりたくなったら**ページを 2 枚に割る**。予算が厳しいときは分割が常に正解
 
 **`overflow: auto/scroll`・負のマージン・transform で溢れを隠さないこと。** キャンバスは固定で、
@@ -139,7 +155,7 @@ export default function JuneDeck() {
   それ以外はプレーンな const にする（→ `references/tokens.md`）
 - **書体** — ディスプレイ 1 + 本文 1。指定がなければシステムスタック。見出しは太く（800–900）、
   本文は通常（400–500）
-- **レイアウトグリッド** — padding を 1 つ決めて（例: 120px）貫く。左揃えは編集的、中央揃えは儀礼的
+- **レイアウトグリッド** — セーフエリアと 12 列グリッド（→「余白とグリッド」）を全ページで貫く。左揃えは編集的、中央揃えは儀礼的
 - **美学のコミットメント** — 1 つ選ぶ: ミニマル / マキシマル / エディトリアル / レトロ /
   ブルータリスト / ソフト・パステル / ネオン / 紙・印刷。混ぜない
 
@@ -152,12 +168,12 @@ export default function JuneDeck() {
 // ✅ 各カードが独自の JSX ノードを持つ
 const Card = ({ label, value }: { label: string; value: string }) => (
   <div style={{ flex: 1 }}>
-    <div style={{ fontSize: 28, opacity: 0.6 }}>{label}</div>
-    <div style={{ fontSize: 120, fontWeight: 800 }}>{value}</div>
+    <div style={{ fontSize: 24, opacity: 0.6 }}>{label}</div>
+    <div style={{ fontSize: 88, fontWeight: 800 }}>{value}</div>
   </div>
 )
 
-<div style={{ display: "flex", gap: 96 }}>
+<div style={{ display: "flex", gap: 64 }}>
   <Card label="売上" value="¥5.2億" />
   <Card label="解約率" value="1.4%" />
 </div>
@@ -169,6 +185,8 @@ const Card = ({ label, value }: { label: string; value: string }) => (
 
 これは**視覚要素が繰り返すとき**の話で、データが繰り返すときの話ではありません。純粋な
 テキストの箇条書き（`<ul><li>`）は各 `<li>` が既に独立した JSX ノードなので、そのままで正しい。
+`<SlideDeck>` の直下に `<Slide>` を配列で渡すこと自体はファイル形式として可能です（`agents/slide.md`）が、
+1 枚ごとの文言・図を変えるスライドは 1 枚ずつ書きます。
 
 ## ページ番号
 
@@ -250,8 +268,8 @@ pptx 書き出しのために描き終わりを待たせる必要があります
 - [ ] `export default` が `<SlideDeck>` を返している
 - [ ] `<Slide>` が `<SlideDeck>` の直下にある
 - [ ] 各スライドのルート要素が `100% × 100%` を埋めている
-- [ ] 文字が padding の内側にある（端に触れていない）
-- [ ] **全ページで（文字サイズ × line-height × 行数）+ gap + padding×2 ≤ 1080px。** 際どいなら分割
+- [ ] 文字がセーフエリア（左右 160px・上下 120px）の内側にある
+- [ ] **全ページで（文字サイズ × line-height × 行数）+ gap ≤ 840px。** 際どいなら分割
 - [ ] 箇条書きが 2 行目に折り返していない
 - [ ] 配色とタイプスケールが全ページで一貫している
 - [ ] 1 ページ 1 メッセージ
@@ -267,11 +285,11 @@ pptx 書き出しのために描き終わりを待たせる必要があります
 ## アンチパターン
 
 - ❌ 文字の壁。1 ページ 40 語を超えたら分割する
-- ❌ キャンバス全面を本文で使う。padding 100–160px を守る
+- ❌ キャンバス全面を本文で使う。セーフエリア（左右 160px・上下 120px）を守る
 - ❌ 縦に 1080px を溢れさせる。切れた中身は見えない — 分割する
 - ❌ `overflow: auto` / `scroll` / `hidden` で溢れを「隠す」。バグを隠しただけ
-- ❌ 詰め込むためにスケールの下限より小さい文字にする・padding を 100px 未満にする
-- ❌ 本文 28px 未満。プロジェクタで読めない
+- ❌ 詰め込むためにタイプスケールより小さい文字にする・セーフエリアを削る
+- ❌ 本文を 36px 未満にする。プロジェクタで読めない
 - ❌ `@squadbase/vantage/ui` のプリミティブをスライドに置く（縮小されて読めなくなる）
 - ❌ 依存を追加する。使えるのは `@squadbase/vantage/*` と `lucide-react` と標準 Web API だけ
 - ❌ スライド用のコンポーネントを別ファイルに切り出す