musubi-sdd 5.0.0 → 5.6.1

package/README.ja.md

@@ -29,13 +29,13 @@ MUSUBI（結び）は、6つの主要フレームワークのベスト機能を
 
 ## ✨ なぜMUSUBI？
 
-| 課題 | MUSUBIのソリューション |
-|------|----------------------|
-| 🔀 AIツールの分断 | **7エージェント、1つの統一ワークフロー** |
-| 📝 曖昧な要件定義 | **5パターンのEARS形式** |
-| 🔍 トレーサビリティの喪失 | **100% 要件→設計→コード→テスト追跡** |
-| ⚠️ 品質の不一致 | **9つの憲法条項 + フェーズ-1ゲート** |
-| 🔄 既存プロジェクトの課題 | **差分仕様 + 変更管理** |
+| 課題                      | MUSUBIのソリューション                   |
+| ------------------------- | ---------------------------------------- |
+| 🔀 AIツールの分断         | **7エージェント、1つの統一ワークフロー** |
+| 📝 曖昧な要件定義         | **5パターンのEARS形式**                  |
+| 🔍 トレーサビリティの喪失 | **100% 要件→設計→コード→テスト追跡**     |
+| ⚠️ 品質の不一致           | **9つの憲法条項 + フェーズ-1ゲート**     |
+| 🔄 既存プロジェクトの課題 | **差分仕様 + 変更管理**                  |
 
 ## 🚀 クイックスタート
 
@@ -71,35 +71,86 @@ musubi init --windsurf  # Windsurf IDE
 
 ---
 
-## 📊 v3.9.0 の新機能
+## 📊 v5.6.0 の新機能
 
-- 🛡️ **Guardrailsシステム** - OpenAI Agents SDK inspired 入出力検証とセーフティチェック
-- ✅ **InputGuardrail** - 入力検証、PII検出、インジェクション攻撃防止
-- ✅ **OutputGuardrail** - 出力サニタイズ、機密データ墨消し、コンテンツポリシー適用
-- ⚖️ **SafetyCheckGuardrail** - 憲法条項準拠、コンテンツ安全性分析
-- 🔧 **GuardrailRules DSL** - RuleBuilderによる検証ルール構築のFluent API
-- 🔗 **GuardrailChain** - 複数Guardrailの順次/並列実行
-- 🖥️ **CLIコマンド** - `musubi-validate guardrails` と `guardrails-chain` コマンド
+### エンタープライズスケール分析 & Rustマイグレーション支援 🏢🦀
+
+GCCコードベース（1,000万行以上、10万ファイル以上）の分析に基づく大幅な改善。
+
+#### Large Project Analyzer
+
+- **スケール認識分析**: プロジェクトサイズを自動検出し、適切な戦略を選択
+- **メモリ効率処理**: 10万ファイル以上でもチャンクベース処理とガベージコレクション
+- **多言語サポート**: JavaScript、TypeScript、C、C++、Python、Rust、Go、Java
+- **巨大関数検出**: 100行+（警告）、500行+（危険）、1000行+（極端）の関数をフラグ
+
+#### CodeGraph MCP統合
+
+- **深層コードグラフ分析**: CodeGraph MCPとの統合による関係性分析
+- **コールグラフ生成**: 設定可能な深度での呼び出し元・呼び出し先追跡
+- **影響分析**: コード変更時の影響ファイル特定
+- **ホットスポット識別**: 高接続性エンティティ（リファクタリング候補）の検出
+
+#### 拡張複雑度アナライザー
+
+- **循環的複雑度**: 標準的な決定ポイントカウント
+- **認知的複雑度**: SonarSource方式の読みやすさ測定
+- **重大度レベル**: 理想 → 警告 → 危険 → 極端の閾値
+
+#### Rustマイグレーションジェネレーター
+
+- **危険パターン検出**: C/C++メモリ安全でないパターンの特定
+- **マイグレーション優先度スコアリング**: Rust移行の自動優先順位付け
+- **セキュリティコンポーネント分析**: セキュリティ重要コードセクションのフラグ
+
+```javascript
+// エンタープライズスケールプロジェクトを分析（100,000ファイル以上）
+const { LargeProjectAnalyzer, ComplexityAnalyzer } = require('musubi-sdd');
+
+const analyzer = new LargeProjectAnalyzer('/path/to/gcc');
+const result = await analyzer.analyze();
+console.log(result.stats); // { totalFiles: 109073, ... }
+
+// コード複雑度を計算
+const complexity = new ComplexityAnalyzer();
+const score = complexity.calculateCyclomaticComplexity(code, 'javascript');
+```
+
+### 以前のバージョン (v5.5.0)
+
+- 🔗 **GitHub参照機能** - 成功したリポジトリからパターンとプラクティスを参照
+- 📦 **複数リポジトリ対応** - `-r` / `--reference` オプションで複数指定可能
+- 🔍 **パターン検出** - Clean Architecture、Hexagonal、DDD、Monorepo等を自動検出
+- 🛠️ **テクノロジー検出** - React、Vue、Next.js、TypeScript、Rust等を分析
+- 📈 **改良提案** - 参照リポジトリから改良ポイントを自動生成
+- 💾 **結果保存** - `steering/references/github-references-YYYY-MM-DD.md` に保存
 
 ```bash
-# セキュリティプリセットで入力検証
-npx musubi-validate guardrails "user input" --type input --preset security
+# 単一リポジトリ参照
+musubi init --reference facebook/react
 
-# PII墨消しで出力検証
-npx musubi-validate guardrails "output" --type output --redact
+# 複数リポジトリ参照（省略形式）
+musubi init -r vercel/next.js -r facebook/react -r denoland/deno
 
-# 憲法準拠でセーフティチェック
-npx musubi-validate guardrails "code" --type safety --constitutional --level high
+# URL形式
+musubi init --reference https://github.com/tokio-rs/tokio
 
-# Guardrailチェーンを並列実行
-npx musubi-validate guardrails-chain "content" --parallel
+# ブランチ指定
+musubi init -r owner/repo@develop
 ```
 
