@nahisaho/musubix-core 3.8.0 → 3.8.1

package/.github/AGENTS.md

@@ -8,14 +8,14 @@
 
 | 項目 | 詳細 |
 |------|------|
-| **バージョン** | 3.2.0 (Expert Delegation System) |
+| **バージョン** | 3.8.1 |
 | **言語** | TypeScript |
 | **ランタイム** | Node.js >= 20.0.0 |
 | **パッケージマネージャ** | npm >= 10.0.0 |
 | **ビルドシステム** | モノレポ（npm workspaces） |
 | **テストフレームワーク** | Vitest |
-| **テスト数** | 4500+ (全合格) |
-| **パッケージ数** | 26 |
+| **テスト数** | 5,738+ (全合格) |
+| **パッケージ数** | 25 |
 | **MCPツール数** | 107 |
 | **Agent Skills** | 13 (Claude Code対応) |
 
@@ -44,16 +44,20 @@ packages/
 ├── workflow-engine/    # @nahisaho/musubix-workflow-engine
 ├── skill-manager/      # @nahisaho/musubix-skill-manager
 ├── codegraph/          # @nahisaho/musubix-codegraph
-├── expert-delegation/  # @nahisaho/musubix-expert-delegation (v3.2.0 NEW!)
-├── knowledge/          # @musubix/knowledge (v3.0.0 NEW!)
-├── policy/             # @musubix/policy (v3.0.0 NEW!)
-└── decisions/          # @musubix/decisions (v3.0.0 NEW!)
+├── expert-delegation/  # @nahisaho/musubix-expert-delegation
+├── deep-research/      # @nahisaho/musubix-deep-research
+├── assistant-axis/     # @nahisaho/musubix-assistant-axis
+├── musubi/             # @nahisaho/musubi
+├── musubix/            # musubix (CLIエントリポイント)
+├── knowledge/          # @musubix/knowledge
+├── policy/             # @musubix/policy
+└── decisions/          # @musubix/decisions
 ```
 
 | パッケージ | npm | 役割 |
 |-----------|-----|------|
 | `packages/core/` | `@nahisaho/musubix-core` | コアライブラリ - CLI、EARS検証、コード生成、設計パターン |
-| `packages/mcp-server/` | `@nahisaho/musubix-mcp-server` | MCPサーバー - 61ツール、5プロンプト |
+| `packages/mcp-server/` | `@nahisaho/musubix-mcp-server` | MCPサーバー - 107ツール、5プロンプト |
 | `packages/security/` | `@nahisaho/musubix-security` | セキュリティ分析 - 脆弱性検出、シークレット検出、テイント解析 |
 | `packages/formal-verify/` | `@nahisaho/musubix-formal-verify` | 形式検証 - Z3統合、Hoare検証、EARS→SMT変換 |
 | `packages/pattern-mcp/` | `@nahisaho/musubix-pattern-mcp` | パターン学習 - 抽出・圧縮・ライブラリ |
@@ -72,21 +76,11 @@ packages/
 | `packages/workflow-engine/` | `@nahisaho/musubix-workflow-engine` | **ワークフロー制御** - 5フェーズ制御・品質ゲート |
 | `packages/skill-manager/` | `@nahisaho/musubix-skill-manager` | **スキル管理** - スキル登録・実行・検証 |
 | `packages/codegraph/` | `@nahisaho/musubix-codegraph` | **コードグラフ** - コード構造解析・依存関係追跡 |
-| `packages/expert-delegation/` | `@nahisaho/musubix-expert-delegation` | **エキスパート委譲 (v3.2.0 NEW!)** - 7種AI専門家・VS Code LM API統合 |
-
-### 非推奨パッケージ（Deprecated） ⚠️
-
-以下のYATA関連パッケージはv3.0.0で非推奨となりました。`@musubix/knowledge`へ移行してください。
-
-| パッケージ | 状態 | 移行先 |
-|-----------|------|--------|
-| `packages/yata-client/` | ⚠️ Deprecated | `@musubix/knowledge` |
-| `packages/yata-global/` | ⚠️ Deprecated | `@musubix/knowledge` |
-| `packages/yata-local/` | ⚠️ Deprecated | `@musubix/knowledge` |
-| `packages/yata-scale/` | ⚠️ Deprecated | `@musubix/knowledge` |
-| `packages/yata-ui/` | ⚠️ Deprecated | `@musubix/knowledge` |
-
-**移行ガイド**: [docs/MIGRATION-v3.0.md](docs/MIGRATION-v3.0.md)
+| `packages/expert-delegation/` | `@nahisaho/musubix-expert-delegation` | **エキスパート委譲** - 7種AI専門家・VS Code LM API統合 |
+| `packages/deep-research/` | `@nahisaho/musubix-deep-research` | **Deep Research** - AI駆動型深層リサーチ・6統合機能 |
+| `packages/assistant-axis/` | `@nahisaho/musubix-assistant-axis` | **マルチモーダル統合** - アシスタント軸 |
+| `packages/musubi/` | `@nahisaho/musubi` | **AI要約** |
+| `packages/musubix/` | `musubix` | **CLIエントリポイント** |
 
 ### Core パッケージモジュール
 
@@ -120,6 +114,7 @@ npx musubix requirements analyze <file>    # 自然言語 → EARS変換
 npx musubix requirements validate <file>   # EARS構文検証
 npx musubix requirements map <file>        # オントロジーマッピング
 npx musubix requirements search <query>    # 関連要件検索
+npx musubix requirements new <feature>     # 対話的要件作成
 
 # 設計生成
 npx musubix design generate <file>         # 要件から設計生成
@@ -127,14 +122,16 @@ npx musubix design patterns <context>      # パターン検出
 npx musubix design validate <file>         # SOLID準拠検証
 npx musubix design c4 <file>               # C4ダイアグラム生成
 npx musubix design adr <decision>          # ADR生成
-npx musubix design traceability            # REQ↔DESトレーサビリティ検証 (v3.1.0 NEW!)
+npx musubix design traceability            # REQ↔DESトレーサビリティ検証
 npx musubix design traceability --min-coverage 80  # カバレッジ閾値指定
 
 # コード生成
 npx musubix codegen generate <file>        # 設計からコード生成
+npx musubix codegen generate <file> --full-skeleton  # 4ファイル生成
+npx musubix codegen generate <file> --with-tests     # テストファイル付き
 npx musubix codegen analyze <file>         # 静的解析
 npx musubix codegen security <path>        # セキュリティスキャン
-npx musubix codegen status <spec>          # ステータス遷移コード生成 (v3.1.0 NEW!)
+npx musubix codegen status <spec>          # ステータス遷移コード生成
 npx musubix codegen status <spec> --enum   # enum型で生成
 
 # テスト
@@ -146,7 +143,7 @@ npx musubix trace matrix                   # トレーサビリティマトリ
 npx musubix trace matrix -p <project>      # 指定プロジェクトのマトリクス
 npx musubix trace impact <id>              # 影響分析
 npx musubix trace validate                 # リンク検証
-npx musubix trace sync                     # トレースマトリクス自動更新 (v1.6.7 NEW!)
+npx musubix trace sync                     # トレースマトリクス自動更新
 npx musubix trace sync --dry-run           # プレビューのみ
 
 # 説明生成
@@ -155,49 +152,105 @@ npx musubix explain graph <id>             # 推論グラフ生成
 
 # 自己学習システム
 npx musubix learn status                   # 学習状態ダッシュボード
+npx musubix learn dashboard                # インタラクティブダッシュボード
 npx musubix learn feedback <id>            # フィードバック記録
 npx musubix learn patterns                 # パターン一覧表示
+npx musubix learn best-practices           # ベストプラクティス表示
+npx musubix learn bp-list                  # ベストプラクティスID一覧
+npx musubix learn bp-show <id>             # ベストプラクティス詳細
 npx musubix learn add-pattern <name>       # パターン手動登録
 npx musubix learn remove-pattern <id>      # パターン削除
-npx musubix learn recommend                # コンテキストベースの推奨
+npx musubix learn recommend -a <type>      # 推奨（-a 必須: code|design|test）
 npx musubix learn decay                    # 未使用パターンの減衰
+npx musubix learn wake                     # Wakeフェーズ実行
+npx musubix learn sleep                    # Sleepフェーズ実行
+npx musubix learn cycle                    # Wake-Sleep完全サイクル
+npx musubix learn compress                 # パターン圧縮・最適化
 npx musubix learn export                   # 学習データエクスポート
   # オプション: --output <file>, --privacy-filter, --patterns-only, --feedback-only, --min-confidence <n>
 npx musubix learn import <file>            # 学習データインポート
   # オプション: --merge-strategy <skip|overwrite|merge>, --dry-run, --patterns-only, --feedback-only
 
-# オントロジー操作 (v1.4.1 NEW!)
-npx musubix ontology validate -f <file>    # 知識グラフ整合性検証
-npx musubix ontology check-circular -f <file>  # 循環依存チェック
-npx musubix ontology stats -f <file>       # 統計表示
-
-# Interactive REPL (v1.5.0 NEW!)
+# 知識グラフ (Knowledge)
+npx musubix knowledge add <type> <id> <name>  # エンティティ追加
+npx musubix knowledge get <id>                 # エンティティ取得
+npx musubix knowledge delete <id>              # エンティティ削除
+npx musubix knowledge link <source> <type> <target>  # リレーション追加
+npx musubix knowledge query [--type <type>]    # クエリ検索
+npx musubix knowledge traverse <id>            # グラフ走査
+npx musubix knowledge stats                    # 統計表示
+
+# ADR (Architecture Decision Records)
+npx musubix decision create <title>        # ADR作成
+npx musubix decision list                  # ADR一覧
+npx musubix decision get <id>              # ADR詳細
+npx musubix decision accept <id>           # ADR承認
+npx musubix decision deprecate <id>        # ADR廃止
+npx musubix decision search <query>        # ADR検索
+npx musubix decision index                 # ADRインデックス生成
+
+# ポリシー検証
+npx musubix policy validate [path]         # プロジェクト検証
+npx musubix policy list                    # ポリシー一覧
+npx musubix policy info <id>               # ポリシー詳細
+npx musubix policy check <file>            # 単一ファイル検証
+
+# コードグラフ (16言語対応)
+npx musubix cg index <path>                # インデックス作成
+npx musubix cg query [name]                # エンティティ検索
+npx musubix cg search <query>              # セマンティック検索
+npx musubix cg deps <name>                 # 依存関係
+npx musubix cg callers <name>              # 呼び出し元
+npx musubix cg callees <name>              # 呼び出し先
+npx musubix cg languages                   # 対応言語一覧
+npx musubix cg stats                       # 統計
+
+# オントロジー操作
+npx musubix ontology validate              # 知識グラフ整合性検証
+npx musubix ontology check-circular        # 循環依存チェック
+npx musubix ontology stats                 # 統計表示
+
+# Interactive REPL
 npx musubix repl                           # 対話的シェルを起動
-npx musubix repl --history <file>          # カスタム履歴ファイル
-npx musubix repl --no-color                # 色なしモード
 
-# KGPR - Knowledge Graph Pull Request (v1.6.4 - DEPRECATED)
-# KGPRは廃止されました。通常のGit PRワークフローを使用してください。
-
-# SDDプロジェクトスキャフォールド (v1.6.7 NEW!, v3.1.0 Enhanced!)
+# SDDプロジェクトスキャフォールド
 npx musubix scaffold domain-model <name>   # DDDプロジェクト生成
 npx musubix scaffold domain-model <name> -e "Entity1,Entity2"  # エンティティ指定
 npx musubix scaffold domain-model <name> -d DOMAIN  # ドメイン接頭辞指定
-npx musubix scaffold domain-model <name> -v "Price,Email"  # Value Object生成 (v3.1.0 NEW!)
-npx musubix scaffold domain-model <name> -s "Order,Task"   # ステータス遷移生成 (v3.1.0 NEW!)
+npx musubix scaffold domain-model <name> -v "Price,Email"  # Value Object生成
+npx musubix scaffold domain-model <name> -s "Order,Task"   # ステータス遷移生成
+npx musubix scaffold domain-model <name> -s "Order=pending,Task=open"  # 初期状態指定
 npx musubix scaffold minimal <name>        # 最小構成プロジェクト
+npx musubix scaffold api-service <name>    # APIサービスプロジェクト
 
-# プログラム合成 (v2.2.0 NEW!)
+# プログラム合成
 npx musubix synthesize <examples.json>     # 例からプログラム合成
 npx musubix synthesize pbe <examples.json> # PBE特化合成
 npx musubix syn <examples.json>            # エイリアス
 
-# パターンライブラリ管理 (v2.2.0 NEW!)
+# パターンライブラリ管理
 npx musubix library learn <file>           # コードからパターン学習
 npx musubix library query <query>          # パターン検索
 npx musubix library stats                  # 統計表示
 npx musubix lib stats                      # エイリアス
 
+# パフォーマンス
+npx musubix perf benchmark                 # ベンチマーク
+npx musubix perf startup                   # 起動時間計測
+npx musubix perf memory                    # メモリ使用量
+
+# Deep Research
+npx musubix deep-research <query> [-i <iterations>] [-o <file>]
+
+# スキル・タスク管理
+npx musubix skills list                    # スキル一覧
+npx musubix skills validate [skill-name]   # スキル検証
+npx musubix tasks list                     # タスク一覧
+npx musubix tasks stats                    # タスク統計
+
+# ファイルウォッチャー
+npx musubix watch [paths...] [--lint] [--test] [--security] [--ears]
+
 # ヘルプ
 npx musubix --help
 npx musubix help <command>
@@ -214,7 +267,7 @@ npx @nahisaho/musubix-mcp-server
 npx musubix-mcp --transport stdio
 ```
 
