fivocell 8.12.24 → 8.12.25

package/README.ja.md

@@ -0,0 +1,650 @@
+<div align="center">
+  <a href="https://github.com/itsvinsoni/cell">
+    <img src="assets/Fivo-cell-readme-banner.png" alt="FivoCell" width="800" />
+  </a>
+
+  <h1>FivoCell</h1>
+
+  <p><strong>あなたのAIは忘れる。Cellは忘れない。</strong><br/>
+  あなたが使うすべてのAIコーディングツールのための、永続的なローカルメモリレイヤー。</p>
+
+  <p>
+    <a href="LICENSE"><img src="https://img.shields.io/badge/License-Apache%202.0-blue" alt="License" /></a>
+    &nbsp;
+    <img src="https://img.shields.io/badge/Mac%20%7C%20Windows%20%7C%20Linux-supported-lightgrey" alt="Platform" />
+    &nbsp;
+    <img src="https://img.shields.io/badge/Node-%3E%3D18-green" alt="Node" />
+    &nbsp;
+    <a href="https://www.npmjs.com/package/fivocell"><img src="https://img.shields.io/npm/v/fivocell" alt="npm" /></a>
+    &nbsp;
+    <img src="https://img.shields.io/badge/npm%20audit-0%20vulnerabilities-success" alt="Security" />
+  </p>
+
+  <p>
+    <a href="#-クイックスタート">クイックスタート</a> &nbsp;·&nbsp;
+    <a href="#-時間経過とともに">時間経過とともに</a> &nbsp;·&nbsp;
+    <a href="#-機能とメリット">機能</a> &nbsp;·&nbsp;
+    <a href="#-アーキテクチャ">アーキテクチャ</a> &nbsp;·&nbsp;
+    <a href="#-対応ツール">対応ツール</a> &nbsp;·&nbsp;
+    <a href="#-コントリビュート">コントリビュート</a>
+  </p>
+</div>
+
+---
+
+## 🤔 FivoCellとは？
+
+AIコーディングツールと話すたびに、それは**ゼロ**から始まります。プロジェクト、技術スタック、コーディングスタイル、昨日の決定を何度も説明し直します。CursorからClaude Codeに切り替え？最初からやり直し。新しいチャット？最初からやり直し。新しい日？最初からやり直し。
+
+**FivoCellはこれを解決します。** ローカルデーモンとして静かにあなたのマシンで動作し、すべてのAIツールの**永続的な脳**として機能します。インストールされた瞬間、すべてのAIツールが以下を知ることができます：
+
+<div align="center">
+  <table>
+    <tr><td>🧠 <strong>あなたのプロジェクト</strong></td><td>技術スタック、フレームワーク、構造、アーキテクチャ</td></tr>
+    <tr><td>✍️ <strong>あなたのスタイル</strong></td><td>命名規則、関数スタイル、エラーハンドリングパターン</td></tr>
+    <tr><td>📜 <strong>あなたの決定</strong></td><td>「SQLiteを選んだ理由は...」「Xを却下した」</td></tr>
+    <tr><td>⚠️ <strong>あなたの盲点</strong></td><td>コードベース全体のリスク箇所を自動スキャン</td></tr>
+    <tr><td>🔁 <strong>あなたの履歴</strong></td><td>前回のセッションで何をしたか、次に何をするか</td></tr>
+  </table>
+</div>
+
+**実際の出力例 — Cellが初回スキャンで telling すること：**
+
+```
+✅ プロジェクトをスキャンしました
+⚠️  98個のファイルで非同期関数にtry/catchが不足
+⚠️  43個のファイルにconsole.logが残存
+⚠️  コアモジュールでnull安全性の問題を検出
+🧠  あなたのバイブス："バイリンガルコミュニケーション、戦略的監査、素早い出荷"
+🔮  次回セッション予測：authモジュールのエラーハンドリング改善が必要
+```
+
+> **AIツールはコードを書く。Cellはその他のすべてを記憶する。**
+
+<div align="center"><strong>100%ローカル。デフォルトでプライベート。オフラインで動作。登録不要。</strong></div>
+
+---
+
+## 💡 問題 vs 解決方案
+
+<div align="center">
+  <table>
+    <tr>
+      <th></th>
+      <th>😫 AIツールのみ</th>
+      <th>✅ FivoCell使用時</th>
+    </tr>
+    <tr>
+      <td><strong>プロジェクトコンテキスト</strong></td>
+      <td>毎回のセッションで再説明</td>
+      <td><code>@cell</code>を入力するだけで自動注入</td>
+    </tr>
+    <tr>
+      <td><strong>ツール横断メモリ</strong></td>
+      <td>各ツールが単離</td>
+      <td>すべてのツールで共有メモリ</td>
+    </tr>
+    <tr>
+      <td><strong>コードスタイル</strong></td>
+      <td>手動でルールファイルを維持</td>
+      <td>自動検出・適用</td>
+    </tr>
+    <tr>
+      <td><strong>リスクと盲点</strong></td>
+      <td>AIが気づくことを期待</td>
+      <td>カテゴリ別に自動スキャン</td>
+    </tr>
+    <tr>
+      <td><strong>ツール切り替え</strong></td>
+      <td>切り替えごとにコンテキスト消失</td>
+      <td>ツール間でシームレスにハンドオフ</td>
+    </tr>
+    <tr>
+      <td><strong>あなたの正体</strong></td>
+      <td>毎回の汎用的な応答</td>
+      <td>セッションを越えて個性を学習</td>
+    </tr>
+    <tr>
+      <td><strong>プライバシー</strong></td>
+      <td>クラウド依存が多い</td>
+      <td>完全ローカル、クラウドはオプトイン</td>
+    </tr>
+  </table>
+</div>
+
+```
+  Cursor ──────────┐
+  Claude Code ─────┤                 ┌─────────────────────┐
+  Codex ───────────┤                 │      FIVO CELL       │
+  Antigravity ─────┼────────────────>│      メモリレイヤー   │
+  Windsurf ────────┤                 │      デーモン :9876   │
+  OpenCode ────────┤                 │      MCPツール       │
+  任意のMCPツール ─┘                 └──────────┬──────────┘
+                                                │
+                              ┌──────────────────┴──────────────────┐
+                              │                                     │
+                              ▼                                     ▼
+                    ┌─────────────────┐                  ┌─────────────────┐
+                    │  SQLite（ローカル）│                │  IDE内の@cell   │
+                    │  永に忘れない     │                │  完全なコンテキスト│
+                    │  永にリセットしない│                │  即時応答        │
+                    └─────────────────┘                  └─────────────────┘
+```
+
+---
+
+## ⚡ クイックスタート
+
+```bash
+# ステップ1 — インストール（1回のみ）
+npm install -g fivocell
+
+# ステップ2 — プロジェクトに移動して実行
+cd your-project
+cell run
+```
+
+`cell run` 1コマンドですべてを実行します：
+
+```
+[1/7] ✅ セットアップ完了 — .cell/ フォルダを作成
+[2/7] 🔍 コードベースをスキャン中 — ファイル、スタック、スタイル、盲点
+[3/7] ⚠️  盲点を検出 — null安全性、エラーハンドリング、console.log
+[4/7] 🧠 バイブスエンジン起動 — パターンを学習中
+[5/7] 📄 AGENTS.md を作成 — AIツールがあなたを認識
+[6/7] 🚀 デーモンが :9876 で起動 — MCPツール準備完了
+[7/7] 👁️  ウォッチャー起動 — ファイル保存を追跡開始
+```
+
+次に**任意の**AIツール（Cursor、Claude Code、Windsurf）を開いて入力：
+
+```
+@cell このアプリに認証機能を追加するにはどうすればよいですか？
+```
+
+AIは**完全なコンテキスト**で応答します — 技術スタック、スタイル、決定、盲点 — 何も説明する必要なし。✨
+
+```bash
+cell status     # デーモン + プロジェクトの健康状態を確認
+cell context    # AIが見るものを確認
+cell vibe       # 開発者の個性を確認
+```
+
+---
+
+## 📅 時間経過とともに
+
+### 1日目 — `cell run` 実行後
+
+| ステップ | 何が起こるか |
+|:----:|-----------|
+| 1 | `npm install -g fivocell` — グローバルインストール |
+| 2 | `cell run` — セットアップ + スキャン + デーモン起動を1コマンドで |
+| 3 | コードスキャン実行 — ファイル解析、盲点検出（null安全性、エラーハンドリング、console.log等） |
+| 4 | `.cell/` フォルダ作成 — バイブス、コンテキスト、INDEX、ブリッジファイル |
+| 5 | プロジェクトルートに `AGENTS.md` 作成 — すべてのAIツールに `@cell` を教える |
+| 6 | デーモンが `:9876` で起動 — すべてのMCPツール準備完了 |
+| 7 | ウォッチャー起動 — これ以降のすべての保存を追跡 |
+
+**以下のような出力が表示されます：**
+```
+⚠️  98個のファイル：非同期関数にtry/catchが不足
+⚠️  43個のファイル：console.logが未削除
+   null_safety：高優先度
+   error_handling：高優先度
+```
+
+---
+
+### 最初の7日間 — Cellがあなたを学ぶ
+
+| イベント | 何が起こるか |
+|:----:|-----------|
+| 8 | 任意のエディタで `@cell` を入力 → 即座にコンテキスト注入、説明不要 |
+| 9 | バイブス信号を検出 — "バイリンガルコミュニケーション、戦略的監査、実用的出荷者" |
+| 10 | ウォッチャーがイベントを記録 — すべてのファイル保存、すべてのgitコミットを追跡 |
+| 11 | スマートトリガー：60秒以内に5回保存 → 予測を自動更新 |
+| 12 | `cell scan` を実行 → コード分析が新しい盲点で更新 |
+| 13 | クロスエディタメモリ — Cursorでセッション終了 → Claude Codeを開く → ブリッジは既に存在 |
+| 14 | セッションブリッジがキャプチャ — タッチしたファイル、下した決定、失敗したもの、成功したもの |
+
+---
+
+### 最初の30日間 — Cellがあなたを理解する
+
+| イベント | 何が起こるか |
+|:----:|-----------|
+| 15 | バイブスが安定 — 高信頼度のパーソナリティプロファイルが固まる |
+| 16 | クロスプロジェクトプロファイル — `~/.fivo/cell/projects/` がすべてのリポジトリのデータを追跡 |
+| 17 | グローバルバイブス統合 — すべてのプロジェクトで1つのアイデンティティ |
+| 18 | 予測が正確に — "このファイルが開かれる"、"このエラーが再発する" |
+| 19 | モデルインテリジェンス — どのAIツールが最高のコード受容率を持つかを追跡 |
+| 20 | メモリ圧縮 — 90日以上前のイベントを自動アーカイブ |
+| 21 | user-profile.md 生成 — スキル、盲点、成長過程を記録 |
+| 22 | ニューラルハンドオフ — セッション終了ごとにブリッジ + 連続性を保存し、シームレスな次回開始を実現 |
+
+---
+
+## 🚀 機能とメリット
+
+### ⚙️ コアコマンド
+
+<div align="center">
+  <table>
+    <tr><th>コマンド</th><th>機能</th><th>カテゴリ</th></tr>
+    <tr><td><code>cell run</code></td><td>セットアップ + スキャン + 起動 — 1コマンドで完了</td><td>セットアップ</td></tr>
+    <tr><td><code>cell scan</code></td><td>コードベース分析：スタック、スタイル、パターン、盲点</td><td>分析</td></tr>
+    <tr><td><code>cell status</code></td><td>デーモン + プロジェクト + データベースの健康状態を一覧表示</td><td>監視</td></tr>
+    <tr><td><code>cell start</code> / <code>cell stop</code></td><td>バックグラウンドメモリデーモンのオン/オフ</td><td>デーモン</td></tr>
+    <tr><td><code>cell sync</code></td><td>インテリジェンスのプッシュ・プル（オプション、オプトイン）</td><td>クラウド</td></tr>
+    <tr><td><code>cell vibe</code></td><td>開発者のパーソナリティプロファイル</td><td>個性</td></tr>
+    <tr><td><code>cell doctor</code></td><td>すべてのレイヤーにわたる完全なヘルスチェック</td><td>健康</td></tr>
+    <tr><td><code>cell -i</code></td><td>対話型REPL、ChatGPTスタイルのターミナル</td><td>REPL</td></tr>
+  </table>
+</div>
+
+> 複数のCLIコマンドがカテゴリ別に整理されています。すべて見るには `cell help --all` を実行。
+
+---
+
+### 🧠 メモリとコンテキスト
+
+<div align="center">
+  <table>
+    <tr><th>機能</th><th>詳細</th></tr>
+    <tr><td><strong>@cell コンテキスト</strong></td><td>任意のIDEで <code>@cell</code> を入力 — プロジェクト、盲点、予測、セッション — すべて自動注入</td></tr>
+    <tr><td><strong>スプリームコンテキスト</strong></td><td>3つのエンジン（ブリッジ + 連続性 + 予測器）による真のクロスセッションメモリ</td></tr>
+    <tr><td><strong>永続メモリ</strong></td><td>すべてのイベントをローカルSQLiteに保存 — 決定、エラー、修正、パターン — 永に失われない</td></tr>
+    <tr><td><strong>セッションメモリ</strong></td><td>すべてのセッションを記録：タッチしたファイル、下した決定、試したアプローチ</td></tr>
+    <tr><td><strong>Cellインデックス</strong></td><td><code>.cell/INDEX.md</code> — 約89%のデータ削減による高速コンテキスト検索</td></tr>
+    <tr><td><strong>メモリ検索</strong></td><td>すべての履歴にわたるFTS5全文検索を即座に実行</td></tr>
+    <tr><td><strong>クロスエディタハンドオフ</strong></td><td>Cursorで終了、Claude Codeで続行 — セッションブリッジが既に待機中</td></tr>
+  </table>
+</div>
+
+#### スプリームコンテキスト — 3つのエンジン
+
+<div align="center">
+  <table>
+    <tr><th>エンジン</th><th>機能</th></tr>
+    <tr><td><strong>ブリッジ</strong></td><td>セッション終了時にサマリーをキャプチャ。次回開始時に自動注入。追跡：サマリー、重要な決定、未解決の質問、失敗したアプローチ、成功したアプローチ、最後の思考、注目ファイル、バイブススナップショット、予測される次のステップ。</td></tr>
+    <tr><td><strong>連続性</strong></td><td>クロスセッションスレッド。意図を自動検出：バグ修正、機能開発、リファクタリング、テスト、ドキュメント、リリース。「何を作っているの？」と決して聞かない。</td></tr>
+    <tr><td><strong>予測器</strong></td><td>必要なファイル、再発する可能性のあるエラー、再検討が必要な決定を予測。30日間で精度が向上。</td></tr>
+  </table>
+</div>
+
+---
+
+### 🎭 バイブス — 開発者の個性
+
+<div align="center">
+  <table>
+    <tr><th>機能</th><th>詳細</th></tr>
+    <tr><td><strong>パーソナリティ信号</strong></td><td>複数のグループで学習：言語、トーン、コードスタイル、ワークフロー、意思決定</td></tr>
+    <tr><td><strong>アイデンティティ検出</strong></td><td>あなたのアーキタイプを自動検出：例「バイリンガルコミュニケーター — 戦略的監査者 — 実用的出荷者」</td></tr>
+    <tr><td><strong>AIガイド</strong></td><td>すべてのAIセッションに注入されるルールを生成 — 「この開発者にどう話しかけるか」</td></tr>
+    <tr><td><strong>ライブ実行</strong></td><td>ファイル保存時にバイブスルール違反を自動フラグ</td></tr>
+    <tr><td><strong>クロスシグナルペア</strong></td><td>複合動作を検出：直接 + 簡潔 = のんきなコミュニケーター</td></tr>
+    <tr><td><strong>矛盾解決</strong></td><td>機能は素早く出荷、セキュリティは完璧に — コンテキスト依存のバイブス</td></tr>
+  </table>
+</div>
+
+**信号グループ：** 言語偏好 · 応答構造 · コミュニケーショントーン · コード変更スタイル · ワークフロー · 意思決定 · 速度vs品質 · AI信頼度 · プロジェクト行動 · 感情のニュアンス · プロンプト思考 · セッションリズム
+
+> **Cellが生成したAIガイドの例：** "直接的に — まず答え、次に説明。有用的な場所で日本語と英語を混ぜる。変更は最小限に。提案の前にまず監査。求められない限り書き直さない。"
+
+---
+
+### 🔍 コードインテリジェンス
+
+<div align="center">
+  <table>
+    <tr><th>機能</th><th>詳細</th></tr>
+    <tr><td><strong>コードスキャナー</strong></td><td>すべてのプロジェクトファイルを走査し、構造、スタック、スタイル、リスクパターンを分析</td></tr>
+    <tr><td><strong>盲点検出</strong></td><td>検出：null安全性、try/catch不足、console.log、コード品質、パフォーマンス、バリデーション</td></tr>
+    <tr><td><strong>深層分析</strong></td><td>複雑度分析、重複検出、ネスト深度、長い関数</td></tr>
+    <tr><td><strong>スタック検出</strong></td><td>言語、フレームワーク、DB、ORM、テストランナー — すべて自動検出</td></tr>
+    <tr><td><strong>スタイル抽出</strong></td><td>プロジェクト固有の命名スタイル、インポート方法、エラーハンドリングパターンを検出</td></tr>
+    <tr><td><strong>Gitインテリジェンス</strong></td><td>Gitフックがコミットごとに自動学習。パターンと繰り返しエラーを追跡。</td></tr>
+  </table>
+</div>
+
+---
+
+### 📡 MCP — マルチIDEサポート
+
+<div align="center">
+  <table>
+    <tr><th>機能</th><th>詳細</th></tr>
+    <tr><td><strong>マルチIDE自動設定</strong></td><td>Cursor、Windsurf、Antigravity、Codex/Copilot、OpenCode</td></tr>
+    <tr><td><strong>リッチMCPツール</strong></td><td>セッション、コンテキスト、メモリ、バイブス、チーム、コミュニティ、監視、同期、グラフ、スキャン、CI — すべてカバー</td></tr>
+    <tr><td><strong>誠実な検出</strong></td><td>実際にインストールされているIDEのみ設定 — 偽のカウントなし</td></tr>
+    <tr><td><strong>自動設定</strong></td><td><code>cell mcp-config</code> — 1コマンドですべてのIDEを登録</td></tr>
+  </table>
+</div>
+
+---
+
+### 👁️ ファイルウォッチャー
+
+<div align="center">
+  <table>
+    <tr><th>機能</th><th>詳細</th></tr>
+    <tr><td><strong>ライブイベント</strong></td><td>ファイル変更をリアルタイムでキャプチャ — すべての保存を追跡</td></tr>
+    <tr><td><strong>スマートトリガー</strong></td><td>60秒以内に5回保存 → 予測を自動更新</td></tr>
+    <tr><td><strong>バイブス更新</strong></td><td>ウォッチャーがパーソナリティプロファイルを自動的に新鮮に保つ</td></tr>
+    <tr><td><strong>TCPブリッジ</strong></td><td>ポート9877、エディタイベント用の専用ソケット</td></tr>
+    <tr><td><strong>自動学習</strong></td><td>Gitフックがコミットごとに自動学習をトリガー</td></tr>
+  </table>
+</div>
+
+---
+
+### ☁️ クラウド同期 — オプトインのみ
+
+<div align="center">
+  <table>
+    <tr><th>機能</th><th>詳細</th></tr>
+    <tr><td><strong>プライバシー優先</strong></td><td>匿名化されたパターンのみがマシンから离开。機密情報、パス、コードは決して离开しない</td></tr>
+    <tr><td><strong>オプトイン範囲</strong></td><td>細粒度のカテゴリ — 同期する内容と先を自分で選択</td></tr>
+    <tr><td><strong>包括的なマスキング</strong></td><td>APIキー、AWS認証情報、プライベートキー、トークン、メール、JWT — すべて <code>[マスク済み]</code></td></tr>
+    <tr><td><strong>JWT自動更新</strong></td><td>トークン有効期限チェック、5分の猶予期間、自動更新</td></tr>
+    <tr><td><strong>デバイス登録</strong></td><td>UUID v4デバイスID + JWT認証、初回ログイン時に完了</td></tr>
+    <tr><td><strong>AES-256-GCM</strong></td><td>暗号化同期、レート制限、オフライン対応</td></tr>
+  </table>
+</div>
+
+---
+
+### 🩺 健康とセキュリティ
+
+<div align="center">
+  <table>
+    <tr><th>機能</th><th>詳細</th></tr>
+    <tr><td><strong>マルチポイントドクター</strong></td><td>git、node、DB、デーモン、監視、MCP、FTS、スキャン — <code>cell doctor</code> ですべてチェック</td></tr>
+    <tr><td><strong>ローカルホストのみ</strong></td><td>デーモンが <code>127.0.0.1</code> にバインド — LAN露出ゼロ</td></tr>
+    <tr><td><strong>アトミックライト</strong></td><td>一時ファイル→リネーム — クラッシュ時でもファイルが破損しない</td></tr>
+    <tr><td><strong>eval/spawnSyncなし</strong></td><td>動的コード実行ベクトルゼロ</td></tr>
+    <tr><td><strong>パラメータ化SQL</strong></td><td>すべてのクエリでインジェクションリスクゼロ</td></tr>
+    <tr><td><strong>npm audit: 0</strong></td><td>依存関係の既知脆弱性ゼロ</td></tr>
+  </table>
+</div>
+
+---
+
+## 🚫 FivoCellがしないこと
+
+正直なリスト。使用前にこれを理解してください。
+
+| # | 欠如 | 理由 |
+|:-:|------|------|
+| 1 | **意味的コード理解** — 「この関数が論理的に間違っている理由を説明」 | LLMが必要。Cellは完全にルールベースで確定的。 |
+| 2 | **ライブクラウド同期** (`cell.fivo.live`) | クラウドサーバーは別途デプロイ。Cell自体は100%オフライン動作。 |
+| 3 | **マルチ言語深層パース**（Python、Rust、Go） | Tree-sitterはインストール済みだが、すべてのアナライザーに完全接続されていない。 |
+
+**Cellとは：** ルールベースの、確定的な、オフライン優先のメモリレイヤー。
+**Cellではない：** LLM、コード説明者、クラウドサービス。
+
+---
+
+## 🆚 FivoCell vs 代替手段
+
+<div align="center">
+  <table>
+    <tr>
+      <th>能力</th>
+      <th><strong>FivoCell</strong></th>
+      <th>Pieces for Devs</th>
+      <th>Mem0</th>
+      <th>Cursor</th>
+      <th>.cursorrules</th>
+    </tr>
+    <tr>
+      <td><strong>複数のAIツール</strong>で動作</td>
+      <td align="center">✅ MCP経由で5+以上</td>
+      <td align="center">🟡 部分的</td>
+      <td align="center">🟡 SDKのみ</td>
+      <td align="center">❌ Cursorのみ</td>
+      <td align="center">❌ ツールごと</td>
+    </tr>
+    <tr>
+      <td><strong>クロスセッション</strong>メモリ</td>
+      <td align="center">✅ ブリッジ + 連続性</td>
+      <td align="center">✅</td>
+      <td align="center">✅</td>
+      <td align="center">🟡 限定的</td>
+      <td align="center">❌</td>
+    </tr>
+    <tr>
+      <td><strong>100%ローカル</strong>（オフライン動作）</td>
+      <td align="center">✅</td>
+      <td align="center">🟡 クラウド寄り</td>
+      <td align="center">❌ クラウド/API</td>
+      <td align="center">❌ クラウド</td>
+      <td align="center">✅ 静的</td>
+    </tr>
+    <tr>
+      <td><strong>コードベーススキャン</strong>と盲点</td>
+      <td align="center">✅ 完全ローカルスキャン</td>
+      <td align="center">❌</td>
+      <td align="center">❌</td>
+      <td align="center">🟡 基本</td>
+      <td align="center">❌</td>
+    </tr>
+    <tr>
+      <td><strong>パーソナリティ/バイブス</strong>を学習</td>
+      <td align="center">✅ マルチシグナル</td>
+      <td align="center">❌</td>
+      <td align="center">❌</td>
+      <td align="center">❌</td>
+      <td align="center">❌ 手動</td>
+    </tr>
+    <tr>
+      <td><strong>自動検出</strong>コードスタイル</td>
+      <td align="center">✅ マルチカテゴリ</td>
+      <td align="center">❌</td>
+      <td align="center">❌</td>
+      <td align="center">🟡</td>
+      <td align="center">❌</td>
+    </tr>
+    <tr>
+      <td>プライバシー：<strong>オプトイン</strong>クラウド + マスキング</td>
+      <td align="center">✅ 15種のマスキングパターン</td>
+      <td align="center">🟡</td>
+      <td align="center">❌</td>
+      <td align="center">❌</td>
+      <td align="center">✅</td>
+    </tr>
+    <tr>
+      <td><strong>オープンソース</strong></td>
+      <td align="center">✅ Apache 2.0</td>
+      <td align="center">❌</td>
+      <td align="center">🟡</td>
+      <td align="center">❌</td>
+      <td align="center">✅</td>
+    </tr>
+    <tr>
+      <td>セットアップ手間</td>
+      <td align="center">✅ 1コマンド</td>
+      <td align="center">🟡 アプリインストール</td>
+      <td align="center">🟡 コード統合</td>
+      <td align="center">✅ 内蔵</td>
+      <td align="center">🟡 手動</td>
+    </tr>
+  </table>
+</div>
+
+---
+
+## 🏗️ アーキテクチャ
+
+```
+┌─────────────────────────────────────────────────────────────────┐
+│                     あなたのマシン（100%ローカル）                 │
+│                                                                 │
+│  Cursor ──┐                                                     │
+│  Windsurf ┤  MCPプロトコル                                       │
+│  Claude   ├────────────────────────────────────────────────>    │
+│  Codex    ┤                    ┌───────────────────────────┐    │
+│  Antigrav ┘                    │      FIVO CELL デーモン     │    │
+│                                │   http://localhost:9876   │    │
+│                                ├───────────────────────────┤    │
+│                                │ プロンプトビルダー | MCPサーバー│
+│                                │ コンテキストブリッジ | CLIルーター│
+│                                │ セッショントラッカー | ウォッチャー│
+│                                └──────────┬────────────────┘    │
+│                                           │                     │
+│                         ┌─────────────────┼─────────────────┐  │
+│                         ▼                 ▼                 ▼  │
+│                   ┌──────────┐    ┌──────────┐    ┌──────────┐ │
+│                   │  SQLite  │    │  .cell/  │    │  バイブス │ │
+│                   │  ローカル │    │  INDEX   │    │  エンジン │ │
+│                   │  DB      │    │  bridge  │    │  信号    │ │
+│                   └──────────┘    └──────────┘    └──────────┘ │
+└─────────────────────────────────────────────────────────────────┘
+```
+
+### 7層アーキテクチャ
+
+<div align="center">
+  <table>
+    <tr><th align="center">層</th><th align="center">名前</th><th>責任</th></tr>
+    <tr><td align="center">1</td><td align="center"><strong>コンテキスト</strong></td><td>AIが見るプロンプトを構築：ブリッジ、連続性、予測器、セッション</td></tr>
+    <tr><td align="center">2</td><td align="center"><strong>スキャナー</strong></td><td>コードを分析：スタック、スタイル、盲点、Gitインテリジェンス</td></tr>
+    <tr><td align="center">3</td><td align="center"><strong>ナレッジ</strong></td><td>決定、エラー予測、プロジェクトDNA、説明可能性</td></tr>
+    <tr><td align="center">4</td><td align="center"><strong>コラボレーション</strong></td><td>チームDNA、ナレッジマップ、健康とバスファクター</td></tr>
+    <tr><td align="center">5</td><td align="center"><strong>コミュニティ</strong></td><td>コミュニティパターン、マーケットプレイス、プレイブック、クラウドコネクター</td></tr>
+    <tr><td align="center">6</td><td align="center"><strong>メモリ</strong></td><td>コアエンジン：SQLite、バイブス、ランキング、圧縮、暗号化</td></tr>
+    <tr><td align="center">7</td><td align="center"><strong>ランタイム</strong></td><td>デーモン（Express :9876）、MCPサーバー、CLI、ウォッチャー、オートスタート</td></tr>
+  </table>
+</div>
+
+### スプリームコンテキストエンジンフロー
+
+```
+  セッション開始  ->  [連続性]  アクティブスレッドをロード
+                  ->  [ブリッジ]  前回セッションサマリーをロード
+                  ->  [予測器]   次のアクションを提案
+                  ->  AIが完全なコンテキストを取得、手動説明不要
+
+  セッション終了  ->  [ブリッジ]  サマリーをキャプチャ
+                  ->  [連続性]  スレッドを更新
+                  ->  [予測器]  予測を更新
+                  ->  .cell/ に保存 — 永に失われない
+```
+
+### データフロー
+
+```
+  @cell入力  ->  :9876へのMCPリクエスト
+               ->  プロンプトビルダーが読み取り：
+                   +-- SQLiteローカルDB（すべてのイベント、決定、エラー）
+                   +-- .cell/INDEX.md（高速コンテキスト検索）
+                   +-- .cell/vibe/（パーソナリティ信号）
+                   +-- .cell/bridge/latest.json（前回セッション）
+                   +-- .cell/continuity/（アクティブスレッド）
+                   +-- .cell/predictor.json（次のアクション）
+               ->  関連性でランク付け
+               ->  トークン予算に圧縮
+               ->  ツールごとにフォーマット
+               ->  AIにコンテキストブロックを返す
+```
+
+---
+
+## 🔌 対応ツール
+
+<div align="center">
+  <table>
+    <tr><th>ツール</th><th>接続方法</th><th>セットアップ</th></tr>
+    <tr><td><strong>Cursor</strong></td><td>MCP（自動）</td><td><code>cell mcp-config</code></td></tr>
+    <tr><td><strong>Codex / GitHub Copilot</strong></td><td>MCP（自動）</td><td><code>cell mcp-config</code></td></tr>
+    <tr><td><strong>Antigravity / Gemini</strong></td><td>MCP（自動）</td><td><code>cell mcp-config</code></td></tr>
+    <tr><td><strong>Windsurf</strong></td><td>MCP（自動）</td><td><code>cell mcp-config</code></td></tr>
+    <tr><td><strong>OpenCode</strong></td><td>MCP（自動）</td><td><code>cell mcp-config</code></td></tr>
+    <tr><td><strong>Claude Code</strong></td><td>MCP（手動）</td><td><code>http://127.0.0.1:9876/mcp</code></td></tr>
+    <tr><td><strong>任意のMCPクライアント</strong></td><td>HTTP</td><td><code>http://127.0.0.1:9876/mcp</code></td></tr>
+  </table>
+</div>
+
+---
+
+## 🔒 セキュリティとデータプライバシー
+
+FivoCellは**プライバシー優先、デフォルトローカル**のアーキテクチャで設計されており、あなたの機密の知的財産や認証情報がコントロールを離れることはありません。
+
+### FivoCellが取得するもの（100%ローカル保存）
+* 💾 **ローカルSQLiteデータベース**：メモリイベント、CLI履歴、セッションサマリー、決定をローカルマシンに保存（`.cell/` フォルダ）。
+* ⚙️ **開発者バイブス信号**：ローカルプログラミング慣習とスタイルを学習し、カスタムAI指示を構築。
+* 🔍 **コード診断**：ローカルスキャナーがコード脆弱性、構造リスク、コーディングパターンをチェック。
+
+### FivoCellが絶対にアクセス・送信しないもの
+* ❌ **生のソースコード**：すべてのコード診断はローカルで実行。ソースファイルはマシンから离开しない。
+* ❌ **APIキーと認証情報**：`PrivacyRedactor` がAPIトークン、AWSキー、データベースURL、パスワードパターン（15種のデフォルトフィルター）をネットワーク呼び出し前にインターセプトしてマスキング。
+* ❌ **個人/システム識別子**：絶対パス、メール、プライベートIP、内部ホスト名は完全に除去。
+
+### オプトインクラウド同期（細粒度制御）
+クラウド機能はデフォルトで**完全にオフ**であり、明示的なオプトインが必要です：
+* **コミュニティパターン**：匿名化されたバイブスと上位レベルのスタイルパターンのみ — 生のコード、名前、パスはなし。
+* **チーム同期**：プロジェクト決定とセッションハンドオフのオプション暗号化共有。
+
+いつでもセキュリティ状態を確認：
+```bash
+cell doctor
+```
+
+---
+
+## 📚 ドキュメント
+
+<div align="center">
+  <table>
+    <tr><th>ドキュメント</th><th>リンク</th></tr>
+    <tr><td>セキュリティポリシー</td><td><a href="docs/SECURITY.md">docs/SECURITY.md</a></td></tr>
+    <tr><td>プライバシー</td><td><a href="docs/PRIVACY.md">docs/PRIVACY.md</a></td></tr>
+    <tr><td>テレメトリ</td><td><a href="docs/TELEMETRY.md">docs/TELEMETRY.md</a></td></tr>
+    <tr><td>信頼</td><td><a href="docs/TRUST.md">docs/TRUST.md</a></td></tr>
+    <tr><td>変更履歴</td><td><a href="docs/CHANGELOG.md">docs/CHANGELOG.md</a></td></tr>
+    <tr><td>コントリビューションガイド</td><td><a href="docs/CONTRIBUTING.md">docs/CONTRIBUTING.md</a></td></tr>
+    <tr><td>デプロイガイド</td><td><a href="docs/DEPLOY.md">docs/DEPLOY.md</a></td></tr>
+    <tr><td>コマンドリファレンス</td><td><a href="docs/COMMANDS.md">docs/COMMANDS.md</a></td></tr>
+    <tr><td>バグ報告</td><td><a href="docs/BUG_REPORT.md">docs/BUG_REPORT.md</a></td></tr>
+    <tr><td>クラウド同期ガイド</td><td><a href="docs/CLOUD-SYNC-GUIDE.md">docs/CLOUD-SYNC-GUIDE.md</a></td></tr>
+  </table>
+</div>
+
+---
+
+## 🤝 コントリビュート
+
+FivoCellは**Apache 2.0でオープンソース**です。コントリビュート、Issue、PRを歓迎します。
+
+```bash
+git clone https://github.com/itsvinsoni/cell
+cd cell
+npm install
+npm test        # すべてのテストがパスすることを確認
+```
+
+<div align="center">
+  🐛 バグを発見？ <a href="https://github.com/itsvinsoni/cell/issues">Issueをオープン</a>
+  &nbsp;·&nbsp;
+  💡 アイデアがある？ <a href="https://github.com/itsvinsoni/cell/discussions">ディスカッションを開始</a>
+  &nbsp;·&nbsp;
+  🔧 構築したい？ <code>good first issue</code> を選んでPRを送信
+</div>
+
+---
+
+## 📄 ライセンス
+
+<div align="center">
+  <a href="LICENSE">Apache License 2.0</a> — 自由に使用、変更、配布可能。
+</div>
+
+---
+
+<div align="center">
+  <strong>AIツールは来ては去る。あなたのプロジェクトの知識は残る。</strong><br/>
+  <sub><a href="https://github.com/itsvinsoni">@itsvinsoni</a> が ❤️ を込めて構築 &nbsp;·&nbsp; <a href="https://fivo.live">Fivo</a>エコシステムの一部</sub>
+</div>