NotebookLMで可視化するためのJSON出力テンプレ

NotebookLMやマインドマップ系AIツールは「綺麗な構造化JSON」を渡すと一気に賢くなります。Lovableに以下のテンプレで出力させましょう。

プロジェクトサマリJSON#

このアプリの構造を以下のJSONスキーマで出力してください:
{
  "name": string,
  "purpose": string,
  "routes": [{ "path": string, "role": string, "components": string[] }],
  "dataModel": [{ "entity": string, "fields": string[] }],
  "externalServices": string[],
  "openIssues": string[]
}

活用先#

• NotebookLM: ソースとして読み込ませて壁打ち
• Mermaid変換: クラス図/シーケンス図に
• 他LLM: 要件定義書のドラフト生成

実例ケーススタディ：規約・FAQ・議事録を1つのJSONで管理#

1. 『各ドキュメントを {id, title, type, content, tags, updated_at} のJSON配列に整形』と指示
2. Lovable Cloudの documents テーブルに保存しpgvectorで埋め込み
3. NotebookLMに同じJSONを投入し、社内向け『質問ボット』として併用
4. 更新時はLovable管理画面でJSONを書き換え→cron jobでNotebookLMに再アップ

つまずきポイント集#

• 症状：JSONが壊れる → 対処：『コードフェンス内のみ・前後の説明文は禁止』を明示。Zodで検証
• 症状：サイズオーバー → 対処：1ドキュメント=1JSONに分割。chunkは500〜1000字目安
• 症状：日本語の引用符が ‘ ’ になって壊れる → 対処：システムプロンプトで『ASCIIのダブルクォートのみ使用』と明示

よくある質問（検索意図別）#

[実装手順] Q. JSONを毎日自動更新する仕組みは？

Lovable Edge Functionをpg_cronまたは外部スケジューラ（QStash等）で日次実行→Storageに上書き保存→NotebookLM側でソースを再読み込み（Google Apps Script経由で半自動化可）。

[トラブル解決] Q. NotebookLMが古いJSONを参照し続ける

同名URLで上書きするとブラウザ・サービス側でキャッシュされる場合があります。ファイル名にタイムスタンプ（data-2026-05-12.json）を付けて毎回新URLにすると確実に最新版が読まれます。