-### ツール一覧（61ツール）
+### ツール一覧（107ツール）
 
 #### SDD基本ツール（7ツール）
 
@@ -945,5 +998,5 @@ npx musubix learn best-practices --format markdown
 ---
 
 **Agent**: GitHub Copilot / Claude
-**Last Updated**: 2026-01-11
-**Version**: 3.0.0
+**Last Updated**: 2026-02-08
+**Version**: 3.8.1

package/AGENTS.md

@@ -1,260 +1,387 @@
-# AGENTS.md — MUSUBIX v3.7.2
+# AGENTS.md — MUSUBIX v3.8.1
 
-> **AI Agent向け最適化ナレッジ** — WHEN/DO構文で明確なトリガーとアクションを定義
+> **AI Agent向け最適化ナレッジ** — 実際のCLIコマンド・MCP APIに基づく正確なリファレンス
 
-## 🎯 クイックリファレンス
+## クイックリファレンス
 
 | 項目 | 値 |
 |------|-----|
-| バージョン | 3.7.2 |
-| テストカバレッジ | 92%+ |
-| パッケージ数 | 28 |
-| MCP ツール | 114 |
-| Agent Skills | 15 |
+| バージョン | 3.8.1 |
+| パッケージ数 | 25 |
+| テスト数 | 5,738+ |
+| MCP ツール | 107 |
+| Agent Skills | 13 |
+| パッケージマネージャ | npm (workspaces) |
 
 ---
 