-### 以前のバージョン (v3.7.1)
+### 以前のバージョン (v5.3.0)
 
+- 📚 **外部仕様参照システム** - API仕様（OpenAPI）やプロトコル（GraphQL）を自動取得・統合
+- 📁 **カスタムワークスペースパス** - `--workspace` / `-w` オプションで任意ディレクトリにステアリング生成
+- 🏛️ **アーキテクチャレイヤ検出** - Clean Architecture、Hexagonal、Layered構造を自動認識
+- 📦 **依存関係ファイル検出** - 6エコシステム対応（Node.js、Python、Rust、Go、Java、Ruby）
+- 🎯 **参照アーキテクチャパターン** - 事前定義パターン適用（`--pattern` オプション）
+
+### 以前のバージョン (v3.9.0)
+
+- 🛡️ **Guardrailsシステム** - 入出力検証とセーフティチェック
 - 🌐 **WebSocketリアルタイムGUI** - `musubi-browser`ダッシュボードでライブ更新
-- 📋 **GUIクイックアクション** - 新規要件モーダル、プロジェクト検証、レポートエクスポート
-- 🔄 **GitHub Actions統合** - `musubi-action`でCI/CD検証
 - 🔧 **OpenAPIコンバーター** - OpenAPI 3.x/Swagger 2.xスペックをMUSUBI形式に変換
 - 🌍 **多言語テンプレート** - 7言語対応（EN, JA, ZH, KO, ES, DE, FR）
 - 🤖 **Ollama統合** - 9つのモデルプリセットでローカルLLMをサポート
@@ -137,15 +188,15 @@ npx musubi-validate guardrails-chain "content" --parallel
 
 MUSUBIは7つのAIコーディングエージェントに対応し、それぞれに最適化された設定を提供します。
 
