agestra 4.3.5 → 4.4.0

package/.claude-plugin/marketplace.json

@@ -1,27 +1,40 @@
-{
-  "name": "agestra",
-  "owner": {
-    "name": "mua-vtuber"
-  },
-  "metadata": {
-    "description": "Multi-AI orchestration plugin for Claude Code",
-    "version": "1.0.0"
-  },
-  "plugins": [
-    {
-      "name": "agestra",
-      "source": "./",
-      "description": "Orchestrate Ollama, Gemini, and Codex for multi-AI debates, cross-validation, and GraphRAG memory",
-      "version": "4.3.5",
-      "author": {
-        "name": "mua-vtuber"
-      },
-      "homepage": "https://github.com/mua-vtuber/Agestra",
-      "repository": "https://github.com/mua-vtuber/Agestra",
-      "license": "GPL-3.0-only",
-      "keywords": ["claude-code-plugin", "mcp", "multi-ai", "ollama", "gemini", "codex", "ai-orchestration"],
-      "category": "external-integrations",
-      "tags": ["orchestration", "debate", "memory", "graphrag"]
-    }
-  ]
-}
+{
+  "name": "agestra",
+  "owner": {
+    "name": "mua-vtuber"
+  },
+  "metadata": {
+    "description": "Multi-AI orchestration plugin for Claude Code",
+    "version": "1.0.0"
+  },
+  "plugins": [
+    {
+      "name": "agestra",
+      "source": "./",
+      "description": "Orchestrate Ollama, Gemini, and Codex for multi-AI debates, cross-validation, and GraphRAG memory",
+      "version": "4.4.0",
+      "author": {
+        "name": "mua-vtuber"
+      },
+      "homepage": "https://github.com/mua-vtuber/Agestra",
+      "repository": "https://github.com/mua-vtuber/Agestra",
+      "license": "GPL-3.0-only",
+      "keywords": [
+        "claude-code-plugin",
+        "mcp",
+        "multi-ai",
+        "ollama",
+        "gemini",
+        "codex",
+        "ai-orchestration"
+      ],
+      "category": "external-integrations",
+      "tags": [
+        "orchestration",
+        "debate",
+        "memory",
+        "graphrag"
+      ]
+    }
+  ]
+}

package/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "agestra",
-  "version": "4.3.5",
+  "version": "4.4.0",
   "description": "Claude Code plugin — orchestrate Ollama, Gemini, and Codex for multi-AI debates, cross-validation, and GraphRAG memory",
   "mcpServers": {
     "agestra": {
@@ -9,5 +9,17 @@
         "${CLAUDE_PLUGIN_ROOT}/dist/bundle.js"
       ]
     }
+  },
+  "hooks": {
+    "UserPromptSubmit": [
+      {
+        "hooks": [
+          {
+            "type": "command",
+            "command": "node ${CLAUDE_PLUGIN_ROOT}/hooks/user-prompt-submit.js"
+          }
+        ]
+      }
+    ]
   }
 }

package/README.ja.md