-## 📦 パッケージ構成
+## パッケージ構成
 
 | カテゴリ | パッケージ | 用途 |
 |----------|------------|------|
-| **Core** | `@musubix/core` | エンティティ・値オブジェクト |
-| | `@musubix/knowledge` | ナレッジグラフ CRUD |
-| | `@musubix/musubi` | AI要約（300字以内） |
-| | `@musubix/codegraph` | コード解析・依存関係抽出 |
-| **SDD** | `@musubix/sdd-ontology` | オントロジー管理 |
-| | `@musubix/decisions` | ADR管理・トレーサビリティ |
-| | `@musubix/synthesis` | 情報統合 |
-| **Verification** | `@musubix/formal-verify` | Lean4形式検証 |
-| | `@musubix/lean` | Lean4連携 |
-| | `@musubix/policy` | ルール駆動検証 |
-| **Agent** | `@musubix/assistant-axis` | マルチモーダル統合 |
-| | `@musubix/expert-delegation` | 専門家委譲 |
-| | `@musubix/skill-manager` | スキル動的ロード |
-| | `@musubix/agent-orchestrator` | 階層的オーケストレーション |
-| **Learning** | `@musubix/wake-sleep` | 自律学習 |
-| | `@musubix/deep-research` | 深層調査 |
-| | `@musubix/library-learner` | ライブラリ学習 |
-| **Search** | `@musubix/neural-search` | ベクトル・ハイブリッド検索 |
-| **Workflow** | `@musubix/workflow-engine` | DAGワークフロー |
-| | `@musubix/dfg` | データフローグラフ |
-| **MCP** | `@musubix/mcp-server` | MCP統合サーバー |
-| | `@musubix/ontology-mcp` | オントロジーMCP |
-| | `@musubix/pattern-mcp` | パターンMCP |
+| **Core** | `@nahisaho/musubix-core` | CLI・EARS検証・コード生成・設計パターン |
+| | `@musubix/knowledge` | Git-friendly JSON知識グラフ (ゼロ依存) |
+| | `@nahisaho/musubix-codegraph` | コード解析・依存関係追跡 (16言語) |
+| | `@nahisaho/musubi` | AI要約 |
+| **SDD** | `@nahisaho/musubix-sdd-ontology` | SDD方法論オントロジー |
+| | `@musubix/decisions` | ADR管理 (ゼロ依存) |
+| | `@nahisaho/musubix-synthesis` | プログラム合成 |
+| | `@musubix/policy` | 9憲法条項検証 |
+| **Verification** | `@nahisaho/musubix-formal-verify` | Z3/Hoare形式検証 |
+| | `@nahisaho/musubix-lean` | Lean4連携 |
+| **Agent** | `@nahisaho/musubix-assistant-axis` | マルチモーダル統合 |
+| | `@nahisaho/musubix-expert-delegation` | 7種AI専門家委譲 |
+| | `@nahisaho/musubix-skill-manager` | スキル動的ロード |
+| | `@nahisaho/musubix-agent-orchestrator` | 階層的オーケストレーション |
+| **Learning** | `@nahisaho/musubix-wake-sleep` | Wake-Sleep自律学習 |
+| | `@nahisaho/musubix-deep-research` | AI深層調査 |
+| | `@nahisaho/musubix-library-learner` | ライブラリ学習 |
+| **Search** | `@nahisaho/musubix-neural-search` | ベクトル・ハイブリッド検索 |
+| **Workflow** | `@nahisaho/musubix-workflow-engine` | DAGワークフロー |
+| | `@nahisaho/musubix-dfg` | データフローグラフ |
+| **Security** | `@nahisaho/musubix-security` | 脆弱性・シークレット検出 |
+| **MCP** | `@nahisaho/musubix-mcp-server` | MCP統合サーバー (107ツール) |
+| | `@nahisaho/musubix-ontology-mcp` | オントロジーMCP |
+| | `@nahisaho/musubix-pattern-mcp` | パターンMCP |
+| **CLI** | `musubix` | CLIエントリポイント |
 
 ---
 