-| エージェント | スキルAPI | 25エージェント | コマンド形式 | コマンドファイル形式 | インストールディレクトリ |
-|-------|-----------|-----------|----------------|---------------------|----------------------|
-| **Claude Code** | ✅ (25スキル) | ✅ | `/sdd-*` | Markdown | `.claude/skills/`, `.claude/commands/` |
-| **GitHub Copilot** | ❌ | ✅ (AGENTS.md) | `#sdd-*` | Markdown + AGENTS.md | `.github/prompts/`, `.github/AGENTS.md` |
-| **Cursor IDE** | ❌ | ✅ (AGENTS.md) | `/sdd-*` | Markdown + AGENTS.md | `.cursor/commands/`, `.cursor/AGENTS.md` |
-| **Gemini CLI** | ❌ | ✅ (GEMINI.md) | `/sdd-*` | TOML + GEMINI.md | `.gemini/commands/`, `GEMINI.md` |
-| **Codex CLI** | ❌ | ✅ (AGENTS.md) | `/prompts:sdd-*` | Markdown + AGENTS.md | `.codex/prompts/`, `.codex/AGENTS.md` |
-| **Qwen Code** | ❌ | ✅ (AGENTS.md) | `/sdd-*` | Markdown + AGENTS.md | `.qwen/commands/`, `.qwen/AGENTS.md` |
-| **Windsurf IDE** | ❌ | ✅ (AGENTS.md) | `/sdd-*` | Markdown + AGENTS.md | `.windsurf/workflows/`, `.windsurf/AGENTS.md` |
+| エージェント       | スキルAPI     | 25エージェント | コマンド形式     | コマンドファイル形式 | インストールディレクトリ                      |
+| ------------------ | ------------- | -------------- | ---------------- | -------------------- | --------------------------------------------- |
+| **Claude Code**    | ✅ (25スキル) | ✅             | `/sdd-*`         | Markdown             | `.claude/skills/`, `.claude/commands/`        |
+| **GitHub Copilot** | ❌            | ✅ (AGENTS.md) | `#sdd-*`         | Markdown + AGENTS.md | `.github/prompts/`, `.github/AGENTS.md`       |
+| **Cursor IDE**     | ❌            | ✅ (AGENTS.md) | `/sdd-*`         | Markdown + AGENTS.md | `.cursor/commands/`, `.cursor/AGENTS.md`      |
+| **Gemini CLI**     | ❌            | ✅ (GEMINI.md) | `/sdd-*`         | TOML + GEMINI.md     | `.gemini/commands/`, `GEMINI.md`              |
+| **Codex CLI**      | ❌            | ✅ (AGENTS.md) | `/prompts:sdd-*` | Markdown + AGENTS.md | `.codex/prompts/`, `.codex/AGENTS.md`         |
+| **Qwen Code**      | ❌            | ✅ (AGENTS.md) | `/sdd-*`         | Markdown + AGENTS.md | `.qwen/commands/`, `.qwen/AGENTS.md`          |
+| **Windsurf IDE**   | ❌            | ✅ (AGENTS.md) | `/sdd-*`         | Markdown + AGENTS.md | `.windsurf/workflows/`, `.windsurf/AGENTS.md` |
 
 **注意事項**：
 
@@ -689,6 +740,7 @@ THEN システムSHALLユーザーを認証する
 AND システムSHALLセッションを作成する。
 
 #### シナリオ: ログイン成功
+
 - WHEN ユーザーが正しいメールアドレスとパスワードを入力する
 - THEN システムSHALL認証情報を検証する
 - AND システムSHALLダッシュボードにリダイレクトする
