@squadbase/vantage-template 0.1.0-dev2.8dce0c9 → 0.1.1-dev1.0eaa1f0

package/base-template/agents/slide.md

@@ -11,6 +11,13 @@
 `src/monthly-report.slide.tsx` → `/monthly-report`。中身は `<SlideDeck>` を返す普通の React
 コンポーネントで、`definePage` もナビも通常のページと同じように効きます。
 
+**ファイル名の決め方:**
+
+- **ルート `/` がすでに他のページ（`index.tsx`など）で使われている場合は、スライドのタイトルから slug を作ってファイル名にする。** `index.slide.tsx` は `index.tsx` と同じ `/` に解決するので `ROUTE_CONFLICT` になる。
+  - 例: "Label check" というスライド → `src/label-check.slide.tsx` → `/label-check`
+  - 例: "Monthly Report" というスライド → `src/monthly-report.slide.tsx` → `/monthly-report`
+- 新規プロジェクトでまだ `/` が空いている場合のみ、`index.slide.tsx` を使ってよい。
+
 ```tsx
 import { Slide, SlideDeck } from "@squadbase/vantage/slide"
 
@@ -34,7 +41,12 @@ export default function Deck() {
 送れ、左のスライド一覧(サムネイル列)は `L` で開閉、`F` で全画面、ツールバーから pptx を
 書き出せます。**書き方の作法は同梱 Skill の
 `vantage-slide`** にあります(キャンバスの縦方向の予算、段階表示、トランジション、モーフ、
-pptx が壊れる条件)。
+pptx が壊れる条件、説明と図表のデータ時点の揃え方)。
+
+**分析を共有するデッキでは、本文・数値・図表を同じ対象期間と同じ取得時点の結果に揃え、その期間と
+時点を短く表示する。** 説明文を固定したまま図表だけが最新値へ変わる構成にしない(ライブ更新を
+意図するなら本文も同じ取得結果から導く)。同一時点の結果を保持できない場合は、スナップショットとして
+保存できたとは報告せず、必要な保持の仕組みと保証できない範囲を伝える。
 
 `.slide` を付けられるのはルートになるページモジュールだけで、`_layout.slide.tsx` などは
 `INVALID_PAGE_VARIANT` エラーになります。`june.slide.tsx` と `june.tsx` は同じ URL に解決するので

package/base-template/agents/xlsx.md

@@ -28,6 +28,7 @@
 - **複数シートに対応**しています。シートのタブは下端に並び、切り替えて閲覧できます。
 - 数式・グラフ・セル書式は再現されません(値として読めれば十分、という設計)。ブラウザでパースするので
   25MB を超えるファイルはそのページにエラーが出ます —— 大きいデータは `server/api/` から配って
-  `DataTable` で描いてください
+  `DataTable` で描いてください。20 万行を超えると先頭
+  20 万行だけが表示されます(残りはダウンロードして見る)
 - **ビューアの無い拡張子(`.xls`・`.ods` など)はルートになりません。** `vantage check` の
   `UNSUPPORTED_PAGE_FILE` 警告が知らせます