-## 🛠️ CLI コマンド
+## CLI コマンド（実際の `--help` 出力に基づく）
 
-### 基本操作
+### プロジェクト初期化・スキャフォールド
 
 ```bash
-# プロジェクト全体
-pnpm i && pnpm build && pnpm test
-
-# 個別パッケージ
-pnpm --filter @musubix/core test
-pnpm --filter @musubix/knowledge test
+npx musubix init [path] [--name <name>] [--force]
+npx musubix scaffold domain-model <name> -e "Entity1,Entity2" [-d PREFIX] [-v "VO1"] [-s "Entity=status"]
+npx musubix scaffold minimal <name>
+npx musubix scaffold api-service <name>
 ```
 
-### ナレッジ操作
+### 要件分析（EARS形式）
 
 ```bash
-# 追加・検索
-musubix knowledge add --source ./src --output ./knowledge.json
-musubix knowledge search "認証" --semantic --top-k 5
-
-# コードグラフ
-musubix codegraph analyze ./src --include-dependencies
-musubix codegraph query "関数 -> 依存関係"
+npx musubix requirements analyze <file>     # 自然言語 → EARS変換
+npx musubix requirements validate <file>    # EARS構文検証
+npx musubix requirements map <file>         # オントロジーマッピング
+npx musubix requirements search <query>     # 関連要件検索
+npx musubix requirements new <feature>      # 対話的要件作成
 ```
 
-### SDD ワークフロー
+### 設計生成・検証
 
 ```bash
-# 仕様駆動開発
-musubix sdd init --domain "Eコマース" --output ./specs
-musubix sdd validate ./specs --strict
-musubix sdd generate ./specs --output ./src
+npx musubix design generate <requirements>  # 要件→設計生成
+npx musubix design validate <file>          # SOLID準拠検証
+npx musubix design c4 <file>                # C4ダイアグラム生成
+npx musubix design adr <decision>           # ADR生成
+npx musubix design patterns <context>       # パターン検出
+npx musubix design traceability [--min-coverage 80]  # REQ↔DES検証
 ```
 
-### MCP サーバー
+### コード生成・解析
 
 ```bash
-# 起動
-musubix-mcp serve
-musubix-mcp serve --port 3000 --skills-dir ./skills
+npx musubix codegen generate <design>       # 設計→コード生成
+npx musubix codegen generate <design> --full-skeleton  # 4ファイル生成
+npx musubix codegen generate <design> --with-tests     # テスト付き
+npx musubix codegen analyze <path>          # 静的解析
+npx musubix codegen security <path>         # セキュリティスキャン
+npx musubix codegen status <spec> [--enum]  # ステータス遷移コード生成
 ```
 
----
-
-## 🔌 MCP ツール（主要）
+### テスト・トレーサビリティ
 
-| カテゴリ | ツール | 用途 |
-|----------|--------|------|
-| **Knowledge** | `knowledge_add`, `knowledge_search`, `knowledge_import`, `knowledge_export` | ナレッジ CRUD |
-| **CodeGraph** | `codegraph_analyze`, `codegraph_query`, `codegraph_visualize` | コード解析 |
-| **SDD** | `sdd_init`, `sdd_validate`, `sdd_generate`, `sdd_trace` | 仕様駆動開発 |
-| **Wake-Sleep** | `wake_observe`, `wake_optimize`, `sleep_consolidate`, `sleep_generate` | 自律学習 |
-| **Formal** | `formal_translate`, `formal_verify`, `formal_prove` | 形式検証 |
-| **Search** | `neural_search`, `hybrid_search`, `graph_search` | 検索 |
+```bash
+npx musubix test generate <path>            # テスト生成
+npx musubix test coverage <dir>             # カバレッジ測定
+npx musubix trace matrix [-p <project>]     # トレーサビリティマトリクス
+npx musubix trace impact <id>               # 影響分析
+npx musubix trace validate                  # リンク検証
+npx musubix trace sync [--dry-run]          # 自動更新
+```
 