@@ -730,17 +782,23 @@ AND システムSHALLセッションを作成する。
 
 ```markdown
 ## 追加された要件
+
 ### REQ-NEW-001: 二要素認証
+
 ...
 
 ## 変更された要件
+
 ### REQ-001: ユーザー認証
+
 **以前**: メール + パスワード
 **更新後**: メール + パスワード + OTP
 ...
 
 ## 削除された要件
+
 ### REQ-OLD-005: ログイン状態を記憶
+
 **理由**: セキュリティポリシーの変更
 ```
 
@@ -863,22 +921,22 @@ init_graphツールを使ってこのコードベースを分析してくださ
 
 **利用可能なMCPツール（14ツール）**:
 
-| カテゴリ | ツール | 説明 |
-|----------|-------|-------------|
-| コードグラフ | `init_graph`, `get_code_snippet`, `find_callers`, `find_dependencies` | コードグラフの構築とクエリ |
-| 検索 | `local_search`, `global_search`, `query_codebase` | GraphRAG駆動セマンティック検索 |
-| 分析 | `analyze_module_structure`, `suggest_refactoring` | コード構造分析 |
-| ナビゲーション | `jump_to_definition`, `find_implementations` | コードナビゲーション |
+| カテゴリ       | ツール                                                                | 説明                           |
+| -------------- | --------------------------------------------------------------------- | ------------------------------ |
+| コードグラフ   | `init_graph`, `get_code_snippet`, `find_callers`, `find_dependencies` | コードグラフの構築とクエリ     |
+| 検索           | `local_search`, `global_search`, `query_codebase`                     | GraphRAG駆動セマンティック検索 |
+| 分析           | `analyze_module_structure`, `suggest_refactoring`                     | コード構造分析                 |
+| ナビゲーション | `jump_to_definition`, `find_implementations`                          | コードナビゲーション           |
 
 **エージェント × MCPツールマッピング**:
 
-| エージェント | 主要MCPツール | 用途 |
-|-------|-------------------|----------|
-| @change-impact-analyzer | `find_dependencies`, `find_callers` | 影響分析 |
-| @traceability-auditor | `query_codebase`, `find_callers` | トレーサビリティ検証 |
-| @system-architect | `analyze_module_structure`, `global_search` | アーキテクチャ分析 |
-| @code-reviewer | `suggest_refactoring`, `get_code_snippet` | コード品質レビュー |
-| @security-auditor | `find_callers`, `query_codebase` | セキュリティ脆弱性検出 |
+| エージェント            | 主要MCPツール                               | 用途                   |
+| ----------------------- | ------------------------------------------- | ---------------------- |
+| @change-impact-analyzer | `find_dependencies`, `find_callers`         | 影響分析               |
+| @traceability-auditor   | `query_codebase`, `find_callers`            | トレーサビリティ検証   |
+| @system-architect       | `analyze_module_structure`, `global_search` | アーキテクチャ分析     |
+| @code-reviewer          | `suggest_refactoring`, `get_code_snippet`   | コード品質レビュー     |
+| @security-auditor       | `find_callers`, `query_codebase`            | セキュリティ脆弱性検出 |
 
 その他のMCPサーバーとも統合：
 

package/README.md

@@ -29,13 +29,13 @@ MUSUBI (結び - "connection/binding") is a comprehensive **Specification Driven
 
 ## ✨ Why MUSUBI?
 
-| Challenge | MUSUBI Solution |
-|-----------|-----------------|
-| 🔀 Fragmented AI tools | **7 agents, 1 unified workflow** |
-| 📝 Ambiguous requirements | **EARS format with 5 patterns** |
-| 🔍 Lost traceability | **100% Req→Design→Code→Test mapping** |
-| ⚠️ Quality inconsistency | **9 Constitutional Articles + Phase -1 Gates** |
-| 🔄 Brownfield challenges | **Delta specs + Change management** |
+| Challenge                 | MUSUBI Solution                                |
+| ------------------------- | ---------------------------------------------- |
+| 🔀 Fragmented AI tools    | **7 agents, 1 unified workflow**               |
+| 📝 Ambiguous requirements | **EARS format with 5 patterns**                |
+| 🔍 Lost traceability      | **100% Req→Design→Code→Test mapping**          |
+| ⚠️ Quality inconsistency  | **9 Constitutional Articles + Phase -1 Gates** |
+| 🔄 Brownfield challenges  | **Delta specs + Change management**            |
 
 ## 🚀 Quick Start
 
