@agent-native/core 0.76.5 → 0.76.6

package/docs/content/locales/ja-JP/template-content.md

@@ -0,0 +1,402 @@
+---
+title: "コンテンツ"
+description: "オープンソースの Obsidian for MDX: ローカルの Markdown/MDX ファイルを編集し、リッチなインタラクティブなカスタム ブロックを生成し、AI エージェントを使用して書き込みます。"
+---
+
+# コンテンツ
+
+コンテンツはオープンソースの Obsidian for MDX: ローカル ファイルに優しいドキュメントです
+エージェントがページの読み取り、書き込み、再編成、公開を行うことができるワークスペース
+あなた。ドキュメントを開き、「この段落をもっと簡潔に書き直す」または「
+「第 4 四半期計画」というページと、目標、指標、リスクのサブページ」 - 同じ
+自分で行うか、依頼するかで結果が決まります。
+
+```an-wireframe
+{
+  "surface": "desktop",
+  "html": "<div style='display:grid;grid-template-columns:210px 1fr;gap:14px;padding:16px;min-height:500px;box-sizing:border-box'><aside class='wf-card' style='display:flex;flex-direction:column;gap:10px'><strong>Content</strong><span class='wf-pill accent'>Q3 Roadmap</span><span class='wf-pill'>Goals</span><span class='wf-pill'>Metrics</span><span class='wf-pill'>Risks</span><hr/><span class='wf-pill'>Engineering wiki</span><span class='wf-pill'>Reading list</span><span class='wf-pill'>Weekly sync</span></aside><main style='display:flex;flex-direction:column;gap:12px;min-width:0;padding:8px 20px'><div style='display:flex;align-items:center;gap:10px'><h1 style='margin:0'>Q3 Roadmap</h1><div style='flex:1'></div><button>Share</button><button class='primary'>Publish</button></div><div class='wf-card' style='flex:1;display:flex;flex-direction:column;gap:12px;padding:22px'><h2 style='margin:0'>Launch goals</h2><p style='margin:0'>Ship the onboarding flow, reduce setup time, and document owner handoffs.</p><div class='wf-box'>At a glance · owner, window, status</div><div class='wf-box'>Top objectives</div><div class='wf-box'>Workstreams table</div></div></main></div>"
+}
+```
+
+アプリを開くと、エディターの横にページ ツリーが表示されます。エージェントは、ユーザーが表示しているページと選択したテキストを常に把握しているため、ドキュメントの編集は現在のページに基づいて行うことができます。
+
+```an-diagram title="One document, many editors" summary="You and the agent both write through the same Yjs pipeline. SQL is the canonical store; local files and Notion are optional sync surfaces."
+{
+  "html": "<div class=\"diagram-flow\"><div class=\"diagram-col\"><div class=\"diagram-node\">You type<br><small class=\"diagram-muted\">slash menu, toolbar</small></div><div class=\"diagram-node\">Agent edits<br><small class=\"diagram-muted\">edit-document find/replace</small></div></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-panel center\"><span class=\"diagram-pill accent\">Yjs CRDT</span><small class=\"diagram-muted\">live, conflict-free merge</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-box\">documents (markdown)<br><small class=\"diagram-muted\">canonical SQL store</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&harr;</div><div class=\"diagram-col\"><div class=\"diagram-box\">Local .md / .mdx<br><small class=\"diagram-muted\">/local-files</small></div><div class=\"diagram-box\">Notion pages<br><small class=\"diagram-muted\">pull · push</small></div></div></div>",
+  "css": ".diagram-flow{display:flex;align-items:center;gap:12px;flex-wrap:wrap}.diagram-flow .diagram-col{display:flex;flex-direction:column;gap:10px}.diagram-flow .diagram-arrow{font-size:22px;line-height:1}.diagram-flow .center{display:flex;flex-direction:column;align-items:center;gap:4px}"
+}
+```
+
+## それを使って何ができるか
+
+- **見出し、リスト、表、コード ブロック、画像、リンクを含むリッチ テキストを作成します**。スラッシュ コマンド (`/`) はブロックを挿入します。テキストを選択すると、書式設定ツールバーがポップアップ表示されます。
+- **ページをツリーに整理** — 無限にネストしたり、ドラッグして並べ替えたり、よく使うお気に入りのページを作成したりできます。
+- **タイトルやコンテンツ全体の全文検索を使用して、すべてを検索**します。
+- **Obsidian などのローカル Markdown/MDX ファイルを編集します。** `/local-files` ビューを使用します
+  ワークスペースをファイルにエクスポートし、独自のツールで編集し、プレビューするには
+  変更を加えてインポートし直します。ローカル ファイル モードでは、コンテンツは
+  選択した `.md` または `.mdx` ファイル。
+- **リッチでインタラクティブなカスタム ブロックを生成します。** ローカル React コンポーネントを登録します。
+  それらを MDX として挿入し、エージェントにコンポーネント ファイルを作成または更新させます
+  あなたのドキュメント。
+- **Notion と同期します。** ローカル ドキュメントを Notion ページにリンクし、コンテンツをいずれかの方向にプルまたはプッシュします。コメントは双方向でも同期されます。
+- **リアルタイムで共同作業します。** 複数の人 (およびエージェント) が同じドキュメントを同時に編集できます。
+- **ドキュメントをチームメイトと共有**するか、公開します。デフォルトでは、閲覧者/編集者/管理者の役割で非公開となります。
+- **エージェントに何でも質問してください**: 「この段落を書き直してください。」 「先頭に TL;DR を追加します。」 「先週の会議メモをすべて見つけてください。」 「この口調をもっとフォーマルにしてください。」
+
+## はじめに
+
+ライブデモ: [content.agent-native.com](https://content.agent-native.com)。
+
+アプリを開いたら、サイドバーの [**+新しいページ**] をクリックし、タイトルを付けて、書き込みを開始します。エージェントを使用するには、サイドバーに次のように入力します。
+
+- 「オンボーディングというページを作成し、その下に 3 つのサブページを追加します。」
+- 「この段落をもっと簡潔に書き直してください。」 (ページを開いた状態で)
+- 「価格に関するセクションを 3 つの箇条書きで追加します。」
+- 「このドキュメントを先頭の TL;DR に要約してください。」
+- 「Notion から最新のものをプルします。」 (Notion ページのリンク後)
+
+テキストを選択して Cmd+I を押すと、その選択内容が事前に読み込まれた状態でエージェントに焦点が当てられます。「これをよりパンチのあるものにする」は、強調表示した内容に正確に適用されます。
+
+## ローカル Markdown/MDX ファイル {#local-files}
+
+コンテンツは、クローン作成や実行を行わずに、ローカル ファイルを介してドキュメントを往復できます
+ローカルのコンテンツ アプリ。 MDX の Obsidian のような感じです: ファイルは常に検査可能です
+編集可能で、アプリにはリッチエディター、エージェント actions、共有機能が備わっています。
+カスタムブロック。 `/local-files` を開き、ブラウザまたはエージェントでフォルダーを選択します
+ネイティブ デスクトップ、現在のドキュメント ツリーを Markdown/MDX としてエクスポートします
+`content/`.
+
+エクスポートされた各ファイルには、ドキュメント メタデータのフロントマター (`id`、`title`、
+`parentId`、`position`、お気に入り/検索/可視フラグ、および `updatedAt`) プラス
+ドキュメント本文は Markdown です。これらのファイルは通常のエディタで編集できます。
+その後、`/local-files` に戻ってプレビューし、変更をコンテンツにインポートし直します。
+
+このワークフローは、ソース管理にコンテンツが必要な場合や、バッチ処理を行う場合に役立ちます
+ローカル ツールを使用してドキュメントを編集するか、ファイルを好むチーム向けにクローンを使用しないパスが必要
+レビュー面として。ホストされているアプリは、共有のための真実の情報源であり続けます。
+コメント、権限、ライブコラボレーション。ローカル フォルダーは明示的です
+サーフェスを同期します。
+
+コンテンツは、ファイルがソースとなる **ローカル ファイル モード** でも実行できます。
+SQL 文書の代わりに真実。 `agent-native.json` をリポジトリに追加し、
+`mode: "local-files"`、`docs/`、`blog/` などのルートを構成します
+`content/`、および `resources/`。標準のコンテンツ エディタは、
+ローカルの `.md`/`.mdx` ファイルから左側のサイドバーを選択し、編集内容をファイルに書き込みます。
+通常のドキュメント actions を通じて選択されたファイル。これをリポジトリファーストのドキュメントに使用します。
+ブログ、リソース ライブラリ、または MDX を利用した Obsidian スタイルの個人コンテンツ
+コンポーネント;ホスト型コラボレーションが必要な場合は、データベース モードに戻してください。
+SQL-backed sharing. See [Local File Mode](/docs/local-file-mode) for the
+スタンドアロン リポジトリのレイアウト、構成、カスタム MDX コンポーネント、ローカル
+`extensions/` ウィジェット、および本番環境の安全ガイド。
+
+コンテンツ ローカル ファイル スキルを既存のリポジトリにインストールするには:
+
+```bash
+npx @agent-native/core@latest skills add content --mode local-files --scope project
+```
+
+インストーラーはコーディング エージェントの `content` スキルをコピーし、または
+`docs/`、`blog/`、`content/` のコンテンツ ルートで `agent-native.json` を更新します
+と `resources/`。ローカル コンテンツ アプリ、Agent Native デスクトップ、または信頼できる場合
+ローカル ブリッジが実行中です。エージェントはコンテンツ actions を使用する必要があります。
+`list-documents`、`get-document`、`edit-document`、`update-document`、
+生のファイルシステム書き込みの代わりに `share-local-file-document`。そのローカルがなければ
+ブリッジ、インストールされたスキルは引き続きエージェントにリポジトリ編集契約を与えます
+安全な Markdown/MDX 編集。
+
+## 開発者向け
+
+このドキュメントの残りの部分は、コンテンツ テンプレートをフォークまたは拡張する人を対象としています。
+
+### クイックスタート
+
+コンテンツ テンプレートを使用して新しいワークスペースを足場にします:
+
+```bash
+npx @agent-native/core@latest create my-workspace --standalone --template content
+cd my-workspace
+pnpm install
+pnpm dev
+```
+
+`http://localhost:8083` を開いて最初のページを作成します。次に、エージェントに「オンボーディングというページを作成し、その下に 3 つのサブページを追加する」ように依頼します。
+
+### 主な機能 {#key-features}
+
+**ネストされたページ。** ドキュメントは、お気に入り、アイコン、順序付け、ページレベルの共有を備えたドラッグ可能なツリーを形成します。
+
+**リッチな MDX エディタ。** Tiptap は、見出し、リスト、テーブル、コード ブロック、画像、リンク、スラッシュ コマンド、選択ツールバー、ローカル React コンポーネントを強化します。
+
+**ライブ コラボレーション。** Yjs は、複数の編集者とエージェントの編集を互いに干渉することなく同期させます。
+
+**検索とコメント。** 全文検索、アンカー付きコメント、バージョン履歴、復元フローがドキュメント画面に組み込まれています。
+
+**サーフェスの同期。** ドキュメントは、SQL が共同キャッシュ/履歴レイヤーとして機能し、Notion またはローカルの Markdown/MDX フォルダーと同期できます。
+
+### ローカル ファイルの同期
+
+保護された `/local-files` ルートは、ブラウザ ファイル システム アクセス API または を使用します
+読み取りと書き込みのための、Agent Native デスクトップ内の保護されたネイティブ フォルダー ブリッジ
+ユーザーが選択したフォルダーからの Markdown/MDX ファイル。フォルダーがリンクされた後、
+インポートすると、選択したファイルが権限として扱われます: ページを開くと読み取ります
+ファイルを保存し、通常のエディタでは最初にファイルを保存します。その後、SQL は
+既存のドキュメント UI のキャッシュ/履歴レイヤー、検索、およびバージョン パネルではありません
+真実の情報源として。右上のページ メニューには、ローカル ソース パスが表示されます。
+相対パスは常に使用でき、絶対パスは実際のローカル ファイルで使用できます
+モードと Agent Native デスクトップ、および Finder で表示は、
+デスクトップ ブリッジまたはサーバー支援のローカル ファイル モード。
+
+バルク同期ルートの呼び出し:
+
+- `export-content-source` — アクセス可能なドキュメント ツリーを読み取り、
+  確定的な `content/` ファイル バンドル。
+- `import-content-source` — ファイルを検証し、新しいプライベート ドキュメントを作成します。
+  呼び出し元が編集者アクセス権を持っているドキュメントを更新し、バージョンを保持します
+  履歴を確認し、無効な親サイクルを拒否します。
+
+ソース形式は `shared/content-source.ts` にあります。そのファイルを
+ファイル名、フロントマター、解析、シリアル化に関する単一のコントラクト。
+
+ローカル ファイル ワークスペースは、
+`components` フォルダーを構成しました。コンテンツ開発サーバーは PascalCase をインポートします
+これらのファイルからエクスポートし、`<ImpactCounter />` などの MDX タグに一致するものをレンダリングします
+エディタ内でローカル コンポーネントの下のスラッシュ メニューに表示されます。
+これは「MDX の黒曜石」レイヤーです: カスタム MDX ブロックはローカルに残ります
+ワークスペースですが、エディターはワークスペースをレンダリングでき、エージェントは生成または更新できます
+コンテンツ アプリのクローンを作成せずにソースを作成します。最小限のワークスペース コンポーネントでは、
+であること:
+
+```tsx
+// components/ImpactCounter.tsx
+import { useState } from "react";
+
+export function ImpactCounter({
+  label = "points",
+  start = 3,
+}: {
+  label?: string;
+  start?: number;
+}) {
+  const [count, setCount] = useState(start);
+  return (
+    <button type="button" onClick={() => setCount(count + 1)}>
+      Impact: {count} {label}
+    </button>
+  );
+}
+
+export const ImpactCounterInputs = {
+  label: { type: "string", label: "Label", default: "points" },
+  start: { type: "number", label: "Starting count", default: 3 },
+};
+```
+
+ローカルの MDX で `<ImpactCounter />` として使用するか、エディターのスラッシュから挿入します
+] メニュー。入力メタデータがエクスポートされるときに、
+エディターのコンポーネントには、MDX プロパティを書き換えるコーナー編集ボタンが表示されます
+ローカル ファイル内。
+
+ブラウザの **ローカル ファイル** ピッカーは、`.md` および `.mdx` ファイルを読み書きできます
+独自の実行可能な React コンポーネント プレビューにはローカル コンパイラが必要です。走る
+コンテンツをローカルに保存するか、Agent Native デスクトップを使用して、選択したワークスペース パスを使用できるようにします。
+ローカルのコンテンツ開発サーバーに登録されます。 Vite はインポートします
+`components/*.tsx`、既存のコンポーネント ファイルへの編集をホット リロードし、リロードします
+ファイルが追加または削除されるときのコンポーネント レジストリ。エージェントが使用できる
+`list-local-component-files` および `write-local-component-file` を検査するか
+エディタが同じソースから更新している間に、登録されたコンポーネント ファイルを更新します。
+
+### コメント
+
+引用文アンカー、返信、および状態解決を含むドキュメントに対するスレッド化されたコメント。 `document_comments` テーブルと `app/components/editor/CommentsSidebar.tsx` によってサポートされます。 Actions: `list-comments`、`add-comment`。 Notion コメントは、`sync-notion-comments` 経由で双方向に同期できます。
+
+### バージョン履歴
+
+重要な更新ごとに、`document_versions` テーブルの行のスナップショットが作成されます。 UI は、`app/components/editor/VersionHistoryPanel.tsx` でこれらを表面化します。
+
+### 共有と可視性
+
+ドキュメントはデフォルトでは非公開です。可視性を `org` または `public` に変更したり、ユーザーごとおよび組織ごとのロール (`viewer`、`editor`、`admin`) を付与したりできます。フレームワークの自動マウント共有 actions は、そのまま使用できます:
+
+- `share-resource --resourceType document --resourceId <id> --principalType user --principalId <email> --role editor`
+- `unshare-resource` / `list-resource-shares` / `set-resource-visibility`
+
+`sharing` スキルをご覧ください。
+
+### チーム
+
+`/team` の専用チーム ページ (`app/routes/_app.team.tsx` を参照) は、組織の作成とメンバーの管理にフレームワークの `TeamPage` コンポーネントを使用します。
+
+### エージェントとの連携
+
+エージェントには現在の画面が表示されるため、ほとんどのプロンプトではドキュメントを明示的に参照する必要はありません。ページを開いているとき、「これ」はそのページを意味します。
+
+小規模な編集の場合、エージェントは `edit-document --find ... --replace ...` を使用するため、変更されたテキストのみが Yjs を通過します。ページ全体が再レンダリングされるのではなく、その場で差分が適用されるのがわかります。より大きな書き換えの場合は、`update-document --content ...` を使用します。
+
+テキストを選択して Cmd+I を押すと (またはエージェント パネルにフォーカスすると)、選択内容が次のメッセージとともにコンテキストとして移動するため、強調表示した内容に基づいて「よりパンチのあるものにする」が機能します。
+
+### データベースとプロパティ
+
+ドキュメントはインライン データベース (各行自体がドキュメントである Notion スタイルのテーブル) をホストできます。エージェントは、actions: `create-content-database`、`add-database-item`、`set-document-property` を介してデータベースの作成、項目の追加、列定義の構成、プロパティ値の設定を行うことができます。プロパティ定義 (タイプ、可視性、オプション、位置) は `document_property_definitions` にあります。行ごとの値は `document_property_values` にあります。
+
+### 追加のactions
+
+データ モデルの CRUD サーフェスを超えて、テンプレートには、ページを Markdown または HTML に変換するための `export-document`、トランスクリプトをページに添付するための `transcribe-media`、および以前のスナップショットにロールバックするための `restore-document-version` が同梱されています。
+
+### データモデル
+
+9 つのテーブル、すべて `server/db/schema.ts` で定義:
+
+- **`documents`** — ページ ツリー。列: `id`、`parent_id`、`title`、`content` (マークダウン)、`icon`、`position`、`is_favorite`、`visibility`、`owner_email`、`org_id`、`created_at`、 `updated_at`.
+- **`document_versions`** — バージョン履歴のタイトルとコンテンツの完全なスナップショット。 `restore-document-version` でロールバックします。
+- **`document_comments`** — `thread_id`、`parent_id`、`quoted_text`、`resolved`、および双方向 Notion 同期用のオプションの `notion_comment_id` を含むスレッド化されたコメント。
+- **`document_sync_links`** — リモート ページ ID、最終同期時刻、競合状態、コンテンツ ハッシュ、およびエラーを追跡する、Notion にリンクされたドキュメントごとに 1 行。
+- **`document_property_definitions`** — インライン データベースの列定義: 名前、タイプ、可視性、オプション、位置。
+- **`content_databases`** — タイトルとビュー構成 JSON を持つ `document_id` にアタッチされたインライン データベース オブジェクト。
+- **`content_database_items`** — インライン データベース内の行。それぞれが `database_id` を `document_id` にリンクします。
+- **`document_property_values`** — ドキュメントごとのプロパティ値 (`property_id` → `value_json`)。
+- **`document_shares`** — `createSharesTable` 経由で作成されたユーザーごとおよび組織ごとの許可。
+
+```an-schema title="Content data model" summary="Nine tables in server/db/schema.ts. documents is the page tree; the rest hang off it for versions, comments, Notion sync, inline databases, and sharing."
+{
+  "entities": [
+    {
+      "id": "documents",
+      "name": "documents",
+      "note": "The page tree (ownable, markdown body)",
+      "fields": [
+        { "name": "id", "type": "id", "pk": true },
+        { "name": "parent_id", "type": "id", "fk": "documents.id", "nullable": true, "note": "infinite nesting" },
+        { "name": "title", "type": "string" },
+        { "name": "content", "type": "markdown" },
+        { "name": "icon", "type": "string", "nullable": true },
+        { "name": "position", "type": "int", "note": "sibling ordering" },
+        { "name": "is_favorite", "type": "bool" },
+        { "name": "visibility", "type": "enum", "note": "private | org | public" },
+        { "name": "owner_email", "type": "string" },
+        { "name": "org_id", "type": "id", "nullable": true }
+      ]
+    },
+    {
+      "id": "document_versions",
+      "name": "document_versions",
+      "note": "Full title/content snapshots for version history",
+      "fields": [
+        { "name": "id", "type": "id", "pk": true },
+        { "name": "document_id", "type": "id", "fk": "documents.id" },
+        { "name": "title", "type": "string" },
+        { "name": "content", "type": "markdown" }
+      ]
+    },
+    {
+      "id": "document_comments",
+      "name": "document_comments",
+      "note": "Threaded comments with quoted-text anchors",
+      "fields": [
+        { "name": "id", "type": "id", "pk": true },
+        { "name": "document_id", "type": "id", "fk": "documents.id" },
+        { "name": "thread_id", "type": "id" },
+        { "name": "parent_id", "type": "id", "fk": "document_comments.id", "nullable": true },
+        { "name": "quoted_text", "type": "string", "nullable": true },
+        { "name": "resolved", "type": "bool" },
+        { "name": "notion_comment_id", "type": "string", "nullable": true, "note": "bidirectional Notion sync" }
+      ]
+    },
+    {
+      "id": "document_sync_links",
+      "name": "document_sync_links",
+      "note": "One row per Notion-linked document",
+      "fields": [
+        { "name": "id", "type": "id", "pk": true },
+        { "name": "document_id", "type": "id", "fk": "documents.id" },
+        { "name": "notion_page_id", "type": "string" },
+        { "name": "conflict", "type": "bool" },
+        { "name": "content_hash", "type": "string" }
+      ]
+    },
+    {
+      "id": "content_databases",
+      "name": "content_databases",
+      "note": "Inline database objects attached to a document",
+      "fields": [
+        { "name": "id", "type": "id", "pk": true },
+        { "name": "document_id", "type": "id", "fk": "documents.id" },
+        { "name": "title", "type": "string" },
+        { "name": "view_config", "type": "json" }
+      ]
+    },
+    {
+      "id": "content_database_items",
+      "name": "content_database_items",
+      "note": "Rows in an inline database (each row is a document)",
+      "fields": [
+        { "name": "id", "type": "id", "pk": true },
+        { "name": "database_id", "type": "id", "fk": "content_databases.id" },
+        { "name": "document_id", "type": "id", "fk": "documents.id" }
+      ]
+    },
+    {
+      "id": "document_property_definitions",
+      "name": "document_property_definitions",
+      "note": "Column definitions for inline databases",
+      "fields": [
+        { "name": "id", "type": "id", "pk": true },
+        { "name": "name", "type": "string" },
+        { "name": "type", "type": "string" },
+        { "name": "options", "type": "json", "nullable": true },
+        { "name": "position", "type": "int" }
+      ]
+    },
+    {
+      "id": "document_property_values",
+      "name": "document_property_values",
+      "note": "Per-document property values",
+      "fields": [
+        { "name": "id", "type": "id", "pk": true },
+        { "name": "document_id", "type": "id", "fk": "documents.id" },
+        { "name": "property_id", "type": "id", "fk": "document_property_definitions.id" },
+        { "name": "value_json", "type": "json" }
+      ]
+    },
+    {
+      "id": "document_shares",
+      "name": "document_shares",
+      "note": "Per-user and per-org grants (createSharesTable)",
+      "fields": [
+        { "name": "id", "type": "id", "pk": true },
+        { "name": "document_id", "type": "id", "fk": "documents.id" },
+        { "name": "principal", "type": "string" },
+        { "name": "role", "type": "enum", "note": "viewer | editor | admin" }
+      ]
+    }
+  ],
+  "relations": [
+    { "from": "documents", "to": "documents", "kind": "1-n", "label": "has children" },
+    { "from": "documents", "to": "document_versions", "kind": "1-n", "label": "has snapshots" },
+    { "from": "documents", "to": "document_comments", "kind": "1-n", "label": "has comments" },
+    { "from": "documents", "to": "document_sync_links", "kind": "1-1", "label": "links to Notion" },
+    { "from": "documents", "to": "content_databases", "kind": "1-n", "label": "hosts databases" },
+    { "from": "content_databases", "to": "content_database_items", "kind": "1-n", "label": "has rows" },
+    { "from": "document_property_definitions", "to": "document_property_values", "kind": "1-n", "label": "has values" },
+    { "from": "documents", "to": "document_shares", "kind": "1-n", "label": "has share grants" }
+  ]
+}
+```
+
+コンテンツはマークダウンとして保存されます。エディターはメモリ内の Tiptap JSON モデルとの間で変換を行います。 SQL 行は常にマークダウンであるため、actions、検索、および Notion 同期は単一の正規形式で動作できます。
+
+すべての所有可能なテーブルには、`ownableColumns()` を介した `owner_email` および `org_id` が含まれるため、すべての行は、作成された瞬間からサインインしているユーザー (およびオプションでアクティブな組織) にスコープされます。
+
+### カスタマイズ
+
+動作を変更するときに確認する 4 つの場所:
+
+- **`actions/`** — エージェントまたは UI が実行できるすべての操作。 `defineAction` を使用して `actions/publish-to-wordpress.ts` のような新しいファイルを追加すると、双方が無料でそれを取得できます。主要な既存のactions: `create-document.ts`、`edit-document.ts`、`update-document.ts`、`delete-document.ts`、`list-documents.ts`、`search-documents.ts`、`get-document.ts`、`pull-notion-page.ts`、`push-notion-page.ts`、`add-comment.ts`、`view-screen.ts`、 `navigate.ts`.
+- **`app/routes/`** — ページの表面。 `_app.tsx` は、サイドバーとエージェント パネルをマウントしたままにするパスレス レイアウトです。 `_app._index.tsx` は着陸ビューです。 `_app.page.$id.tsx` は編集者ルートです。 `_app.team.tsx` はチーム設定ページです。
+- **`app/components/editor/`** — Tiptap エディター。新しいノード タイプを `extensions/` の下に追加し、それを `DocumentEditor.tsx` に登録します。バブル ツールバー、スラッシュ メニュー、ホバー プレビューはすべて編集できるコンポーネント ファイルです。
+- **`.agents/skills/`** — エージェントが行動する前に読むガイダンス。新しい機能 (CMS パブリッシュ パイプラインなど) を追加する場合は、エージェントが正しく使用できるように、新しいスキル フォルダーに `SKILL.md` をドロップします。既存の skills: `document-editing`、`notion-integration`、`real-time-sync`、`delegate-to-agent`、`storing-data`、`self-modifying-code`、`security`、`frontend-design`、`create-skill`、`capture-learnings`。
+- **`AGENTS.md`** — アクション チートシートと共通タスクの表を含むトップレベルのエージェント ガイド。主要な機能を追加するたびに更新して、エージェントが探索せずにその機能を検出できるようにします。
+- **`server/db/schema.ts`** — データ モデル。ここに列またはテーブルを追加します。コンテンツ テンプレートには `db:push` スクリプトがありません。これは、起動時に実行される厳密に追加的な移行に依存しています。 `server/db/schema.ts` を編集し、一致する追加移行を作成すると、次回アプリが起動するときに変更が適用されます。スキーマの更新では、既存のテーブルや列を削除したり、名前を変更したり、破壊的に変更したりしてはなりません (ガイドラインについては、[Database](/docs/database#migrations) を参照してください)。
+- **`shared/notion-markdown.ts`** — マークダウンから Notion ブロックへの変換。 Notion を往復する必要がある新しいブロック タイプを追加する場合は、これを拡張します。
+
+エージェントはこれらすべての変更を自分で行うことができます。エージェントに「ドキュメントにタグ列を追加してサイドバーに公開する」ように依頼すると、スキーマの更新、移行、UI の接続、およびアクションの作成が行われます。

package/docs/content/locales/ja-JP/template-design.md

@@ -0,0 +1,173 @@
+---
+title: "デザイン"
+description: "エージェントネイティブの HTML プロトタイピング スタジオ — エージェントを使用して、インタラクティブな Alpine/Tailwind デザインを生成、調整、プレビュー、エクスポートします。"
+---
+
+# デザイン
+
+Design は、エージェントネイティブの HTML プロトタイピング スタジオです。レイヤー化された描画キャンバスの代わりに、エージェントは完全な自己完結型の Alpine/Tailwind HTML プロトタイプを生成し、iframe でレンダリングして、プロンプトやコントロールの微調整を使用して結果を調整できるようにします。
+
+```an-wireframe
+{
+  "surface": "desktop",
+  "html": "<div style='display:flex;flex-direction:column;gap:14px;padding:18px;min-height:520px;box-sizing:border-box'><div style='display:flex;align-items:center;gap:10px'><h1 style='margin:0'>Product launch page</h1><span class='wf-pill accent'>Desktop</span><span class='wf-pill'>Tablet</span><span class='wf-pill'>Mobile</span><div style='flex:1'></div><button>Preview</button><button class='primary'>Export code</button></div><div class='wf-card' style='flex:1;display:grid;grid-template-rows:auto 1fr auto;gap:12px'><div style='display:flex;gap:8px'><span class='wf-pill accent'>Hero</span><span class='wf-pill'>Pricing</span><span class='wf-pill'>FAQ</span></div><div class='wf-box' style='display:flex;align-items:center;justify-content:center;min-height:230px'><strong>Generated HTML prototype</strong></div><div class='wf-card' style='display:flex;align-items:center;gap:10px'><span class='wf-muted'>Make the hero denser and the CTA clearer.</span><div style='flex:1'></div><button class='primary'>Apply revision</button></div></div></div>"
+}
+```
+
+アプリを開くと、生成されたプロトタイプがワークスペースの中心となり、プレビュー モード、プロンプト リビジョン、およびエクスポート コントロールがすぐ近くにあります。エージェントが生成するものはすべて本物の HTML であり、調整したり、エクスポートしたり、引き渡したりすることができます。
+
+```an-diagram title="One artifact, no translation" summary="The agent generates standalone Alpine/Tailwind HTML; the iframe, the editable source, and every export all read the same files. A linked design system feeds tokens into each pass."
+{
+  "html": "<div class=\"diagram-design\"><div class=\"diagram-col\"><div class=\"diagram-node\">Prompt<br><small class=\"diagram-muted\">describe screen / page</small></div><div class=\"diagram-pill\">Design system</div></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-box\" data-rough><span class=\"diagram-pill accent\">Agent generate</span><small class=\"diagram-muted\">standalone HTML / JSX files</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-box\" data-rough>iframe preview<br><small class=\"diagram-muted\">tweak knobs · Cmd+I refine</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&#8635;</div><div class=\"diagram-panel center\"><span class=\"diagram-pill ok\">Export</span><small class=\"diagram-muted\">HTML · ZIP · PDF · handoff</small></div></div>",
+  "css": ".diagram-design{display:flex;align-items:center;gap:12px;flex-wrap:wrap}.diagram-design .diagram-col{display:flex;flex-direction:column;gap:8px;align-items:flex-start}.diagram-design .diagram-box{display:flex;flex-direction:column;gap:4px}.diagram-design .diagram-arrow{font-size:20px;line-height:1}.diagram-design .center{display:flex;flex-direction:column;align-items:center;gap:4px}"
+}
+```
+
+## いつ選択するか
+
+- \*\*レイヤー化された描画キャンバスではなく、ツールを実際の HTML のままにできる、洗練されたランディング ページのコンセプト、製品 UI の方向性、またはブランド探索が必要です。
+- **静的なモックアップではなく、Alpine interactions および Tailwind スタイルを使用した、動作するインタラクティブ プロトタイプ**が必要です。
+- **ルートを迅速に比較したいと考えています**。いくつかのバリエーションを生成し、最も強力なものを選択し、改良を続けます。
+- **自分が所有するデザイン出力が必要な場合** — HTML、ZIP、または PDF をエクスポートするか、プロトタイプをコーディング ツールに渡します。
+
+## それを使って何ができるか
+
+- **完全なプロトタイプを生成します。** 必要な画面またはページを説明すると、エージェントは Tailwind スタイルと Alpine interactions を備えた実用的な HTML ドキュメントを作成します。
+- **バリエーションを比較します。** 複数の方向から始めて、最も強力なものを選択し、その後改良を続けます。
+- **視覚的に調整します。** 一般的な変更には組み込みの調整コントロールを使用するか、エージェントにコピー、レイアウト、色、間隔、およびインタラクションの更新を依頼します。
+- **デザイン システムを適用します。** デザイン システムの設定を保存して再利用することで、生成された作品をブランドに近づけることができます。
+- **参照をインポートします。** 既存の HTML または参照マテリアルを新しいデザイン パスのコンテキストとして取り込みます。
+- **実際のファイルをエクスポートします。** 生成されたプロトタイプから HTML、ZIP、または PDF をエクスポートします。
+
+## はじめに
+
+ライブデモ: [design.agent-native.com](https://design.agent-native.com)。
+
+1. **成果物について説明します。** 画面、フロー、ランディング ページ、またはビジュアルについて尋ねます
+   希望の方向。対象読者、トーン、製品の制約を含めます。
+2. **方向を比較します。** いくつかのバリエーションを生成し、最も強力なものを選択します。
+   最初からやり直すのではなく、磨き続けてください。
+3. **詳細を調整します。** 一般的な視覚的な変更については調整コントロールを使用するか、質問してください
+   レイアウト、コピー、レスポンシブ、インタラクションの変更を行うエージェント。
+4. **役立つ場合はエクスポートします。** HTML、ZIP、または PDF をプロトタイプとしてダウンロードしてください
+   別のツールまたはチームメイトに渡す準備ができています。
+
+### 便利なプロンプト
+
+- 「テクニカル分析製品の 3 つのランディング ページの指示を作成します。」
+- 「このダッシュボードをより高密度にし、運用チームがスキャンしやすくします。」
+- 「保存したデザイン システムを適用して、モバイル レイアウトを簡素化します。」
+- 「最終バリアントが選択されたら、このプロトタイプを ZIP としてエクスポートします。」
+- 「ブランドカラーを変えずに、この HTML をより強力な価格設定ページに変えます。」
+
+## 開発者向け
+
+このドキュメントの残りの部分は、デザイン テンプレートをフォークまたは拡張する人を対象としています。
+
+### クイックスタート
+
+```bash
+npx @agent-native/core@latest create my-design --standalone --template design
+cd my-design
+pnpm install
+pnpm dev
+```
+
+### データモデル
+
+すべてのデータは、Drizzle ORM を介して SQL に存在します。スキーマ: `templates/design/server/db/schema.ts`。デザインとデザイン システムは標準 `ownableColumns` と一致するフレームワーク共有テーブルをサポートするため、ユーザーごと/組織ごとの共有モデルに組み込まれます。
+
+| テーブル                                 | 内容                                                                                                                                              |
+| ---------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `designs`                                | 設計プロジェクト — `title`、`description`、`project_type` (`prototype` / `other`)、`data` JSON BLOB、およびオプションの `design_system_id` リンク |
+| `design_files`                           | デザインに属する個々のファイル (`filename`、`content`、`file_type`、デフォルトは `html`)                                                          |
+| `design_versions`                        | 履歴とロールバック用の、オプションの `label` を備えたデザインのポイントインタイム `snapshot`                                                      |
+| `design_systems`                         | 再利用可能なブランド トークン — `data` (色/タイポグラフィ/間隔)、`assets`、`custom_instructions`、および `is_default` フラグ                      |
+| `design_shares` / `design_system_shares` | フレームワークは、プリンシパル (ユーザーまたは組織) をロール (閲覧者、編集者、管理者) にマッピングするテーブルを共有します                        |
+
+```an-schema title="Design data model" summary="A design owns its files and versioned snapshots, and optionally links a reusable design system. Both designs and systems are ownable, each with a framework shares table."
+{
+  "entities": [
+    { "id": "designs", "name": "designs", "note": "A design project (ownable)", "fields": [
+      { "name": "id", "type": "id", "pk": true },
+      { "name": "title", "type": "text" },
+      { "name": "description", "type": "text", "nullable": true },
+      { "name": "project_type", "type": "text", "note": "prototype / other" },
+      { "name": "data", "type": "json", "note": "starts as {}" },
+      { "name": "design_system_id", "type": "id", "fk": "design_systems.id", "nullable": true }
+    ] },
+    { "id": "files", "name": "design_files", "note": "Files in a design", "fields": [
+      { "name": "design_id", "type": "id", "fk": "designs.id" },
+      { "name": "filename", "type": "text" },
+      { "name": "content", "type": "text" },
+      { "name": "file_type", "type": "text", "note": "defaults to html" }
+    ] },
+    { "id": "versions", "name": "design_versions", "note": "History / rollback", "fields": [
+      { "name": "design_id", "type": "id", "fk": "designs.id" },
+      { "name": "snapshot", "type": "json" },
+      { "name": "label", "type": "text", "nullable": true }
+    ] },
+    { "id": "systems", "name": "design_systems", "note": "Reusable brand tokens (ownable)", "fields": [
+      { "name": "id", "type": "id", "pk": true },
+      { "name": "data", "type": "json", "note": "colors / typography / spacing" },
+      { "name": "assets", "type": "json", "nullable": true },
+      { "name": "custom_instructions", "type": "text", "nullable": true },
+      { "name": "is_default", "type": "boolean" }
+    ] },
+    { "id": "design_shares", "name": "design_shares", "note": "Framework shares table", "fields": [
+      { "name": "design_id", "type": "id", "fk": "designs.id" },
+      { "name": "role", "type": "text", "note": "viewer / editor / admin" }
+    ] },
+    { "id": "system_shares", "name": "design_system_shares", "note": "Framework shares table", "fields": [
+      { "name": "design_system_id", "type": "id", "fk": "design_systems.id" },
+      { "name": "role", "type": "text", "note": "viewer / editor / admin" }
+    ] }
+  ],
+  "relations": [
+    { "from": "designs", "to": "files", "kind": "1-n" },
+    { "from": "designs", "to": "versions", "kind": "1-n" },
+    { "from": "systems", "to": "designs", "kind": "1-n", "label": "applied to" },
+    { "from": "designs", "to": "design_shares", "kind": "1-n" },
+    { "from": "systems", "to": "system_shares", "kind": "1-n" }
+  ]
+}
+```
+
+デザイン プロジェクトは、コンテンツができるまではシェルです。`create-design` は空の行 (`data: "{}"`) を作成し、その後、`generate-design` が実際のスタンドアロン HTML/JSX ファイルを書き込みます。生成されたアーティファクト、編集可能なソース、およびすべてのエクスポートはすべて同じ HTML から取得されるため、翻訳する別の「AI モックアップ」形式はありません。リンクされたデザイン システムは、エージェントが世代パスごとに尊重するトークンと `custom_instructions` を提供します。
+
+UI のルートは `templates/design/app/routes/` の下にあります: `_index.tsx` (リスト)、`design.$id.tsx` (エディター)、`present.$id.tsx` (プレゼンテーション)、`design-systems.tsx` および `design-systems_.setup.tsx`、`templates.tsx`、`examples.tsx`、さらに `settings.tsx` `team.tsx`.
+
+### キー actions
+
+エージェントが呼び出し可能なすべての操作は、`templates/design/actions/` 内の TypeScript ファイルで、`POST /_agent-native/actions/:name` に自動マウントされ、CLI から `pnpm action <name>` として実行可能です。グループ化:
+
+- **デザイン** — `create-design` (空のシェル)、`generate-design` (生成された HTML/JSX コンテンツを書き込む)、`update-design`、`get-design`、`list-designs`、`duplicate-design`、`delete-design`、および `apply-tweaks` (ライブ永続化用)ノブの値を調整します (アクセントカラー、濃度など)。
+- **ファイル** — 設計プロジェクト内のファイルの `create-file`、`update-file`、`list-files`、`delete-file`。
+- **デザイン システム** — 分析に先立ってブランド データを収集するための `create-design-system`、`update-design-system`、`get-design-system`、`list-design-systems`、`delete-design-system`、`set-default-design-system`、および `analyze-brand-assets`。
+- **インポート** — `import-code`、`import-figma`、`import-github`、`import-from-url`、`import-document` (DOCX/PPTX/PDF/XLSX)、および `import-design-project` を使用して、既存のプロジェクトからデザイン システムを取り出します。
+- **エクスポートとハンドオフ** — デザインをコーディング ツールのハンドオフに変換するための `export-html`、`export-pdf`、`export-svg`、`export-zip`、および `export-coding-handoff`。
+- **コンテキストとナビゲーション** — `view-screen` (現在のデザイン、開いているファイル、ビュー、保留中の質問またはバリアント グリッド)、`get-design-snapshot` (外部エージェントが続行する現在の状態)、および `navigate`。
+
+### エージェントと協力する
+
+エージェントは、あなたが何を開いているかを常に知っています。現在のデザイン、開いているファイル、アクティブなビュー、および保留中の質問またはバリアント グリッドが `view-screen` によって返され、すべてのメッセージに挿入されるため、デザインに名前を付けずに「これをより高密度にする」または「このバリアントをエクスポートする」と言うことができます。
+
+デザインは単なるスタンドアロンの HTML/JSX ファイルであるため、エージェントは iframe がレンダリングし、すべてのエクスポート元と同じソースを編集します。変換する個別の「AI モックアップ」形式はありません。リンクされた設計システムはトークンと `custom_instructions` を提供し、エージェントは世代パスごとにそれを尊重します。プレビューでテキストまたは領域を選択し、Cmd+I を押して、エージェントをその部分に正確に集中させます。
+
+### カスタマイズ
+
+デザインは完全な複製可能なテンプレートです。いくつかの実践的な拡張アイデア:
+
+- 「トークンとサンプル コンポーネントを使用して、再利用可能な e コマース デザイン システムを追加します。」
+- 「ZIP を社内レビュー システムにアップロードするエクスポート ステップを追加します。」
+- 「既存のランディング ページ HTML を貼り付けて、より強力な 3 つのバージョンをエージェントに依頼しましょう。」
+- 「製品ページ、ダッシュボード、オンボーディング画面の概要用に保存されたプロンプト ライブラリを追加します。」
+- 「関係者レビュー用にカスタム PDF エクスポート プリセットを追加します。」
+
+エージェントは、必要に応じてルート、コンポーネント、actions、および SQL をサポートするモデルを編集します。完全なクローン、カスタマイズ、デプロイのフローについては [Templates](/docs/cloneable-saas) を参照し、初めてのエージェント ネイティブ テンプレートの場合は [Getting Started](/docs/getting-started) を参照してください。
+
+## 次は何ですか
+
+- [**Templates**](/docs/cloneable-saas) — クローンと独自のモデル
+- [**Context Awareness**](/docs/context-awareness) — ユーザーが表示しているものをエージェントがどのように認識するか
+- [**Creating Templates**](/docs/creating-templates) — エージェント ネイティブ テンプレートの現在のビルド パターン