-**全114ツール**: `musubix-mcp list-tools` で確認
+### 自己学習システム
 
----
+```bash
+npx musubix learn status                    # 学習ダッシュボード
+npx musubix learn dashboard                 # インタラクティブダッシュボード
+npx musubix learn patterns                  # パターン一覧
+npx musubix learn best-practices [--category code|design|test] [--high-confidence]
+npx musubix learn bp-list                   # ベストプラクティスID一覧
+npx musubix learn bp-show <id>              # ベストプラクティス詳細
+npx musubix learn recommend -a <type>       # 推奨（-a 必須: code|design|test）
+npx musubix learn feedback <artifactId>     # フィードバック記録
+npx musubix learn add-pattern <name>        # パターン手動登録
+npx musubix learn remove-pattern <id>       # パターン削除
+npx musubix learn decay                     # 未使用パターン減衰
+npx musubix learn wake                      # Wakeフェーズ実行
+npx musubix learn sleep                     # Sleepフェーズ実行
+npx musubix learn cycle                     # Wake-Sleep完全サイクル
+npx musubix learn compress                  # パターン圧縮・最適化
+npx musubix learn export [--output <file>] [--privacy-filter]
+npx musubix learn import <file> [--merge-strategy skip|overwrite|merge]
+```
 
-## 📜 10憲法条項
+### 知識グラフ (Knowledge)
 
-| # | 条項 | ルール |
-|---|------|--------|
-| 1 | コンテキスト最優先 | Steering/product.ja.md, structure.ja.md を必ず参照 |
-| 2 | ナレッジ駆動 | 既存知識を検索・活用してから回答 |
-| 3 | 仕様駆動 (SDD) | 要件→設計→実装→検証の順序厳守 |
-| 4 | トレーサビリティ | 決定事項は ADR として記録 |
-| 5 | 段階的詳細化 | 抽象から具体へ、一度に1レベル |
-| 6 | 自律学習 | Wake-Sleepサイクルで継続的改善 |
-| 7 | 形式検証 | 重要ロジックはLean4で証明 |
-| 8 | パターン適用 | 学習済みベストプラクティスを活用 |
-| 9 | 明示的コミュニケーション | 不明点は確認、仮定を明示 |
-| 10 | 品質最優先 | テスト・レビュー・検証を省略しない |
-
----
+```bash
+npx musubix knowledge add <type> <id> <name>  # エンティティ追加
+npx musubix knowledge get <id>                 # エンティティ取得
+npx musubix knowledge delete <id>              # エンティティ削除
+npx musubix knowledge link <source> <type> <target>  # リレーション追加
+npx musubix knowledge query [--type <type>]    # クエリ検索
+npx musubix knowledge traverse <id>            # グラフ走査
+npx musubix knowledge stats                    # 統計表示
+```
 
-## 🧭 Project Memory（Steering）
+### ADR (Architecture Decision Records)
 
-| ファイル | 用途 | 参照タイミング |
-|----------|------|----------------|
-| `steering/product.ja.md` | 製品ビジョン・ゴール | プロジェクト理解時 |
-| `steering/structure.ja.md` | アーキテクチャ構造 | 設計・実装時 |
-| `steering/tech.ja.md` | 技術スタック・制約 | 技術選定時 |
-| `steering/project.yml` | プロジェクトメタデータ | CI/CD設定時 |
-| `steering/rules/*.md` | ドメイン固有ルール | コード生成時 |
+```bash
+npx musubix decision create <title>         # ADR作成
+npx musubix decision list                   # ADR一覧
+npx musubix decision get <id>               # ADR詳細
+npx musubix decision accept <id>            # ADR承認
+npx musubix decision deprecate <id>         # ADR廃止
+npx musubix decision search <query>         # ADRキーワード検索
+npx musubix decision index                  # ADRインデックス生成
+```
 
----
+### ポリシー検証
 
-## 🔬 主要機能
+```bash
+npx musubix policy validate [path]          # プロジェクト検証
+npx musubix policy list                     # ポリシー一覧
+npx musubix policy info <id>                # ポリシー詳細
+npx musubix policy check <file>             # 単一ファイル検証
+```
 
-### 1. Wake-Sleep 自律学習
+### コードグラフ (16言語対応)
 
-```typescript
-// WHEN: パターン学習が必要
-// DO: Wake-Sleepサイクルを実行
-const result = await wakeSleep.observe("./src/**/*.ts");
-const patterns = await wakeSleep.consolidate(result);
-await wakeSleep.apply(patterns);
+```bash
+npx musubix cg index <path>                 # インデックス作成
+npx musubix cg query [name]                 # エンティティ検索
+npx musubix cg search <query>               # セマンティック検索
+npx musubix cg deps <name>                  # 依存関係
+npx musubix cg callers <name>               # 呼び出し元
+npx musubix cg callees <name>               # 呼び出し先
+npx musubix cg languages                    # 対応言語一覧
+npx musubix cg stats                        # 統計
 ```
 
-### 2. Knowledge Graph
+### オントロジー・説明生成
 
-```typescript
-// WHEN: 情報の関連付けが必要
-// DO: エンティティとリレーションを追加
-await knowledge.addEntity({ type: "Function", name: "auth" });
-await knowledge.addRelation("auth", "uses", "jwt-library");
-const related = await knowledge.search("認証", { semantic: true });
+```bash
+npx musubix ontology validate               # 知識グラフ整合性検証
+npx musubix ontology check-circular          # 循環依存チェック
+npx musubix ontology stats                   # 統計表示
+npx musubix explain why <id>                 # 決定理由の説明
+npx musubix explain graph <id>               # 推論グラフ生成
 ```
 