@@ -71,9 +71,79 @@ musubi init --windsurf  # Windsurf IDE
 
 ---
 
-## 📊 What's New in v5.0.0
+## 📊 What's New in v5.6.0
+
+### Enterprise-Scale Analysis & Rust Migration Support 🏢🦀
+
+Major improvements based on analysis of GCC codebase (10+ million lines, 100,000+ files).
+
+#### Large Project Analyzer
+
+- **Scale-aware analysis**: Automatically detects project size and selects appropriate strategy
+- **Memory-efficient processing**: Chunk-based processing with garbage collection for 100K+ files
+- **Multi-language support**: JavaScript, TypeScript, C, C++, Python, Rust, Go, Java
+- **Giant function detection**: Flags functions with 100+ (warning), 500+ (critical), 1000+ (extreme) lines
+
+#### CodeGraph MCP Integration
+
+- **Deep code graph analysis**: Integration with CodeGraph MCP for relationship analysis
+- **Call graph generation**: Track callers and callees with configurable depth
+- **Impact analysis**: Identify affected files when code changes
+- **Hotspot identification**: Detect highly-connected entities (refactoring candidates)
+
+#### Enhanced Complexity Analyzer
+
+- **Cyclomatic complexity**: Standard decision-point counting
+- **Cognitive complexity**: SonarSource-style readability measurement
+- **Severity levels**: Ideal → Warning → Critical → Extreme thresholds
+
+#### Rust Migration Generator
+
+- **Unsafe pattern detection**: Identify C/C++ memory-unsafe patterns
+- **Migration priority scoring**: Automatic prioritization for Rust migration
+- **Security component analysis**: Flag security-critical code sections
+
+```javascript
+// Analyze enterprise-scale projects (100,000+ files)
+const { LargeProjectAnalyzer, ComplexityAnalyzer } = require('musubi-sdd');
+
+const analyzer = new LargeProjectAnalyzer('/path/to/gcc');
+const result = await analyzer.analyze();
+console.log(result.stats); // { totalFiles: 109073, ... }
+
+// Calculate code complexity
+const complexity = new ComplexityAnalyzer();
+const score = complexity.calculateCyclomaticComplexity(code, 'javascript');
+```
+
+### v5.4.0: GitHub Reference & Repository Analysis 📦
+
+- 🔗 **`--reference` / `-r` Option** - Reference multiple GitHub repositories for pattern analysis
+- 📊 **Repository Analysis** - Fetch metadata, structure, and key files via GitHub API
+- 🏗️ **Pattern Detection** - Clean Architecture, Hexagonal, DDD, Monorepo patterns
+- 💡 **Improvement Suggestions** - Architecture and technology recommendations
+- 📁 **Analysis Output** - Saved to `steering/references/github-references-YYYY-MM-DD.md`
+
+```bash
+# Reference multiple repositories for improvement suggestions
+musubi init -r facebook/react -r vercel/next.js -r denoland/deno
+
+# With branch specification
+musubi init --reference tokio-rs/tokio@main
+
+# Full URL format
+musubi init --reference https://github.com/rust-lang/rust
+```
+
+### v5.3.0: Multi-Language Support 🌐
+
+- 🔄 **Technology Stack Selection** - Single, Multiple, Undecided, or Help me decide
+- 🤖 **Language Recommendation Engine** - AI-powered suggestions based on app type, performance needs, team expertise
+- 🌍 **10 Languages Supported** - JS/TS, Python, Rust, Go, Java, C#, C++, Swift, Ruby, PHP
+- 📄 **Dynamic tech.md** - Language-specific templates with frameworks and tools
+
+### v5.0.0: Phase 5 Advanced Features 🚀
 
