@pcircle/memesh 2.9.2 → 2.9.4

package/README.ja.md

@@ -1,60 +1,89 @@
 <div align="center">
 
-# 🧠 MeMesh Plugin
+<img src="https://img.shields.io/badge/%F0%9F%A7%A0-MeMesh-blueviolet?style=for-the-badge" alt="MeMesh" />
 
-### Claude Code の生産性プラグイン
+# MeMesh
 
-メモリ、スマートタスク分析、ワークフロー自動化 — ひとつのプラグインで。
+### あなたの AI コーディングセッションにはメモリが必要です。
 
-[![npm version](https://img.shields.io/npm/v/@pcircle/memesh)](https://www.npmjs.com/package/@pcircle/memesh)
-[![License](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE)
-[![MCP](https://img.shields.io/badge/MCP-compatible-purple.svg)](https://modelcontextprotocol.io)
+MeMesh は Claude Code に永続的で検索可能なメモリを提供し、すべてのセッションが前回の続きから始まります。
 
-[インストール](#インストール) • [使い方](#使い方) • [トラブルシューティング](#トラブルシューティング)
+[![npm version](https://img.shields.io/npm/v/@pcircle/memesh?style=flat-square&color=cb3837)](https://www.npmjs.com/package/@pcircle/memesh)
+[![Downloads](https://img.shields.io/npm/dm/@pcircle/memesh?style=flat-square&color=blue)](https://www.npmjs.com/package/@pcircle/memesh)
+[![License](https://img.shields.io/badge/license-MIT-green?style=flat-square)](LICENSE)
+[![Node](https://img.shields.io/badge/node-%3E%3D20-brightgreen?style=flat-square)](https://nodejs.org)
+[![MCP](https://img.shields.io/badge/MCP-compatible-purple?style=flat-square)](https://modelcontextprotocol.io)
 
-[English](README.md) • [繁體中文](README.zh-TW.md) • [简体中文](README.zh-CN.md) • **日本語** • [한국어](README.ko.md) • [Français](README.fr.md) • [Deutsch](README.de.md) • [Español](README.es.md) • [Tiếng Việt](README.vi.md) • [ภาษาไทย](README.th.md) • [Bahasa Indonesia](README.id.md)
+```bash
+npm install -g @pcircle/memesh
+```
+
+[はじめに](#はじめに) · [仕組み](#仕組み) · [コマンド](#コマンド) · [ドキュメント](docs/USER_GUIDE.md)
+
+[English](README.md) · [繁體中文](README.zh-TW.md) · [简体中文](README.zh-CN.md) · **日本語** · [한국어](README.ko.md) · [Français](README.fr.md) · [Deutsch](README.de.md) · [Español](README.es.md) · [Tiếng Việt](README.vi.md) · [ภาษาไทย](README.th.md) · [Bahasa Indonesia](README.id.md)
 
 </div>
 
+> **注意**：このプロジェクトは元々「Claude Code Buddy」という名前でしたが、商標上の問題を避けるため MeMesh Plugin に改名されました。
+
+---
+
+## 問題
+
+Claude Code でプロジェクトに深く取り組んでいるとき、3 セッション前に重要な決定をしたはずです — どの認証ライブラリを使うか、なぜそのデータベーススキーマを選んだか、どのパターンに従うか。しかし Claude は覚えていません。同じ説明を繰り返し、コンテキストを失い、時間を無駄にします。
+
+**MeMesh がこれを解決します。** プロジェクトと共に成長する、永続的で検索可能なメモリを Claude に提供します。
+
 ---
 
-## なぜこのプロジェクトを作ったのか
+## 仕組み
 
-Claude Code が大好きです。ソフトウェアの作り方が変わりました。
+<table>
+<tr>
+<td width="50%">
 
-このプロジェクトは、もっと多くの人 — 特にコーディング初心者の方々 — が Claude Code を使った vibe coding をもっと楽しめるようにしたいと思って始めました。プロジェクトが大きくなると、セッションをまたいだ決定事項を追跡するのが難しくなります。そこで（もちろん Claude Code と一緒に）記憶してくれるプラグインを作りました。
+### MeMesh 導入前
+```
+セッション 1: 「認証には JWT を使おう」
+セッション 2: 「なぜ JWT にしたんだっけ？」
+セッション 3: 「え、どの認証ライブラリ使ってるの？」
+```
+決定を繰り返す。Claude はコンテキストを忘れる。進捗が止まる。
 
-> **注**: このプロジェクトは元々「Claude Code Buddy」という名前でしたが、商標問題を避けるため MeMesh Plugin に改名しました。
+</td>
+<td width="50%">
 
-## 何ができるの？
+### MeMesh 導入後
+```
+セッション 1: 「認証には JWT を使おう」→ 保存済み
+セッション 2: buddy-remember "auth" → 即座に呼び出し
+セッション 3: 開始時にコンテキスト自動読み込み
+```
+すべてのセッションが前回の続きから始まります。
 
-MeMesh Plugin は Claude Code をよりスマートで生産的にします。メモリだけではなく、フルツールキットです：
+</td>
+</tr>
+</table>
 
-**検索可能なプロジェクトメモリ** — 作業中に決定、パターン、教訓を自動保存。意味で検索できます。「認証についてどう決めたっけ？」と聞けば即座に回答。
+---
 
-**スマートタスク分析** — `buddy-do "ユーザー認証を追加"` と言うと、MeMesh がタスクを分析し、過去の作業からコンテキストを引き出し、実行前に充実したプランを提供します。
+## できること
 
-**ワークフロー自動化** — MeMesh がバックグラウンドで自動的に：
-- セッション開始時に前回の作業サマリーを表示
-- 変更・テストしたファイルを追跡
-- コミット前にコードレビューをリマインド
-- タスクを最適なモデルに振り分け
+**検索可能なプロジェクトメモリ** — 「認証についてどう決めた？」と聞けば、意味に基づいて即座にマッチした回答が返ります。キーワード検索ではなく、ローカル ONNX 埋め込みによる*意味*検索です。
 
-**ミスから学ぶ** — エラーと修正を記録し、同じ失敗を繰り返さないナレッジベースを構築。
+**スマートタスク分析** — `buddy-do "ユーザー認証を追加"` はただ実行するだけではありません。過去のセッションから関連コンテキストを引き出し、確立されたパターンを確認し、一行のコードを書く前に充実したプランを構築します。
 
-**Claude の内蔵メモリとの違いは？**
+**プロアクティブな呼び出し** — MeMesh はセッション開始時、テスト失敗時、エラー発生時に関連するメモリを自動的に表示します。手動検索は不要です。
 
-Claude Code には auto memory と CLAUDE.md がすでにあります — 一般的な設定や指示には最適です。MeMesh はそれに加えてプロジェクトレベルの**専用ツール**を追加します：意味で検索できるメモリ、過去のコンテキストを活用するタスク分析、毎セッションをより生産的にする自動化ワークフロー。
+**ワークフロー自動化** — 起動時のセッション要約。ファイル変更の追跡。コミット前のコードレビューリマインダー。すべてバックグラウンドで静かに動作します。
 
-こう考えてください：
-- **CLAUDE.md** = Claude への取扱説明書
-- **MeMesh** = 検索可能なノートブック + プロジェクトと共に成長するスマートアシスタント
+**ミスから学ぶ** — エラーと修正を記録してナレッジベースを構築。同じミスを二度と繰り返しません。
 
 ---
 
-## インストール
+## はじめに
 
-**必要なもの**: [Claude Code](https://docs.anthropic.com/en/docs/claude-code) と Node.js 20+
+**必要なもの**: [Claude Code](https://docs.anthropic.com/en/docs/claude-code) + Node.js 20+
 
 ```bash
 npm install -g @pcircle/memesh
@@ -68,10 +97,10 @@ Claude Code を再起動すれば完了です。
 buddy-help
 ```
 
-コマンド一覧が表示されれば成功です。
+利用可能なコマンドの一覧が表示されます。
 
 <details>
-<summary>ソースからインストール（コントリビューター向け）</summary>
+<summary><strong>ソースからインストール</strong>（コントリビューター向け）</summary>
 
 ```bash
 git clone https://github.com/PCIRCLE-AI/claude-code-buddy.git
@@ -83,9 +112,7 @@ npm install && npm run build
 
 ---
 
-## 使い方
-
-MeMesh は Claude Code に 3 つのコマンドを追加します：
+## コマンド
 
 | コマンド | 機能 |
 |---------|------|
@@ -93,66 +120,80 @@ MeMesh は Claude Code に 3 つのコマンドを追加します：
 | `buddy-remember "トピック"` | 過去の決定やコンテキストを検索 |
 | `buddy-help` | 利用可能なコマンドを表示 |
 
-**例：**
+**実際の例：**
 
 ```bash
-buddy-do "このコードベースを説明して"
-buddy-do "ユーザー認証を追加して"
-buddy-remember "API 設計の決定事項"
-buddy-remember "なぜ PostgreSQL を選んだのか"
+# 初めてのコードベースを理解する
+buddy-do "explain this codebase"
+
+# 過去の作業のコンテキストを活用して機能を構築
+buddy-do "add user authentication"
+
+# なぜその決定をしたか思い出す
+buddy-remember "API design decisions"
+buddy-remember "why we chose PostgreSQL"
 ```
 
 すべてのデータはローカルマシンに保存されます。決定事項は 90 日間、セッションノートは 30 日間保持されます。
 
 ---
 
+## CLAUDE.md との違いは？
+
+| | CLAUDE.md | MeMesh |
+|---|-----------|--------|
+| **目的** | Claude への静的な指示 | プロジェクトと共に成長する生きたメモリ |
+| **検索** | 手動テキスト検索 | 意味に基づくセマンティック検索 |
+| **更新** | 手動で編集 | 作業中に決定事項を自動キャプチャ |
+| **呼び出し** | 常に読み込み（長くなりがち） | 必要に応じて関連コンテキストを表示 |
+| **範囲** | 一般的な設定 | プロジェクト固有のナレッジグラフ |
+
+**両方を併用できます。** CLAUDE.md は Claude に*どう*作業するかを伝えます。MeMesh は*何を*構築したかを記憶します。
+
+---
+
 ## 対応環境
 
 | プラットフォーム | 状態 |
 |----------------|------|
-| **macOS** | ✅ 対応 |
-| **Linux** | ✅ 対応 |
-| **Windows** | ✅ 対応（WSL2 推奨）|
-
-**対応ツール：**
-- Claude Code CLI（ターミナル）
-- Claude Code VS Code 拡張機能
-- Cursor（MCP 経由）
-- その他 MCP 互換エディタ
+| macOS | ✅ |
+| Linux | ✅ |
+| Windows | ✅（WSL2 推奨） |
 
-**Claude Desktop (Cowork)**: 基本コマンドは動作しますが、メモリ機能には CLI 版が必要です。[Cowork 詳細](docs/COWORK_SUPPORT.md)をご覧ください。
+**対応ツール：** Claude Code CLI · VS Code 拡張機能 · Cursor（MCP 経由） · その他 MCP 互換エディタ
 
 ---
 
-## トラブルシューティング
+## アーキテクチャ
 
-**MeMesh が表示されない？**
+MeMesh は Claude Code と並行してローカル MCP サーバーとして動作します：
 
-```bash
-# インストール確認
-npm list -g @pcircle/memesh
+- **ナレッジグラフ** — FTS5 全文検索を備えた SQLite ベースのエンティティストア
+- **ベクトル埋め込み** — セマンティック類似性のための ONNX ランタイム（100% ローカルで動作）
+- **コンテンツ重複排除** — SHA-256 ハッシュで冗長な埋め込み計算をスキップ
+- **バッチ処理** — 大規模ナレッジベース向けの効率的な一括操作
+- **フックシステム** — セッション開始時、テスト失敗時、エラー発生時のプロアクティブな呼び出し
 
-# Node.js バージョン確認（20+ が必要）
-node --version
+すべてローカルで動作します。クラウドなし。API コールなし。データがマシンの外に出ることはありません。
 
-# セットアップ再実行
-memesh setup
-```
+---
 
-その後、Claude Code を完全に再起動してください。
+## ドキュメント
 
-詳細：[トラブルシューティングガイド](docs/TROUBLESHOOTING.md)
+| ドキュメント | 説明 |
+|------------|------|
+| [はじめに](docs/GETTING_STARTED.md) | ステップバイステップのセットアップガイド |
+| [ユーザーガイド](docs/USER_GUIDE.md) | 例付きの完全な使い方ガイド |
+| [コマンド](docs/COMMANDS.md) | コマンドリファレンス |
+| [アーキテクチャ](docs/ARCHITECTURE.md) | 技術的な詳細解説 |
+| [コントリビュート](CONTRIBUTING.md) | 貢献ガイドライン |
+| [開発ガイド](docs/DEVELOPMENT.md) | コントリビューター向けの開発環境構築 |
 
 ---
 
-## もっと詳しく
+## コントリビュート
 
-- **[はじめに](docs/GETTING_STARTED.md)** — ステップバイステップのセットアップ
-- **[ユーザーガイド](docs/USER_GUIDE.md)** — 例付きの完全ガイド
-- **[コマンド](docs/COMMANDS.md)** — すべてのコマンド
-- **[アーキテクチャ](docs/ARCHITECTURE.md)** — 内部の仕組み
-- **[コントリビュート](CONTRIBUTING.md)** — 手伝いたい方はこちら
-- **[開発ガイド](docs/DEVELOPMENT.md)** — コントリビューター向け
+コントリビューションを歓迎します！[CONTRIBUTING.md](CONTRIBUTING.md) をご覧ください。
 
 ---
 
@@ -164,8 +205,8 @@ MIT — [LICENSE](LICENSE) を参照
 
 <div align="center">
 
-うまくいかない？ [Issue を開く](https://github.com/PCIRCLE-AI/claude-code-buddy/issues/new) — 迅速に対応します。
+**Claude Code で作られた、Claude Code のためのツール。**
 
-[バグ報告](https://github.com/PCIRCLE-AI/claude-code-buddy/issues/new?labels=bug&template=bug_report.yml) • [機能リクエスト](https://github.com/PCIRCLE-AI/claude-code-buddy/discussions)
+[バグ報告](https://github.com/PCIRCLE-AI/claude-code-buddy/issues/new?labels=bug&template=bug_report.yml) · [機能リクエスト](https://github.com/PCIRCLE-AI/claude-code-buddy/discussions) · [ヘルプ](https://github.com/PCIRCLE-AI/claude-code-buddy/issues/new)
 
 </div>

package/README.ko.md

@@ -1,77 +1,106 @@
 <div align="center">
 
-# 🧠 MeMesh Plugin
+<img src="https://img.shields.io/badge/%F0%9F%A7%A0-MeMesh-blueviolet?style=for-the-badge" alt="MeMesh" />
 
-### Claude Code 생산성 플러그인
+# MeMesh
 
-메모리, 스마트 작업 분석, 워크플로우 자동화 — 하나의 플러그인으로.
+### AI 코딩 세션에도 기억이 필요합니다.
 
-[![npm version](https://img.shields.io/npm/v/@pcircle/memesh)](https://www.npmjs.com/package/@pcircle/memesh)
-[![License](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE)
-[![MCP](https://img.shields.io/badge/MCP-compatible-purple.svg)](https://modelcontextprotocol.io)
+MeMesh는 Claude Code에 영구적이고 검색 가능한 메모리를 제공하여, 모든 세션이 이전 세션 위에 쌓이도록 합니다.
 
-[설치](#설치) • [사용법](#사용법) • [문제 해결](#문제-해결)
+[![npm version](https://img.shields.io/npm/v/@pcircle/memesh?style=flat-square&color=cb3837)](https://www.npmjs.com/package/@pcircle/memesh)
+[![Downloads](https://img.shields.io/npm/dm/@pcircle/memesh?style=flat-square&color=blue)](https://www.npmjs.com/package/@pcircle/memesh)
+[![License](https://img.shields.io/badge/license-MIT-green?style=flat-square)](LICENSE)
+[![Node](https://img.shields.io/badge/node-%3E%3D20-brightgreen?style=flat-square)](https://nodejs.org)
+[![MCP](https://img.shields.io/badge/MCP-compatible-purple?style=flat-square)](https://modelcontextprotocol.io)
 
-[English](README.md) • [繁體中文](README.zh-TW.md) • [简体中文](README.zh-CN.md) • [日本語](README.ja.md) • **한국어** • [Français](README.fr.md) • [Deutsch](README.de.md) • [Español](README.es.md) • [Tiếng Việt](README.vi.md) • [ภาษาไทย](README.th.md) • [Bahasa Indonesia](README.id.md)
+```bash
+npm install -g @pcircle/memesh
+```
+
+[시작하기](#시작하기) · [작동 방식](#작동-방식) · [명령어](#명령어) · [문서](docs/USER_GUIDE.md)
+
+[English](README.md) · [繁體中文](README.zh-TW.md) · [简体中文](README.zh-CN.md) · [日本語](README.ja.md) · **한국어** · [Français](README.fr.md) · [Deutsch](README.de.md) · [Español](README.es.md) · [Tiếng Việt](README.vi.md) · [ภาษาไทย](README.th.md) · [Bahasa Indonesia](README.id.md)
 
 </div>
 
+> **참고**: 이 프로젝트는 원래 "Claude Code Buddy"라는 이름이었으며, 잠재적인 상표 문제를 피하기 위해 MeMesh Plugin으로 이름이 변경되었습니다.
+
 ---
 
-## 왜 이 프로젝트를 만들었나
+## 문제점
 
-Claude Code를 정말 좋아합니다. 소프트웨어를 만드는 방식이 완전히 바뀌었습니다.
+Claude Code로 프로젝트를 깊이 진행하고 있습니다. 세 번 전 세션에서 중요한 결정을 내렸습니다 — 어떤 인증 라이브러리를 쓸지, 왜 그 데이터베이스 스키마를 선택했는지, 어떤 패턴을 따를지. 하지만 Claude는 기억하지 못합니다. 같은 말을 반복하고, 컨텍스트를 잃고, 시간을 낭비합니다.
 
-이 프로젝트는 더 많은 사람들 — 특히 코딩을 처음 접하는 분들 — 이 Claude Code로 vibe coding을 더 잘 활용할 수 있도록 돕고 싶어서 시작했습니다. 프로젝트가 커지면 세션을 넘나드는 모든 결정을 추적하기 어려워진다는 걸 깨달았습니다. 그래서 (당연히 Claude Code와 함께) 여러분을 위해 기억해주는 플러그인을 만들었습니다.
+**MeMesh가 이 문제를 해결합니다.** 프로젝트와 함께 성장하는 영구적이고 검색 가능한 메모리를 Claude에게 제공합니다.
 
-> **참고**: 이 프로젝트는 원래 "Claude Code Buddy"라는 이름이었으며, 상표 문제를 피하기 위해 MeMesh Plugin으로 이름을 변경했습니다.
+---
 
-## 무엇을 할 수 있나요?
+## 작동 방식
 
-MeMesh Plugin은 Claude Code를 더 똑똑하고 생산적으로 만듭니다. 단순한 메모리가 아닌 풀 툴킷입니다:
+<table>
+<tr>
+<td width="50%">
 
-**검색 가능한 프로젝트 메모리** — 작업 중 결정, 패턴, 교훈을 자동 저장. 의미로 검색 가능. "auth에 대해 뭘 결정했지?"라고 물으면 즉시 답변.
+### MeMesh 이전
+```
+Session 1: "JWT로 인증하자"
+Session 2: "왜 JWT를 선택했었지?"
+Session 3: "잠깐, 어떤 인증 라이브러리 쓰고 있었지?"
+```
+결정을 반복합니다. Claude가 컨텍스트를 잊습니다. 진행이 멈춥니다.
+
+</td>
+<td width="50%">
 
-**스마트 작업 분석** — `buddy-do "사용자 인증 추가"` 라고 하면, MeMesh가 작업을 분석하고 과거 작업에서 컨텍스트를 가져와 실행 전에 풍부한 계획을 제공합니다.
+### MeMesh 이후
+```
+Session 1: "JWT로 인증하자" → 저장됨
+Session 2: buddy-remember "auth" → 즉시 회상
+Session 3: 시작 시 컨텍스트 자동 로드
+```
+모든 세션이 이전에 멈춘 곳에서 이어집니다.
+
+</td>
+</tr>
+</table>
+
+---
 
-**워크플로우 자동화** — MeMesh가 백그라운드에서 자동으로:
-- 세션 시작 시 지난 작업 요약 표시
-- 변경/테스트한 파일 추적
-- 커밋 전 코드 리뷰 알림
-- 작업을 최적의 모델로 라우팅
+## 제공하는 기능
 
-**실수에서 배우기** — 오류와 수정 사항을 기록하여 같은 실수를 반복하지 않는 지식 베이스 구축.
+**검색 가능한 프로젝트 메모리** — "auth에 대해 뭘 결정했지?"라고 물으면 의미 기반으로 즉시 매칭된 답변을 받습니다. 키워드 검색이 아닌 *의미* 검색이며, 로컬 ONNX 임베딩으로 작동합니다.
 
-**Claude 내장 메모리와 뭐가 다른가요?**
+**스마트 작업 분석** — `buddy-do "add user auth"`는 단순히 실행만 하지 않습니다. 과거 세션에서 관련 컨텍스트를 가져오고, 수립된 패턴을 확인하고, 코드를 한 줄이라도 작성하기 전에 풍부한 계획을 세웁니다.
 
-Claude Code에는 이미 auto memory와 CLAUDE.md가 있습니다 — 일반적인 설정과 지시에 적합합니다. MeMesh는 여기에 프로젝트 수준의 **전용 도구**를 추가합니다: 의미로 검색할 수 있는 메모리, 과거 컨텍스트를 활용하는 작업 분석, 매 세션을 더 생산적으로 만드는 자동화 워크플로우.
+**선제적 회상** — MeMesh는 세션 시작 시, 테스트 실패 시, 오류 발생 시 관련 기억을 자동으로 표시합니다. 수동 검색이 필요 없습니다.
 
-이렇게 생각하세요:
-- **CLAUDE.md** = Claude를 위한 사용 설명서
-- **MeMesh** = 검색 가능한 노트북 + 프로젝트와 함께 성장하는 스마트 어시스턴트
+**워크플로우 자동화** — 시작 시 세션 요약. 파일 변경 추적. 커밋 전 코드 리뷰 알림. 모두 백그라운드에서 조용히 실행됩니다.
+
+**실수 학습** — 오류와 수정 사항을 기록하여 지식 베이스를 구축합니다. 같은 실수는 두 번 일어나지 않습니다.
 
 ---
 
-## 설치
+## 시작하기
 
-**필요한 것**: [Claude Code](https://docs.anthropic.com/en/docs/claude-code)와 Node.js 20+
+**필요 조건**: [Claude Code](https://docs.anthropic.com/en/docs/claude-code) + Node.js 20+
 
 ```bash
 npm install -g @pcircle/memesh
 ```
 
-Claude Code를 재시작하면 끝.
+Claude Code를 재시작하면 끝입니다.
 
-**작동 확인** — Claude Code에서 입력:
+**확인** — Claude Code에서 입력:
 
 ```
 buddy-help
 ```
 
-명령어 목록이 보이면 성공입니다.
+사용 가능한 명령어 목록이 표시되어야 합니다.
 
 <details>
-<summary>소스에서 설치 (기여자용)</summary>
+<summary><strong>소스에서 설치</strong> (기여자용)</summary>
 
 ```bash
 git clone https://github.com/PCIRCLE-AI/claude-code-buddy.git
@@ -83,76 +112,88 @@ npm install && npm run build
 
 ---
 
-## 사용법
-
-MeMesh는 Claude Code에 3개의 명령어를 추가합니다:
+## 명령어
 
 | 명령어 | 기능 |
-|--------|------|
-| `buddy-do "작업"` | 메모리 컨텍스트와 함께 작업 실행 |
+|---------|------|
+| `buddy-do "작업"` | 전체 메모리 컨텍스트와 함께 작업 실행 |
 | `buddy-remember "주제"` | 과거 결정과 컨텍스트 검색 |
 | `buddy-help` | 사용 가능한 명령어 표시 |
 
-**예시:**
+**실제 사용 예시:**
 
 ```bash
-buddy-do "이 코드베이스 설명해줘"
-buddy-do "사용자 인증 추가해줘"
-buddy-remember "API 설계 결정사항"
-buddy-remember "왜 PostgreSQL을 선택했는지"
+# 처음 접하는 코드베이스 파악하기
+buddy-do "explain this codebase"
+
+# 과거 작업의 컨텍스트로 기능 구현하기
+buddy-do "add user authentication"
+
+# 결정 이유 회상하기
+buddy-remember "API design decisions"
+buddy-remember "why we chose PostgreSQL"
 ```
 
 모든 데이터는 로컬 머신에 저장됩니다. 결정사항은 90일, 세션 노트는 30일간 보관됩니다.
 
 ---
 
-## 지원 환경
+## CLAUDE.md와 어떻게 다른가요?
+
+| | CLAUDE.md | MeMesh |
+|---|-----------|--------|
+| **목적** | Claude를 위한 고정된 지시사항 | 프로젝트와 함께 성장하는 살아있는 메모리 |
+| **검색** | 수동 텍스트 검색 | 의미 기반 검색 |
+| **업데이트** | 수동 편집 | 작업하면서 결정사항을 자동 캡처 |
+| **회상** | 항상 로드됨 (길어질 수 있음) | 필요할 때 관련 컨텍스트를 표시 |
+| **범위** | 일반적인 설정 | 프로젝트별 지식 그래프 |
+
+**함께 사용하는 것입니다.** CLAUDE.md는 Claude에게 *어떻게* 작업할지 알려줍니다. MeMesh는 *무엇을* 만들었는지 기억합니다.
+
+---
+
+## 플랫폼 지원
 
 | 플랫폼 | 상태 |
 |--------|------|
-| **macOS** | ✅ 지원 |
-| **Linux** | ✅ 지원 |
-| **Windows** | ✅ 지원 (WSL2 권장) |
-
-**함께 사용 가능:**
-- Claude Code CLI (터미널)
-- Claude Code VS Code 확장
-- Cursor (MCP 경유)
-- 기타 MCP 호환 에디터
+| macOS | ✅ |
+| Linux | ✅ |
+| Windows | ✅ (WSL2 권장) |
 
-**Claude Desktop (Cowork)**: 기본 명령어는 작동하지만, 메모리 기능은 CLI 버전이 필요합니다. [Cowork 상세](docs/COWORK_SUPPORT.md)를 참고하세요.
+**호환 환경:** Claude Code CLI · VS Code Extension · Cursor (MCP 경유) · 기타 MCP 호환 에디터
 
 ---
 
-## 문제 해결
+## 아키텍처
 
-**MeMesh가 나타나지 않나요?**
+MeMesh는 Claude Code와 함께 로컬 MCP 서버로 실행됩니다:
 
-```bash
-# 설치 확인
-npm list -g @pcircle/memesh
+- **Knowledge Graph** — FTS5 전문 검색을 갖춘 SQLite 기반 엔티티 저장소
+- **Vector Embeddings** — 의미 유사도를 위한 ONNX 런타임 (100% 로컬 실행)
+- **Content Dedup** — SHA-256 해싱으로 중복 임베딩 연산 건너뛰기
+- **Batch Processing** — 대규모 지식 베이스를 위한 효율적인 일괄 처리
+- **Hook System** — 세션 시작, 테스트 실패, 오류 시 선제적 회상
 
-# Node.js 버전 확인 (20+ 필요)
-node --version
+모든 것이 로컬에서 실행됩니다. 클라우드 없음. API 호출 없음. 데이터는 절대 머신 밖으로 나가지 않습니다.
 
-# 설정 다시 실행
-memesh setup
-```
+---
 
-그런 다음 Claude Code를 완전히 재시작하세요.
+## 문서
 
-추가 도움: [문제 해결 가이드](docs/TROUBLESHOOTING.md)
+| 문서 | 설명 |
+|------|------|
+| [시작하기](docs/GETTING_STARTED.md) | 단계별 설정 가이드 |
+| [사용자 가이드](docs/USER_GUIDE.md) | 예제 포함 전체 사용 가이드 |
+| [명령어](docs/COMMANDS.md) | 전체 명령어 레퍼런스 |
+| [아키텍처](docs/ARCHITECTURE.md) | 기술 심층 분석 |
+| [기여하기](CONTRIBUTING.md) | 기여 가이드라인 |
+| [개발](docs/DEVELOPMENT.md) | 기여자를 위한 개발 환경 설정 |
 
 ---
 
-## 더 알아보기
+## 기여하기
 
-- **[시작하기](docs/GETTING_STARTED.md)** — 단계별 설정
-- **[사용자 가이드](docs/USER_GUIDE.md)** — 예제 포함 전체 가이드
-- **[명령어](docs/COMMANDS.md)** — 모든 사용 가능한 명령어
-- **[아키텍처](docs/ARCHITECTURE.md)** — 내부 작동 원리
-- **[기여하기](CONTRIBUTING.md)** — 도와주고 싶다면? 여기서 시작
-- **[개발 가이드](docs/DEVELOPMENT.md)** — 기여자용
+기여를 환영합니다! 시작하려면 [CONTRIBUTING.md](CONTRIBUTING.md)를 참고하세요.
 
 ---
 
@@ -164,8 +205,8 @@ MIT — [LICENSE](LICENSE) 참조
 
 <div align="center">
 
-문제가 있나요? [이슈 열기](https://github.com/PCIRCLE-AI/claude-code-buddy/issues/new) — 빠르게 응답합니다.
+**Claude Code를 위해, Claude Code와 함께 만들었습니다.**
 
-[버그 리포트](https://github.com/PCIRCLE-AI/claude-code-buddy/issues/new?labels=bug&template=bug_report.yml) • [기능 요청](https://github.com/PCIRCLE-AI/claude-code-buddy/discussions)
+[버그 리포트](https://github.com/PCIRCLE-AI/claude-code-buddy/issues/new?labels=bug&template=bug_report.yml) · [기능 요청](https://github.com/PCIRCLE-AI/claude-code-buddy/discussions) · [도움 받기](https://github.com/PCIRCLE-AI/claude-code-buddy/issues/new)
 
 </div>