-### 3. CodeGraph 解析
+### その他
 
-```typescript
-// WHEN: コード依存関係の把握が必要
-// DO: 解析してクエリ実行
-const graph = await codegraph.analyze("./src");
-const deps = await codegraph.query("Function -> Dependency");
+```bash
+npx musubix library learn <file>             # コードからパターン学習
+npx musubix library query <query>            # パターン検索
+npx musubix library stats                    # パターン統計
+npx musubix synthesize <examples.json>       # プログラム合成
+npx musubix synthesize pbe <examples.json>   # PBE特化合成
+npx musubix deep-research <query> [-i <iterations>] [-o <file>]
+npx musubix perf benchmark                   # パフォーマンスベンチマーク
+npx musubix perf startup                     # 起動時間計測
+npx musubix perf memory                      # メモリ使用量
+npx musubix skills list                      # スキル一覧
+npx musubix skills validate [skill-name]     # スキル検証
+npx musubix tasks list                       # タスク一覧
+npx musubix tasks stats                      # タスク統計
+npx musubix watch [paths...] [--lint] [--test] [--security]
+npx musubix repl                             # 対話的REPL
 ```
 
-### 4. SDD ワークフロー
+---
 
-```typescript
-// WHEN: 新機能の仕様策定
-// DO: init → validate → generate
-await sdd.init({ domain: "Payment", output: "./specs" });
-await sdd.validate("./specs", { strict: true });
-await sdd.generate("./specs", { output: "./src" });
-```
+## MCP Server
 
-### 5. Formal Verification
+### 起動
 
-```typescript
-// WHEN: 重要ロジックの証明が必要
-// DO: Lean4に変換して検証
-const leanCode = await formal.translate(tsCode);
-const proof = await formal.verify(leanCode);
+```bash
+npx @nahisaho/musubix-mcp-server
+npx musubix-mcp --transport stdio
 ```
 
+### 主要MCPツール
+
+| カテゴリ | ツール名 | 説明 |
+|----------|---------|------|
+| **SDD** | `sdd_create_requirements` | EARS形式要件作成 |
+| | `sdd_validate_requirements` | EARS検証・憲法準拠チェック |
+| | `sdd_create_design` | C4モデル設計作成 |
+| | `sdd_validate_design` | 設計トレーサビリティ検証 |
+| | `sdd_create_tasks` | 設計→タスク生成 |
+| | `sdd_validate_constitution` | 9憲法条項検証 |
+| | `sdd_validate_traceability` | 全体トレーサビリティ検証 |
+| **Pattern** | `pattern_extract` | パターン抽出 |
+| | `pattern_compress` | パターン圧縮 |
+| | `pattern_store` | パターン保存 |
+| | `pattern_query` | パターン検索 |
+| | `pattern_consolidate` | パターン統合 |
+| | `ontology_query` | オントロジークエリ |
+| | `ontology_infer` | オントロジー推論 |
+| **Validation** | `consistency_validate` | 整合性検証 |
+| | `validate_triple` | トリプル検証 |
+| | `check_circular` | 循環依存検出 |
+| **Knowledge** | `knowledge_put_entity` | エンティティ作成・更新 |
+| | `knowledge_get_entity` | エンティティ取得 |
+| | `knowledge_delete_entity` | エンティティ削除 |
+| | `knowledge_add_relation` | リレーション追加 |
+| | `knowledge_query` | グラフクエリ |
+| | `knowledge_traverse` | グラフ走査 |
+| **Policy** | `policy_validate` | ポリシー検証 |
+| | `policy_list` | ポリシー一覧 |
+| | `policy_get` | ポリシー詳細 |
+| | `policy_check_file` | ファイル検証 |
+| **Decision** | `decision_create` | ADR作成 |
+| | `decision_list` | ADR一覧 |
+| | `decision_get` | ADR詳細 |
+| | `decision_accept` | ADR承認 |
+| | `decision_deprecate` | ADR廃止 |
+| | `decision_search` | ADR検索 |
+| | `decision_find_by_requirement` | 要件→ADR検索 |
+| | `decision_generate_index` | インデックス生成 |
+| **Synthesis** | `synthesis_from_examples` | プログラム合成 |
+| | `synthesis_analyze_examples` | 例題分析 |
+| | `synthesis_learn_patterns` | パターン学習 |
+| | `synthesis_query_patterns` | パターン検索 |
+| | `synthesis_get_stats` | 統計取得 |
+| **Orchestrator** | `agent_analyze_complexity` | タスク複雑度分析 |
+| | `agent_dispatch` | サブエージェントディスパッチ |
+| | `agent_collect_results` | 結果収集・統合 |
+| | `agent_get_status` | 実行状態取得 |
+| **Workflow** | `workflow_create` | ワークフロー作成 |
+| | `workflow_advance_phase` | フェーズ遷移 |
+| | `workflow_set_approval` | 承認設定 |
+| | `workflow_get_status` | 状態取得 |
+| | `workflow_validate_transition` | 遷移事前検証 |
+| **Skill** | `skill_register` | スキル登録 |
+| | `skill_execute` | スキル実行 |
+| | `skill_list` | スキル一覧 |
+| | `skill_get_info` | スキル詳細 |
+| | `skill_validate` | スキル検証 |
+
 ---
 