-### Phase 5: Advanced Features 🚀
 - 🔄 **Steering Auto-Update** - Automatic project memory synchronization with 5 trigger types
 - ✅ **Steering Validator** - Comprehensive validation for steering documents
 - 📋 **Template Constraints** - Enforce structure requirements with ThinkingChecklist
@@ -81,7 +151,8 @@ musubi init --windsurf  # Windsurf IDE
 - 🔍 **Advanced Validation** - Cross-artifact consistency, gap detection, traceability validation
 - 🎯 **Phase 5 Integration** - Unified access to all advanced features
 
-### Phase 4: Agent Loop & Agentic Features 🤖
+### v4.0.0: Phase 4 Agent Loop & Agentic Features 🤖
+
 - 🧠 **Codebase Intelligence** - RepositoryMap, ASTExtractor, ContextOptimizer
 - 💭 **Agentic Reasoning** - ReasoningEngine, PlanningEngine, SelfCorrection
 - ⚡ **Code Generation** - CodeGenerator, CodeReviewer with multiple modes
@@ -165,15 +236,15 @@ const result = await validator.validateAll(projectPath);
 
 MUSUBI supports 7 AI coding agents, each with tailored configurations:
 
-| Agent | Skills API | 25 Agents | Command Format | Command File Format | Installation Directory |
-|-------|-----------|-----------|----------------|---------------------|----------------------|
-| **Claude Code** | ✅ (25 skills) | ✅ | `/sdd-*` | Markdown | `.claude/skills/`, `.claude/commands/` |
-| **GitHub Copilot** | ❌ | ✅ (AGENTS.md) | `#sdd-*` | Markdown + AGENTS.md | `.github/prompts/`, `.github/AGENTS.md` |
-| **Cursor IDE** | ❌ | ✅ (AGENTS.md) | `/sdd-*` | Markdown + AGENTS.md | `.cursor/commands/`, `.cursor/AGENTS.md` |
-| **Gemini CLI** | ❌ | ✅ (GEMINI.md) | `/sdd-*` | TOML + GEMINI.md | `.gemini/commands/`, `GEMINI.md` |
-| **Codex CLI** | ❌ | ✅ (AGENTS.md) | `/prompts:sdd-*` | Markdown + AGENTS.md | `.codex/prompts/`, `.codex/AGENTS.md` |
-| **Qwen Code** | ❌ | ✅ (AGENTS.md) | `/sdd-*` | Markdown + AGENTS.md | `.qwen/commands/`, `.qwen/AGENTS.md` |
-| **Windsurf IDE** | ❌ | ✅ (AGENTS.md) | `/sdd-*` | Markdown + AGENTS.md | `.windsurf/workflows/`, `.windsurf/AGENTS.md` |
+| Agent              | Skills API     | 25 Agents      | Command Format   | Command File Format  | Installation Directory                        |
+| ------------------ | -------------- | -------------- | ---------------- | -------------------- | --------------------------------------------- |
+| **Claude Code**    | ✅ (25 skills) | ✅             | `/sdd-*`         | Markdown             | `.claude/skills/`, `.claude/commands/`        |
+| **GitHub Copilot** | ❌             | ✅ (AGENTS.md) | `#sdd-*`         | Markdown + AGENTS.md | `.github/prompts/`, `.github/AGENTS.md`       |
+| **Cursor IDE**     | ❌             | ✅ (AGENTS.md) | `/sdd-*`         | Markdown + AGENTS.md | `.cursor/commands/`, `.cursor/AGENTS.md`      |
+| **Gemini CLI**     | ❌             | ✅ (GEMINI.md) | `/sdd-*`         | TOML + GEMINI.md     | `.gemini/commands/`, `GEMINI.md`              |
+| **Codex CLI**      | ❌             | ✅ (AGENTS.md) | `/prompts:sdd-*` | Markdown + AGENTS.md | `.codex/prompts/`, `.codex/AGENTS.md`         |
+| **Qwen Code**      | ❌             | ✅ (AGENTS.md) | `/sdd-*`         | Markdown + AGENTS.md | `.qwen/commands/`, `.qwen/AGENTS.md`          |
+| **Windsurf IDE**   | ❌             | ✅ (AGENTS.md) | `/sdd-*`         | Markdown + AGENTS.md | `.windsurf/workflows/`, `.windsurf/AGENTS.md` |
 
 **Notes**:
 