@@ -0,0 +1,328 @@
+# Agestra
+
+[![npm version](https://img.shields.io/npm/v/agestra.svg)](https://www.npmjs.com/package/agestra)
+[![license](https://img.shields.io/npm/l/agestra.svg)](LICENSE)
+
+**Agent + Orchestra** — Claude Code 上で複数の AI プロバイダーをオーケストレーションするプラグイン。
+
+[English](README.md) | [한국어](README.ko.md) | [日本語](README.ja.md) | [中文](README.zh.md)
+
+Agestra は Ollama（ローカル）、Gemini CLI、Codex CLI を Claude Code にプラガブルなプロバイダーとして接続し、独立集約、合意形成ディベート、自律 CLI ワーカー、並列タスク配分、クロスバリデーション、品質ベースのプロバイダー選択、永続的な GraphRAG メモリを 42 個の MCP ツールで提供します。
+
+## クイックスタート
+
+Claude Code で次を実行します:
+
+```
+/plugin marketplace add mua-vtuber/Agestra
+/plugin install agestra@agestra
+```
+
+これだけです。Agestra は初回利用時に `environment_check` を通じて利用可能なプロバイダー（Ollama、Gemini CLI、Codex CLI）を自動検出します。
+
+### 前提条件
+
+少なくとも 1 つの AI プロバイダーをインストールしておく必要があります:
+
+| プロバイダー | インストール | 種類 |
+|-------------|---------------|------|
+| [Ollama](https://ollama.com/) | `curl -fsSL https://ollama.com/install.sh \| sh` | Local LLM |
+| [Gemini CLI](https://github.com/google-gemini/gemini-cli) | `npm install -g @google/gemini-cli` | Cloud |
+| [Codex CLI](https://github.com/openai/codex) | `npm install -g @openai/codex` | Cloud |
+
+任意ですが推奨:
+- **tmux** — 自律実行中の CLI ワーカーペインを可視化できます
+
+---
+
+## 理念
+
+**Multi-AI はトークン節約のためではなく、検証のために使います。** レビュー、設計探索、アイデア創出のワークフローは、速度のための並列化ではなく、複数の AI プロバイダーから独立した視点を集めて見落としを防ぐ検証プロセスとして設計されています。
+
+## コマンド
+
+| コマンド | 説明 |
+|----------|------|
+| `/agestra review [target]` | コード品質、セキュリティ、統合の完成度をレビュー |
+| `/agestra idea [topic]` | 類似プロジェクトとの比較から改善案を発見 |
+| `/agestra design [subject]` | 実装前にアーキテクチャと設計上のトレードオフを探索 |
+| `/agestra implement [task]` | Claude only または Multi-AI モードで実装を進める |
+
+各コマンドでは次のモードを選べます:
+
+| モード | 説明 |
+|--------|------|
+| **Claude only** | プラグインの専門エージェントが単独で作業 |
+| **각자 독립** (Independent) | 各 AI が独立して作業し、モデレーターが統合ドキュメントに集約 |
+| **끝장토론** (Debate) | 独立作業 + ドキュメントレビューを繰り返し、全 AI が合意するまで続行 |
+
+## エージェント
+
+| エージェント | モデル | 役割 |
+|--------------|--------|------|
+| `agestra-team-lead` | Sonnet | フルオーケストレーター — 環境チェック、品質ベースのプロバイダー選択、作業モード選定、CLI ワーカー監督、QA ループ |
+| `agestra-reviewer` | Opus | 厳格な品質検証役 — セキュリティ、孤立コード、仕様逸脱、テスト不足を確認 |
+| `agestra-designer` | Opus | アーキテクチャ探索役 — ソクラテス式質問、トレードオフ分析 |
+| `agestra-ideator` | Sonnet | 改善案発見役 — Web 調査、競合分析 |
+| `agestra-moderator` | Sonnet | マルチモード進行役 — 合意検出付きディベート、独立集約、ドキュメントレビュー、衝突解決 |
+| `agestra-qa` | Opus | QA 検証役 — 設計準拠の確認、PASS/FAIL 判定 |
+
+## スキル
+
+| スキル | 説明 |
+|--------|------|
+| `provider-guide` | プロバイダー選択、モード参照、オーケストレーションパイプライン |
+| `worker-manage` | CLI ワーカーの一覧、状態確認、結果回収、停止 |
+| `cancel` | ワーカー、ディベート、チェーン、タスクの安全な停止 |
+| `build-fix` | build/typecheck/lint エラーの自動診断と修正 |
+| `trace` | エージェント実行タイムラインとフローダイアグラムの表示 |
+| `design` | Multi-AI モード選択を含む設計探索ワークフロー |
+| `idea` | Multi-AI モード選択を含む改善案発見ワークフロー |
+
+---
+
+## アーキテクチャ
+
+Turborepo モノレポで、8 パッケージ構成です:
+
+| パッケージ | 説明 |
+|------------|------|
+| `@agestra/core` | `AIProvider` インターフェース、難易度ベースのルーティングレジストリ、設定ローダー、CLI ランナー、アトミック書き込み、ジョブキュー、シークレットスキャナー、worktree マネージャー、タスクマニフェスト、CLI ワーカーマネージャー |
+| `@agestra/provider-ollama` | モデル検出付き Ollama HTTP アダプター |
+| `@agestra/provider-gemini` | Google Gemini CLI アダプター |
+| `@agestra/provider-codex` | OpenAI Codex CLI アダプター |
+| `@agestra/agents` | 合意検出付きディベートエンジン、ターン品質評価、タスク配分、クロスバリデーション、タスクチェーン、自動 QA、ファイル変更追跡、セッション管理 |
+| `@agestra/workspace` | レビュー、分析メモ、統合レポート向けのワークスペース文書マネージャー |
+| `@agestra/memory` | GraphRAG — FTS5 + ベクトル + ナレッジグラフのハイブリッド検索、行き詰まり追跡 |
+| `@agestra/mcp-server` | MCP プロトコル層、42 ツール、環境依存のツールフィルタリング、ディスパッチ |
+
+### 設計原則
+
+- **Provider abstraction** — すべてのバックエンドは `AIProvider`（`chat`, `healthCheck`, `getCapabilities`）を実装します。新規プロバイダー追加は専用パッケージとファクトリ登録に分離されます。
+- **Zero-config** — プロバイダーは起動時に自動検出されます。手動設定は不要です。
+- **Plugin-native** — Claude Code プラグインとして配布され、Skills、hooks、MCP サーバーがひとまとめになっています。
+- **Modular dispatch** — 各ツールカテゴリは `getTools()` + `handleTool()` を持つ独立モジュールです。サーバーが動的に収集してディスパッチします。
+- **Atomic writes** — すべてのファイル操作は一時ファイルへの書き込み後に rename する方式で、破損を防ぎます。
+- **Dead-end tracking** — 失敗したアプローチは GraphRAG に記録され、今後のプロンプトに注入されます。
+- **Preflight security** — CLI ワーカー起動前にシークレットスキャンと配列ベース引数を使い、インジェクションを防ぎます。
+
+### 作業モード
+
+**Text work**（レビュー、設計、アイデア）: Claude only → 각자 독립 → 끝장토론
+
+**Implementation work**（team-lead orchestration）:
+- **Claude만으로** — Claude がプロジェクト/グローバルエージェントを使って直接実装します。
+- **다른 AI도 함께** — CLI ワーカー（Codex/Gemini）が分離された git worktree で自律的にコーディングし、Ollama が簡単なタスクを担当し、Claude が監督・統合します。
+
+---
+
+## ツール (42)
+
+### AI チャット (3)
+
+| ツール | 説明 |
+|--------|------|
+| `ai_chat` | 特定のプロバイダーと対話（品質ベースのルーティングには `"auto"` を使用）。必要に応じて `save_as_document` で応答を文書保存可能 |
+| `ai_analyze_files` | ディスク上のファイルを読み込み、質問と一緒にプロバイダーへ送信 |
+| `ai_compare` | 同じプロンプトを複数プロバイダーに送り、応答を比較 |
+
+### エージェントオーケストレーション (11)
+
+| ツール | 説明 |
+|--------|------|
+| `agent_debate_start` | 複数プロバイダーによるディベートを開始（非ブロッキング、品質ループ + バリデーターは任意） |
+| `agent_debate_status` | ディベートの状態とトランスクリプトを確認 |
+| `agent_debate_create` | ターン制ディベートセッションを作成（debate ID を返す） |
+| `agent_debate_turn` | 1 プロバイダー分のターンを実行。`provider: "claude"` で Claude の独立参加も可能 |
+| `agent_debate_conclude` | ディベートを終了し、最終トランスクリプトを生成 |
+| `agent_debate_moderate` | 完全自動のディベートを実行。セッション作成、専門エージェントによるラウンド、合意検出を行い、要約のみ返す |
+| `agent_debate_review` | 文書を複数プロバイダーへ送り、独立したレビューを依頼 |
+| `agent_cross_validate` | 出力をクロスバリデーション（agent-tier validators のみ） |
+| `agent_changes_review` | 分離タスクでのファイル変更をレビュー |
+| `agent_changes_accept` | 分離タスクでの変更を受け入れてマージ |
+| `agent_changes_reject` | 変更を却下し、分離 worktree をクリーンアップ |
+
+### CLI ワーカー (4)
+
+| ツール | 説明 |
+|--------|------|
+| `cli_worker_spawn` | CLI AI（Codex/Gemini）を自律モードで起動。git worktree 分離と事前セキュリティチェック付き |
+| `cli_worker_status` | ワーカーの FSM 状態、heartbeat、出力末尾を確認 |
+| `cli_worker_collect` | 完了したワーカーの結果（git diff、出力、終了コード）を回収 |
+| `cli_worker_stop` | 実行中のワーカーを停止（SIGTERM → SIGKILL）し、worktree をクリーンアップ |
+
+### 環境 (1)
+
+| ツール | 説明 |
+|--------|------|
+| `environment_check` | CLI ツール、ティア分類付き Ollama モデル、tmux、git worktree 対応、利用可能モードを検出 |
+
+### ワークスペース (7)
+
+| ツール | 説明 |
+|--------|------|
+| `workspace_create_review` | 対象ファイルとルール付きのコードレビュー文書を作成 |
+| `workspace_request_review` | プロバイダーに文書レビューを依頼 |
+| `workspace_review_status` | レビュー完了状態を確認 |
+| `workspace_add_comment` | レビューにコメントを追加 |
+| `workspace_create_document` | タイトル、Markdown 本文、任意メタデータを持つ汎用ワークスペース文書を作成 |
+| `workspace_read` | 文書内容を読む |
+| `workspace_list` | ワークスペース内のすべての文書を一覧表示 |
+
+### プロバイダー管理 (2)
+
+| ツール | 説明 |
+|--------|------|
+| `provider_list` | 状態と機能付きでプロバイダー一覧を表示 |
+| `provider_health` | 1 つまたはすべてのプロバイダーのヘルスチェック |
+
+### Ollama (2)
+
+| ツール | 説明 |
+|--------|------|
+| `ollama_models` | インストール済みモデルをサイズとティア分類付きで一覧表示 |
+| `ollama_pull` | モデルをダウンロード |
+
+### メモリ (6)
+
+| ツール | 説明 |
+|--------|------|
+| `memory_search` | ハイブリッド検索（FTS5 + ベクトル + グラフ） |
+| `memory_index` | ファイル/ディレクトリをメモリへインデックス |
+| `memory_store` | ナレッジノードを保存（fact、decision、dead_end、finding） |
+| `memory_dead_ends` | 以前の失敗アプローチを検索して繰り返しを防止 |
+| `memory_context` | トークン予算内で関連コンテキストを組み立て |
+| `memory_add_edge` | ナレッジノード間に関係エッジを作成 |
+
+### ジョブ (2)
+
+| ツール | 説明 |
+|--------|------|
+| `cli_job_submit` | 長時間実行する CLI タスクをバックグラウンドに投入 |
+| `cli_job_status` | ジョブの状態と出力を確認 |
+
+### QA (1)
+
+| ツール | 説明 |
+|--------|------|
+| `qa_run` | 検出した build/test コマンドで自動 QA を実行し、PASS/FAIL を要約 |
+
+### トレース / 可観測性 (3)
+
+| ツール | 説明 |
+|--------|------|
+| `trace_query` | trace レコードを条件付きで検索（プロバイダー、タスク、期間） |
+| `trace_summary` | プロバイダー別の品質統計、性能指標、難易度資格を取得 |
+| `trace_visualize` | 追跡した操作フローの Mermaid 図を生成 |
+
+---
+
+## 設定
+
+### providers.config.json (任意)
+
+Agestra は起動時にプロバイダーを自動検出します。手動で制御したい場合は、プロジェクトルートに `providers.config.json` を作成してください:
+
+| 項目 | 説明 |
+|------|------|
+| `defaultProvider` | 未指定時に使うプロバイダー ID |
+| `providers[].id` | 一意の識別子 |
+| `providers[].type` | `ollama`, `gemini-cli`, `codex-cli` |
+| `providers[].enabled` | 起動時に読み込むか |
+| `providers[].config` | タイプ別設定（host、timeout など） |
+
+### ランタイムデータ
+
+`.agestra/` 配下に保存されます（gitignore 対象）:
+
+| パス | 用途 |
+|------|------|
+| `.agestra/sessions/` | ディベートとタスクのセッション状態 |
+| `.agestra/workspace/` | ワークスペース文書（レビュー、メモ、レポート） |
+| `.agestra/memory.db` | GraphRAG SQLite データベース |
+| `.agestra/.jobs/` | バックグラウンドジョブキュー |
+| `.agestra/.workers/` | CLI ワーカー状態、マニフェスト、出力ログ |
+| `.agestra/worktrees/` | 分離 CLI ワーカー実行用 git worktree |
+| `.agestra/traces/` | プロバイダートレース JSONL（30 日後に自動削除） |
+
+---
+
+## 開発
+
+```bash
+npm install        # 依存関係をインストール
+npm run build      # 全パッケージをビルド（Turborepo）
+npm test           # 全テストを実行（Vitest）
+npm run bundle     # 単一ファイルのプラグインバンドルを作成（esbuild）
+npm run dev        # ウォッチモード
+npm run lint       # Lint（ESLint）
+npm run clean      # dist/ を削除
+```
+
+### プロジェクト構成
+
+```
+agestra/
+├── .claude-plugin/
+│   ├── plugin.json          # Claude Code プラグインマニフェスト
+│   └── marketplace.json     # プラグインマーケットプレイスのメタデータ
+├── commands/
+│   ├── review.md            # /agestra review — 品質検証
+│   ├── idea.md              # /agestra idea — 改善案探索
+│   ├── design.md            # /agestra design — アーキテクチャ探索
+│   └── implement.md         # /agestra implement — 実装ワークフロー
+├── agents/
+│   ├── agestra-reviewer.md  # 厳格な品質検証役（Opus）
+│   ├── agestra-designer.md  # アーキテクチャ探索役（Opus）
+│   ├── agestra-ideator.md   # 改善案発見役（Sonnet）
+│   ├── agestra-moderator.md # マルチモード進行役（Sonnet）
+│   ├── agestra-qa.md        # QA 検証役（Opus、コード書き込みなし）
+│   └── agestra-team-lead.md # フルオーケストレーター（Sonnet、コード書き込みなし）
+├── skills/
+│   ├── provider-guide.md    # プロバイダー選択とモード参照
+│   ├── worker-manage.md     # CLI ワーカー管理
+│   ├── cancel.md            # 安全な操作キャンセル
+│   ├── build-fix.md         # ビルドエラー自動修復
+│   └── trace.md             # 実行タイムラインビューア
+├── hooks/
+│   └── user-prompt-submit.md  # ツール推奨フック
+├── dist/
+│   └── bundle.js            # 単一ファイル MCP サーバーバンドル
+├── scripts/
+│   └── bundle.mjs           # esbuild バンドルスクリプト
+├── packages/
+│   ├── core/                # AIProvider、レジストリ、セキュリティ、ワーカー
+│   ├── provider-ollama/     # Ollama HTTP アダプター
+│   ├── provider-gemini/     # Gemini CLI アダプター
+│   ├── provider-codex/      # Codex CLI アダプター
+│   ├── agents/              # ディベートエンジン、ディスパッチ、クロスバリデーション
+│   ├── workspace/           # ワークスペース文書マネージャー
+│   ├── memory/              # GraphRAG: ハイブリッド検索、行き詰まり追跡
+│   └── mcp-server/          # MCP サーバー、42 ツール、環境依存フィルタリング、ディスパッチ
+├── package.json             # ワークスペースルート
+└── turbo.json               # Turborepo パイプライン
+```
+
+### プロバイダー追加
+
+1. `packages/provider-<name>/` を作成して `AIProvider` を実装します。
+2. `packages/mcp-server/src/index.ts` にファクトリを追加します。
+3. `npm run build && npm test`
+
+---
+
+## アンインストール
+
+Claude Code で:
+
+```
+/plugin uninstall agestra@agestra
+```
+
+プラグイン自体はきれいに削除されます。生成済みのプロジェクトデータも削除したい場合は、`.agestra/` ディレクトリを手動で削除してください。
+
+---
+
+## ライセンス
+
+[GPL-3.0](LICENSE)

package/README.ko.md

@@ -5,9 +5,9 @@
 
 **Agent + Orchestra** — 여러 AI 공급자를 Claude Code에서 오케스트레이션하는 플러그인.
 
-[English](README.md) | [한국어](README.ko.md)
+[English](README.md) | [한국어](README.ko.md) | [日本語](README.ja.md) | [中文](README.zh.md)
 
-Agestra는 Ollama(로컬), Gemini CLI, Codex CLI를 Claude Code에 플러그형으로 연결합니다. 독립 취합, 합의 토론, 자율 CLI 워커, 병렬 작업 분배, 교차 검증, 품질 기반 공급자 라우팅, 지속적 GraphRAG 메모리 시스템을 41개 MCP 도구로 제공합니다.
+Agestra는 Ollama(로컬), Gemini CLI, Codex CLI를 Claude Code에 플러그형으로 연결합니다. 독립 취합, 합의 토론, 자율 CLI 워커, 병렬 작업 분배, 교차 검증, 품질 기반 공급자 라우팅, 지속적 GraphRAG 메모리 시스템을 42개 MCP 도구로 제공합니다.
 
 ## 빠른 시작
 
@@ -92,9 +92,9 @@ Turborepo 모노레포, 8개 패키지:
 | `@agestra/provider-gemini` | Google Gemini CLI 어댑터 |
 | `@agestra/provider-codex` | OpenAI Codex CLI 어댑터 |
 | `@agestra/agents` | 합의 검출 토론 엔진, 턴 품질 평가기, 작업 분배기, 교차 검증기, 작업 체인, 자동 QA, 파일 변경 추적기, 세션 관리자 |
-| `@agestra/workspace` | 코드 리뷰 워크플로우용 문서 관리자 |
+| `@agestra/workspace` | 리뷰, 분석 메모, 통합 보고서를 위한 워크스페이스 문서 관리자 |
 | `@agestra/memory` | GraphRAG — FTS5 + 벡터 + 지식 그래프 하이브리드 검색, 실패 추적 |
-| `@agestra/mcp-server` | MCP 프로토콜 레이어, 41개 도구, 환경별 도구 필터링, 디스패치 |
+| `@agestra/mcp-server` | MCP 프로토콜 레이어, 42개 도구, 환경별 도구 필터링, 디스패치 |
 
 ### 설계 원칙
 
@@ -116,13 +116,13 @@ Turborepo 모노레포, 8개 패키지:
 
 ---
 
-## 도구 (41개)
+## 도구 (42개)
 
 ### AI 채팅 (3개)
 
 | 도구 | 설명 |
 |------|------|
-| `ai_chat` | 특정 공급자와 채팅 (품질 기반 자동 라우팅: `"auto"`) |
+| `ai_chat` | 특정 공급자와 채팅 (품질 기반 자동 라우팅: `"auto"`); 필요하면 `save_as_document`로 응답을 문서로 저장 |
 | `ai_analyze_files` | 파일을 디스크에서 읽어 공급자에게 질문과 함께 전송 |
 | `ai_compare` | 같은 프롬프트를 여러 공급자에 보내 응답 비교 |
 
@@ -157,16 +157,17 @@ Turborepo 모노레포, 8개 패키지:
 |------|------|
 | `environment_check` | CLI 도구, Ollama 모델 티어, tmux, git worktree 지원 여부, 사용 가능 모드 탐지 |
 
-### 워크스페이스 (6개)
+### 워크스페이스 (7개)
 
 | 도구 | 설명 |
 |------|------|
-| `workspace_create_review` | 파일과 규칙이 포함된 코드 리뷰 문서 생성 |
-| `workspace_request_review` | 공급자에게 문서 리뷰 요청 |
-| `workspace_review_status` | 리뷰 완료 상태 확인 |
-| `workspace_add_comment` | 리뷰에 코멘트 추가 |
-| `workspace_read` | 리뷰 내용 읽기 |
-| `workspace_list` | 워크스페이스의 모든 리뷰 문서 목록 조회 |
+| `workspace_create_review` | 파일과 규칙이 포함된 코드 리뷰 문서 생성 |
+| `workspace_request_review` | 공급자에게 문서 리뷰 요청 |
+| `workspace_review_status` | 리뷰 완료 상태 확인 |
+| `workspace_add_comment` | 리뷰에 코멘트 추가 |
+| `workspace_create_document` | 제목, 마크다운 본문, 선택 메타데이터를 가진 범용 워크스페이스 문서 생성 |
+| `workspace_read` | 문서 내용 읽기 |
+| `workspace_list` | 워크스페이스의 모든 문서 목록 조회 |
 
 ### 공급자 관리 (2개)
 
@@ -237,7 +238,7 @@ Agestra는 시작 시 공급자를 자동 감지합니다. 수동 제어가 필
 | 경로 | 용도 |
 |------|------|
 | `.agestra/sessions/` | 토론 및 작업 세션 상태 |
-| `.agestra/workspace/` | 코드 리뷰 문서 |
+| `.agestra/workspace/` | 워크스페이스 문서 (리뷰, 메모, 보고서) |
 | `.agestra/memory.db` | GraphRAG SQLite 데이터베이스 |
 | `.agestra/.jobs/` | 백그라운드 작업 큐 |
 | `.agestra/.workers/` | CLI 워커 상태, 매니페스트, 출력 로그 |
@@ -295,9 +296,9 @@ agestra/
 │   ├── provider-gemini/     # Gemini CLI 어댑터
 │   ├── provider-codex/      # Codex CLI 어댑터
 │   ├── agents/              # 토론 엔진, 분배기, 교차 검증기
-│   ├── workspace/           # 코드 리뷰 문서 관리자
+│   ├── workspace/           # 워크스페이스 문서 관리자
 │   ├── memory/              # GraphRAG: 하이브리드 검색, 실패 추적
-│   └── mcp-server/          # MCP 서버, 41개 도구, 환경별 필터링, 디스패치
+│   └── mcp-server/          # MCP 서버, 42개 도구, 환경별 필터링, 디스패치
 ├── package.json             # 워크스페이스 루트
 └── turbo.json               # Turborepo 파이프라인
 ```

package/README.md

@@ -5,9 +5,9 @@
 
 **Agent + Orchestra** — A Claude Code plugin that orchestrates multiple AI providers.
 
-[English](README.md) | [한국어](README.ko.md)
+[English](README.md) | [한국어](README.ko.md) | [日本語](README.ja.md) | [中文](README.zh.md)
 
-Agestra connects Ollama (local), Gemini CLI, and Codex CLI to Claude Code as pluggable providers, enabling multi-agent orchestration with independent aggregation, consensus debates, autonomous CLI workers, parallel task dispatch, cross-validation, quality-based provider routing, and a persistent GraphRAG memory system — all through 41 MCP tools.
+Agestra connects Ollama (local), Gemini CLI, and Codex CLI to Claude Code as pluggable providers, enabling multi-agent orchestration with independent aggregation, consensus debates, autonomous CLI workers, parallel task dispatch, cross-validation, quality-based provider routing, and a persistent GraphRAG memory system — all through 42 MCP tools.
 
 ## Quick Start
 
@@ -92,9 +92,9 @@ Turborepo monorepo with 8 packages:
 | `@agestra/provider-gemini` | Google Gemini CLI adapter |
 | `@agestra/provider-codex` | OpenAI Codex CLI adapter |
 | `@agestra/agents` | Debate engine with consensus detection, turn quality evaluator, task dispatcher, cross-validator, task chain, auto-QA, file change tracker, session manager |
-| `@agestra/workspace` | Document manager for code review workflows |
+| `@agestra/workspace` | Workspace document manager for reviews, analysis notes, and aggregated reports |
 | `@agestra/memory` | GraphRAG — FTS5 + vector + knowledge graph hybrid search, dead-end tracking |
-| `@agestra/mcp-server` | MCP protocol layer, 41 tools, environment-aware tool filtering, dispatch |
+| `@agestra/mcp-server` | MCP protocol layer, 42 tools, environment-aware tool filtering, dispatch |
 
 ### Design Principles
 
@@ -116,13 +116,13 @@ Turborepo monorepo with 8 packages:
 
 ---
 
-## Tools (41)
+## Tools (42)
 
 ### AI Chat (3)
 
 | Tool | Description |
 |------|-------------|
-| `ai_chat` | Chat with a specific provider (use `"auto"` for quality-based routing) |
+| `ai_chat` | Chat with a specific provider (use `"auto"` for quality-based routing); optionally persist replies with `save_as_document` |
 | `ai_analyze_files` | Read files from disk and send contents with a question to a provider |
 | `ai_compare` | Send the same prompt to multiple providers, compare responses |
 
@@ -157,16 +157,17 @@ Turborepo monorepo with 8 packages:
 |------|-------------|
 | `environment_check` | Detect CLI tools, Ollama models with tiers, tmux, git worktree support, available modes |
 
-### Workspace (6)
+### Workspace (7)
 
 | Tool | Description |
 |------|-------------|
-| `workspace_create_review` | Create a code review document with files and rules |
-| `workspace_request_review` | Request a provider to review a document |
-| `workspace_review_status` | Check review completion status |
-| `workspace_add_comment` | Add a comment to a review |
-| `workspace_read` | Read review contents |
-| `workspace_list` | List all review documents in the workspace |
+| `workspace_create_review` | Create a code review document with files and rules |
+| `workspace_request_review` | Request a provider to review a document |
+| `workspace_review_status` | Check review completion status |
+| `workspace_add_comment` | Add a comment to a review |
+| `workspace_create_document` | Create a general-purpose workspace document with title, markdown content, and optional metadata |
+| `workspace_read` | Read document contents |
+| `workspace_list` | List all workspace documents |
 
 ### Provider Management (2)
 
@@ -237,7 +238,7 @@ Stored under `.agestra/` (gitignored):
 | Path | Purpose |
 |------|---------|
 | `.agestra/sessions/` | Debate and task session state |
-| `.agestra/workspace/` | Code review documents |
+| `.agestra/workspace/` | Workspace documents (reviews, notes, reports) |
 | `.agestra/memory.db` | GraphRAG SQLite database |
 | `.agestra/.jobs/` | Background job queue |
 | `.agestra/.workers/` | CLI worker state, manifests, and output logs |
@@ -295,9 +296,9 @@ agestra/
 │   ├── provider-gemini/     # Gemini CLI adapter
 │   ├── provider-codex/      # Codex CLI adapter
 │   ├── agents/              # Debate engine, dispatcher, cross-validator
-│   ├── workspace/           # Code review document manager
+│   ├── workspace/           # Workspace document manager
 │   ├── memory/              # GraphRAG: hybrid search, dead-end tracking
-│   └── mcp-server/          # MCP server, 41 tools, environment-aware filtering, dispatch
+│   └── mcp-server/          # MCP server, 42 tools, environment-aware filtering, dispatch
 ├── package.json             # Workspace root
 └── turbo.json               # Turborepo pipeline
 ```