-## 📚 学習済みベストプラクティス
-
-| パターン | 適用条件 | 効果 |
-|----------|----------|------|
-| Result型 | エラーハンドリング | 型安全なエラー処理 |
-| Repository | データアクセス | 永続化層の抽象化 |
-| ValueObject | 不変データ | 値の整合性保証 |
-| AggregateRoot | 整合性境界 | トランザクション境界の明確化 |
-| CQRS | 読み書き分離 | パフォーマンス最適化 |
-| EventSourcing | 状態追跡 | 完全な監査証跡 |
-| DomainEvent | 疎結合通知 | モジュール間の依存削減 |
-| Specification | 条件カプセル化 | 再利用可能なビジネスルール |
-| Factory | 生成ロジック | 複雑なオブジェクト生成の隠蔽 |
-| Strategy | アルゴリズム切替 | 実行時の振る舞い変更 |
+## 9憲法条項
+
+| # | 条項 | ルール |
+|---|------|--------|
+| I | Library-First | 機能は独立ライブラリとして開始 |
+| II | CLI Interface | すべてのライブラリはCLI公開必須 |
+| III | Test-First | Red-Green-Blueサイクルでテスト先行 |
+| IV | EARS Format | 要件はEARS形式で記述 |
+| V | Traceability | REQ↔DES↔CODE↔TESTの100%追跡 |
+| VI | Project Memory | steering/ を参照してから決定 |
+| VII | Design Patterns | 設計パターン適用の文書化 |
+| VIII | Decision Records | すべての決定をADRで記録 |
+| IX | Quality Gates | フェーズ移行前の品質検証 |
 
 ---
 
-## 🤖 Agent Skills（15スキル）
+## Project Memory（Steering）
 
-### Core Skills
+| ファイル | 用途 | 参照タイミング |
+|----------|------|----------------|
+| `steering/product.ja.md` | 製品ビジョン・ゴール | プロジェクト理解時 |
+| `steering/structure.ja.md` | アーキテクチャ構造 | 設計・実装時 |
+| `steering/tech.ja.md` | 技術スタック・制約 | 技術選定時 |
+| `steering/project.yml` | プロジェクトメタデータ | CI/CD設定時 |
+| `steering/rules/*.md` | ドメイン固有ルール | コード生成時 |
 
-| スキル | トリガー | 機能 |
-|--------|----------|------|
-| `knowledge-capture` | 新情報入力時 | エンティティ抽出・関係構築 |
-| `knowledge-integration` | 統合要求時 | 複数ソースの知識統合 |
-| `structured-summary` | 要約要求時 | 構造化300字要約 |
-| `deep-research` | 調査要求時 | 多段階深層調査 |
-| `learning-extraction` | パターン発見時 | ベストプラクティス抽出 |
+---
 
-### SDD Skills
+## Agent Skills（13スキル）
 
 | スキル | トリガー | 機能 |
 |--------|----------|------|
-| `musubix-domain-inference` | 要件分析時 | ドメインモデル推論 |
 | `musubix-sdd-workflow` | SDD開始時 | 仕様駆動開発ガイド |
+| `musubix-domain-inference` | 要件分析時 | ドメインモデル推論 |
+| `musubix-ears-validation` | 要件検証時 | EARS構文検証 |
+| `musubix-c4-design` | 設計図作成時 | C4モデル生成 |
 | `musubix-code-generation` | コード生成時 | SDD準拠コード生成 |
 | `musubix-test-generation` | テスト生成時 | 仕様ベーステスト生成 |
-| `musubix-traceability` | 追跡確認時 | 要件-実装追跡 |
-
-### Documentation Skills
-
-| スキル | トリガー | 機能 |
-|--------|----------|------|
+| `musubix-traceability` | 追跡確認時 | 要件→実装追跡 |
 | `musubix-adr-generation` | 決定記録時 | ADR自動生成 |
-| `musubix-c4-design` | 設計図作成時 | C4モデル生成 |
-| `musubix-technical-writing` | 文書作成時 | 技術文書生成 |
+| `musubix-decision-records` | ADR管理時 | ADRライフサイクル管理 |
+| `musubix-knowledge-graph` | 知識管理時 | 知識グラフ操作 |
+| `musubix-policy-engine` | ポリシー確認時 | 憲法条項検証 |
 | `musubix-best-practices` | ノウハウ整理時 | ベストプラクティス文書化 |
-| `musubix-ears-validation` | 要件検証時 | EARS構文検証 |
+| `musubix-technical-writing` | 文書作成時 | 技術文書生成 |
 
 ---
 
-## 📋 AI Agent ガイドライン
+## 学習済みベストプラクティス
+
+| ID | 名称 | 概要 | 信頼度 |
+|----|------|------|--------|
+| BP-CODE-001 | Entity Input DTO | エンティティ作成にInput DTOを使用 | 95% |
+| BP-CODE-002 | Date-based ID | PREFIX-YYYYMMDD-NNN形式ID | 90% |
+| BP-CODE-003 | Value Objects | ドメイン概念にVOを使用 | 90% |
+| BP-CODE-004 | Function-based VO | interface+factory関数でVO実装 | 95% |
+| BP-CODE-005 | Result Type | 失敗可能操作にResult<T,E>を使用 | 95% |
+| BP-DESIGN-001 | Status Transition Map | 有効遷移をMapで定義 | 95% |
+| BP-DESIGN-002 | Repository Async | async化でDB移行対応 | 85% |
+| BP-DESIGN-003 | Service Layer + DI | リポジトリDIしたService層 | 90% |
+| BP-DESIGN-004 | Optimistic Locking | version管理で同時編集検出 | 90% |
+| BP-DESIGN-005 | AuditService | 変更の監査ログ | 85% |
+| BP-DESIGN-006 | Counter Reset | テスト用resetXxxCounter() | 95% |
+| BP-DESIGN-007 | Expiry Time | expiresAtフィールドで有効期限管理 | 90% |
+| BP-TEST-001 | Test Counter Reset | beforeEachでIDリセット | 95% |
+| BP-TEST-002 | Verify API First | テスト前にAPIシグネチャ確認 | 80% |
+| BP-TEST-003 | Vitest ESM | Vitest+TypeScript ESM構成 | 85% |
+| BP-TEST-004 | Result Type Test | isOk()/isErr()で両方テスト | 95% |
+| BP-TEST-005 | Transition Testing | 有効・無効遷移を網羅テスト | 90% |
+
+---
+
+## 開発コマンド
+
+```bash
+npm install              # 依存関係インストール
+npm run build            # 全パッケージビルド (tsc -b)
+npm run test             # 全テスト
+npm run test:unit        # ユニットテスト
+npm run test:integration # 統合テスト
+npm run test:coverage    # カバレッジ計測
+npm run lint             # ESLint
+npm run lint:fix         # ESLint自動修正
+npm run typecheck        # TypeScript型チェック
+npm run format           # Prettier
+npm run format:check     # Prettierチェック
+npm run clean            # クリーンアップ
+```
+
+---
+
+## AI Agent ガイドライン
 
 ### WHEN: 新規タスク開始
 
 ```
 DO:
 1. steering/ を読んでコンテキスト把握
-2. knowledge search で既存知識確認
-3. 関連 ADR を確認
-4. 必要なスキルを特定
+2. musubix knowledge query で既存知識確認
+3. musubix decision list で関連ADR確認
+4. 必要なAgent Skillを特定
 ```
 
 ### WHEN: コード生成
 
 ```
 DO:
-1. SDD ワークフローに従う
-2. 学習済みパターンを適用
-3. テストを同時生成
-4. トレーサビリティを維持
+1. SDD ワークフローに従う (要件→設計→タスク→実装)
+2. musubix learn best-practices で学習済みパターンを確認
+3. テストを同時生成 (codegen --with-tests)
+4. musubix trace matrix でトレーサビリティ維持
 ```
 
 ### WHEN: エラー発生
@@ -264,70 +391,52 @@ DO:
 1. Result型でエラーをラップ
 2. コンテキスト情報を付加
 3. リカバリー戦略を検討
-4. 学習データとして記録
-```
-
-### WHEN: 不明点がある
-
-```
-DO:
-1. 仮定を明示して確認を求める
-2. 複数の選択肢を提示
-3. 決定事項は ADR に記録
+4. musubix learn feedback で学習データとして記録
 ```
 
 ---
 
-## 🔄 推奨ワークフロー
+## 推奨ワークフロー
+
+> **重要**: Phase 2（設計）から直接Phase 4（実装）に進むことは禁止。必ずPhase 3（タスク分解）を経ること。
 
 ```
-Phase 1: Context   │ steering/ 読込 → knowledge search → ADR確認
-        ↓
-Phase 2: Plan      │ スキル選定 → タスク分解 → 依存関係整理
-        ↓
-Phase 3: Execute   │ SDD準拠実装 → パターン適用 → テスト生成
-        ↓
-Phase 4: Verify    │ 形式検証 → トレーサビリティ確認 → レビュー
-        ↓
-Phase 5: Learn     │ Wake-Sleep → パターン抽出 → ナレッジ更新
+Phase 1: 要件定義  │ steering/読込 → requirements analyze → レビュー → 承認
+       ↓
+Phase 2: 設計      │ design generate → design validate → レビュー → 承認
+       ↓
+Phase 3: タスク分解 │ タスク定義 → 依存関係整理 → レビュー → 承認
+       ↓
+Phase 4: 実装      │ test generate(Red) → 実装(Green) → リファクタ(Blue)
+       ↓
+Phase 5: 完了      │ trace validate → CHANGELOG更新 → コミット
 ```
 
 ---
 
-## 📁 ストレージ構造
+## ストレージ構造
 
 | ディレクトリ | 用途 |
 |--------------|------|
-| `storage/learning/` | 学習データ |
-| `storage/specs/` | SDD仕様 |
-| `storage/design/` | 設計文書 |
-| `storage/changes/` | 変更履歴 |
+| `storage/specs/` | 要件(REQ-*)・設計(DES-*)・タスク(TSK-*) |
+| `storage/design/` | 設計文書・C4ダイアグラム |
+| `storage/traceability/` | トレーサビリティマトリクス |
 | `storage/reviews/` | レビュー記録 |
-| `storage/dashboard/` | メトリクス |
+| `storage/changes/` | 変更履歴 |
+| `storage/learning/` | 学習データ |
 
 ---
 
-## 🚨 重要な制約
+## 重要な制約
 
 | 制約 | 理由 |
 |------|------|
 | Node.js 20+ | ESM・最新API |
 | TypeScript strict | 型安全性 |
-| pnpm workspace | モノレポ管理 |
+| npm workspaces | モノレポ管理 |
 | Vitest | 高速テスト |
-| ESLint flat config | 統一リント |
-
----
-
-## 📞 トラブルシューティング
-
-| 症状 | 対処 |
-|------|------|
-| 依存解決エラー | `pnpm i --force` |
-| 型エラー | `pnpm build` で再ビルド |
-| テスト失敗 | `pnpm --filter <pkg> test` で個別実行 |
-| MCP接続失敗 | ポート確認、`--debug` オプション |
+| Prettier | コードフォーマット統一 |
 
 ---
 
-**最終更新**: 2025-01-29 | **バージョン**: 3.7.2
+**最終更新**: 2026-02-08 | **バージョン**: 3.8.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nahisaho/musubix-core",
-  "version": "3.8.0",
+  "version": "3.8.1",
   "description": "MUSUBIX Core Library - Neuro-Symbolic Integration Engine",
   "type": "module",
   "main": "./dist/index.js",