@@ -886,6 +957,7 @@ THEN the system SHALL authenticate the user
 AND the system SHALL create a session.
 
 #### Scenario: Successful login
+
 - WHEN user enters correct email and password
 - THEN system SHALL verify credentials
 - AND system SHALL redirect to dashboard
@@ -927,17 +999,23 @@ AND the system SHALL create a session.
 
 ```markdown
 ## ADDED Requirements
+
 ### REQ-NEW-001: Two-Factor Authentication
+
 ...
 
 ## MODIFIED Requirements
+
 ### REQ-001: User Authentication
+
 **Previous**: Email + password
 **Updated**: Email + password + OTP
 ...
 
 ## REMOVED Requirements
+
 ### REQ-OLD-005: Remember Me
+
 **Reason**: Security policy change
 ```
 
@@ -1060,22 +1138,22 @@ If successful, you'll see the code graph initialization output.
 
 **Available MCP Tools (14 tools)**:
 
-| Category | Tools | Description |
-|----------|-------|-------------|
-| Code Graph | `init_graph`, `get_code_snippet`, `find_callers`, `find_dependencies` | Build and query code graph |
-| Search | `local_search`, `global_search`, `query_codebase` | GraphRAG-powered semantic search |
-| Analysis | `analyze_module_structure`, `suggest_refactoring` | Code structure analysis |
-| Navigation | `jump_to_definition`, `find_implementations` | Code navigation |
+| Category   | Tools                                                                 | Description                      |
+| ---------- | --------------------------------------------------------------------- | -------------------------------- |
+| Code Graph | `init_graph`, `get_code_snippet`, `find_callers`, `find_dependencies` | Build and query code graph       |
+| Search     | `local_search`, `global_search`, `query_codebase`                     | GraphRAG-powered semantic search |
+| Analysis   | `analyze_module_structure`, `suggest_refactoring`                     | Code structure analysis          |
+| Navigation | `jump_to_definition`, `find_implementations`                          | Code navigation                  |
 
 **Agent × MCP Tool Mapping**:
 
-| Agent | Primary MCP Tools | Use Case |
-|-------|-------------------|----------|
-| @change-impact-analyzer | `find_dependencies`, `find_callers` | Impact analysis |
-| @traceability-auditor | `query_codebase`, `find_callers` | Traceability validation |
-| @system-architect | `analyze_module_structure`, `global_search` | Architecture analysis |
-| @code-reviewer | `suggest_refactoring`, `get_code_snippet` | Code quality review |
-| @security-auditor | `find_callers`, `query_codebase` | Security vulnerability detection |
+| Agent                   | Primary MCP Tools                           | Use Case                         |
+| ----------------------- | ------------------------------------------- | -------------------------------- |
+| @change-impact-analyzer | `find_dependencies`, `find_callers`         | Impact analysis                  |
+| @traceability-auditor   | `query_codebase`, `find_callers`            | Traceability validation          |
+| @system-architect       | `analyze_module_structure`, `global_search` | Architecture analysis            |
+| @code-reviewer          | `suggest_refactoring`, `get_code_snippet`   | Code quality review              |
+| @security-auditor       | `find_callers`, `query_codebase`            | Security vulnerability detection |
 
 Also integrates with other MCP servers: