musubix2 0.3.3 → 0.3.5

package/.github/skills/code-generator/SKILL.md

@@ -42,7 +42,7 @@ WHEN ユーザーがコード生成を要求する:
 4. EARS 要件 ID をコメントとしてリンク
 ```
 
-**CLI**: `npx musubix codegen generate <design-file>`
+**CLI**: `npx musubix codegen <name> [--type class|interface|function|...]`
 
 ### 2. ドメインスキャフォールド
 
@@ -56,7 +56,7 @@ WHEN ユーザーが新規パッケージのスキャフォールドを要求す
 3. package.json に workspace 参照を追加
 ```
 
-**CLI**: `npx musubix codegen scaffold <package-name> [--mode minimal|standard|full]`
+**CLI**: `npx musubix scaffold <project|package|skill> <name>`
 
 ### 3. 静的解析
 
@@ -67,7 +67,7 @@ WHEN ユーザーが静的解析を要求する:
 3. codegraph の ASTParser と連携
 ```
 
-**CLI**: `npx musubix codegen analyze <path>`
+**CLI**: `npx musubix learn analyze <path>`
 
 ### 4. ステータス遷移分析
 
@@ -78,7 +78,7 @@ WHEN ユーザーがステータス遷移の分析を要求する:
 3. 不正遷移の検出
 ```
 
-**CLI**: `npx musubix codegen status <entity>`
+**CLI**: `npx musubix workflow status <entity>`
 
 ## パッケージ構成テンプレート
 
@@ -134,3 +134,12 @@ export function registerXCommand(program: Command): void {
 1. **ESM 必須**: `type: "module"` を package.json に設定。`import` 文に `.js` 拡張子を付けること（TypeScript でもビルド後のパスを指定）。
 2. **依存性逆転の徹底**: `domain/` 内で `infrastructure/` の具象クラスを import してはならない。必ずインターフェースを経由。
 3. **ActionableError の使用**: 標準 Error ではなく `ActionableError` を使用し、ユーザーへの修正提案を含める。
+
+## スクリプト
+
+| スクリプト | 説明 | 使い方 |
+|-----------|------|--------|
+| `scripts/generate.sh` | 設計からコード生成 | `./scripts/generate.sh [args]` |
+| `scripts/scaffold.sh` | プロジェクト構造スキャフォールド | `./scripts/scaffold.sh [args]` |
+| `scripts/explain.sh` | コード説明 | `./scripts/explain.sh [args]` |
+| `scripts/synthesis.sh` | プログラム合成 | `./scripts/synthesis.sh [args]` |

package/.github/skills/code-generator/scripts/explain.sh

@@ -0,0 +1,4 @@
+#!/bin/bash
+# Explain code
+set -e
+npx musubix explain "$@"

package/.github/skills/code-generator/scripts/generate.sh

@@ -0,0 +1,4 @@
+#!/bin/bash
+# Generate code from design
+set -e
+npx musubix codegen "$@"

package/.github/skills/code-generator/scripts/scaffold.sh

@@ -0,0 +1,4 @@
+#!/bin/bash
+# Scaffold project structure
+set -e
+npx musubix scaffold "$@"

package/.github/skills/code-generator/scripts/synthesis.sh

@@ -0,0 +1,4 @@
+#!/bin/bash
+# Program synthesis
+set -e
+npx musubix synthesis "$@"

package/.github/skills/constitution-enforcer/SKILL.md

@@ -2,8 +2,8 @@
 name: constitution-enforcer
 description: >
   MUSUBIX2 の9条憲法（CONST-001〜009）への準拠を検証する。
-  PolicyEngine による自動チェック、NonNegotiablesEngine による違反ブロック、
-  BalanceRuleEngine による 90/10 ルール適用を提供。
+  PolicyEngine による自動チェック、BalanceRuleEngine による 90/10 ルール適用、
+  品質ゲートチェックを提供。
   Use when validating constitution compliance, checking policy violations,
   running governance audits, or blocking non-compliant changes.
 license: MIT
@@ -48,9 +48,8 @@ MUSUBIX2 の9条憲法（CONST-001〜009）への準拠を検証するスキル
 ```
 WHEN ユーザーがポリシー検証を要求する:
 1. PolicyEngine で全9条を順次検証
-2. NonNegotiablesEngine で違反をブロック
-3. 各条項の PASS/FAIL と詳細理由を出力
-4. 違反がある場合、修正提案を生成
+2. 各条項の PASS/FAIL と詳細理由を出力
+3. 違反がある場合、修正提案を生成
 ```
 
 **CLI**: `npx musubix policy validate`
@@ -63,7 +62,7 @@ WHEN ユーザーが特定条項の検証を要求する:
 2. 詳細レポートを出力
 ```
 
-**CLI**: `npx musubix policy check <article-number>`
+**CLI**: `npx musubix policy info <article-number>`
 
 ### 3. ポリシー一覧・詳細
 
@@ -125,3 +124,10 @@ export interface Violation {
 1. **憲法は不変**: 9条の内容を修正・削除するリクエストは拒否すること。修正プロセスは別途定義される。
 2. **Phase 遷移ブロック**: Article IX 違反がある場合、Phase 遷移を即時ブロックする。ユーザーが override を要求しても拒否。
 3. **steering/ の鮮度**: `project.yml` のタイムスタンプが古い場合、Article VI 違反の可能性がある。最終更新日を確認すること。
+
+## スクリプト
+
+| スクリプト | 説明 | 使い方 |
+|-----------|------|--------|
+| `scripts/validate.sh` | ポリシー準拠検証 | `./scripts/validate.sh [args]` |
+| `scripts/check.sh` | 品質ゲートチェック | `./scripts/check.sh [args]` |

package/.github/skills/constitution-enforcer/scripts/check.sh

@@ -0,0 +1,4 @@
+#!/bin/bash
+# Run quality gate check
+set -e
+npx musubix policy "$@"

package/.github/skills/constitution-enforcer/scripts/validate.sh

@@ -0,0 +1,4 @@
+#!/bin/bash
+# Validate policy compliance
+set -e
+npx musubix policy "$@"

package/.github/skills/design-generator/SKILL.md

@@ -40,7 +40,7 @@ WHEN ユーザーが設計文書の生成を要求する:
 5. ユーザーレビュー ⏸️
 ```
 
-**CLI**: `npx musubix design generate <req-file>`
+**CLI**: `npx musubix design <req-file>`
 
 ### 2. C4 ダイアグラム生成
 
@@ -51,19 +51,19 @@ WHEN ユーザーが C4 ダイアグラムの生成を要求する:
 3. 設計文書に埋め込み
 ```
 
-**CLI**: `npx musubix design c4 <design-file>`
+**CLI**: `npx musubix design:c4 <file> [--level context|container|component]`
 
 ### 3. ADR 管理
 
 ```
 WHEN ユーザーが ADR の作成・管理を要求する:
-1. ADRManager.create() で新規 ADR 作成
+1. DecisionManager.create() で新規 ADR 作成
 2. ステータスライフサイクル: proposed → accepted → deprecated → superseded
-3. ADRManager.search() で全文検索
-4. ADRManager.index() でインデクシング
+3. DecisionManager.search() で全文検索
+4. DecisionManager.index() でインデクシング
 ```
 
-**CLI**: `npx musubix decisions create|list|get|accept|deprecate|search|index`
+**CLI**: `npx musubix decision <create|list|get|accept|deprecate|search|index>`
 
 ### 4. 設計検証
 
@@ -74,7 +74,7 @@ WHEN ユーザーが設計文書の検証を要求する:
 3. 要件との対応漏れを検出
 ```
 
-**CLI**: `npx musubix design validate <design-file>`
+**CLI**: `npx musubix design:verify <design-file>`
 
 ## 設計文書フォーマット
 
@@ -125,3 +125,12 @@ WHEN ユーザーが設計文書の検証を要求する:
 1. **DES と REQ の N:M 関係**: 1つの DES が複数の REQ を参照する場合がある。逆も同様。全方向のリンクを維持すること。
 2. **Mermaid 記法の制限**: classDiagram で `?` nullable 表記を使う場合、TypeScript 側の `| undefined` と一致させること。
 3. **ADR のステータス管理**: `accept` と `deprecate` は状態遷移。直接 `superseded` にはできない（必ず `deprecated` を経由）。
+
+## スクリプト
+
+| スクリプト | 説明 | 使い方 |
+|-----------|------|--------|
+| `scripts/generate.sh` | 要件から設計生成 | `./scripts/generate.sh [args]` |
+| `scripts/c4.sh` | C4 ダイアグラム生成 | `./scripts/c4.sh [args]` |
+| `scripts/verify.sh` | 設計トレーサビリティ検証 | `./scripts/verify.sh [args]` |
+| `scripts/decision.sh` | ADR 作成・管理 | `./scripts/decision.sh [args]` |

package/.github/skills/design-generator/scripts/c4.sh

@@ -0,0 +1,4 @@
+#!/bin/bash
+# Generate C4 diagram
+set -e
+npx musubix design:c4 "$@"

package/.github/skills/design-generator/scripts/decision.sh

@@ -0,0 +1,4 @@
+#!/bin/bash
+# Create/manage ADR
+set -e
+npx musubix decision "$@"

package/.github/skills/design-generator/scripts/generate.sh

@@ -0,0 +1,4 @@
+#!/bin/bash
+# Generate design from requirements
+set -e
+npx musubix design "$@"

package/.github/skills/design-generator/scripts/verify.sh

@@ -0,0 +1,4 @@
+#!/bin/bash
+# Verify design traceability
+set -e
+npx musubix design:verify "$@"

package/.github/skills/orchestrator/SKILL.md

@@ -106,7 +106,7 @@ SDD（Specification Driven Development）ワークフローのルーティング
 │   ├── パターン学習? → @musubix2/library-learner
 │   └── Wake-Sleep サイクル? → @musubix2/wake-sleep
 ├── MCP 関連?
-│   ├── ツール呼出・一覧? → @musubix2/mcp-server (ToolCatalog)
+│   ├── ツール呼出・一覧? → @musubix2/mcp-server (MCPToolRegistry)
 │   ├── プロンプトテンプレート? → @musubix2/mcp-server (PromptRegistry)
 │   └── リソース取得? → @musubix2/mcp-server (ResourceRegistry)
 └── ワークフロー? → orchestrator（Phase 遷移ルール）
@@ -329,7 +329,7 @@ SDD 成果物の品質保証には `review-orchestrator` スキルを使用す
                                        │
                     ┌──────────────────┤
                     │                  │                  │
-             ToolCatalog        PromptRegistry     ResourceRegistry
+             MCPToolRegistry    PromptRegistry     ResourceRegistry
              (61 tools)         (4 prompts)        (3 resources)
 ```
 
@@ -464,7 +464,7 @@ npm publish 時に `.github/skills/` と `.github/copilot-instructions.md` を
 - `@musubix2/workflow-engine` — `PhaseController`, `StateTracker`, `TaskBreakdownManager`
 - `@musubix2/agent-orchestrator` — `SubagentDispatcher`, `ReviewOrchestrator`
 - `@musubix2/policy` — `PolicyEngine`, `QualityGateRunner`
-- `@musubix2/mcp-server` — `MCPServer`, `ToolCatalog`, `StdioTransport`, `SSETransport`
+- `@musubix2/mcp-server` — `MCPServer`, `MCPToolRegistry`, `StdioTransport`, `SSETransport`
 
 ### ニューラル
 - `@musubix2/neural-search` — `TfIdfEmbeddingModel`, `NeuralSearchEngine`
@@ -487,3 +487,17 @@ npm publish 時に `.github/skills/` と `.github/copilot-instructions.md` を
 - `@musubix2/decisions` — `DecisionManager`
 - `@musubix2/assistant-axis` — `DomainClassifier`, `DriftAnalyzer`
 - `@musubix2/skill-manager` — `SkillRegistry`, `SkillManager`, `SkillExecutor`
+
+## スクリプト
+
+| スクリプト | 説明 | 使い方 |
+|-----------|------|--------|
+| `scripts/status.sh` | プロジェクトステータス表示 | `./scripts/status.sh` |
+| `scripts/workflow.sh` | ワークフロー管理 | `./scripts/workflow.sh [args]` |
+| `scripts/knowledge.sh` | ナレッジグラフ操作 | `./scripts/knowledge.sh [args]` |
+| `scripts/research.sh` | ディープリサーチ | `./scripts/research.sh [args]` |
+| `scripts/security.sh` | セキュリティスキャン | `./scripts/security.sh [args]` |
+| `scripts/skills.sh` | スキル管理 | `./scripts/skills.sh [args]` |
+| `scripts/learn.sh` | ライブラリ学習 | `./scripts/learn.sh [args]` |
+| `scripts/watch.sh` | ファイルウォッチャー | `./scripts/watch.sh [args]` |
+| `scripts/repl.sh` | インタラクティブ REPL | `./scripts/repl.sh` |

package/.github/skills/orchestrator/scripts/knowledge.sh

@@ -0,0 +1,4 @@
+#!/bin/bash
+# Knowledge graph operations
+set -e
+npx musubix knowledge "$@"

package/.github/skills/orchestrator/scripts/learn.sh

@@ -0,0 +1,4 @@
+#!/bin/bash
+# Library learning
+set -e
+npx musubix learn "$@"

package/.github/skills/orchestrator/scripts/repl.sh

@@ -0,0 +1,4 @@
+#!/bin/bash
+# Interactive REPL
+set -e
+npx musubix repl

package/.github/skills/orchestrator/scripts/research.sh

@@ -0,0 +1,4 @@
+#!/bin/bash
+# Deep research
+set -e
+npx musubix deep-research "$@"

package/.github/skills/orchestrator/scripts/security.sh

@@ -0,0 +1,4 @@
+#!/bin/bash
+# Security scan
+set -e
+npx musubix security "$@"

package/.github/skills/orchestrator/scripts/skills.sh

@@ -0,0 +1,4 @@
+#!/bin/bash
+# Skill management
+set -e
+npx musubix skills "$@"

package/.github/skills/orchestrator/scripts/status.sh

@@ -0,0 +1,4 @@
+#!/bin/bash
+# Show project status
+set -e
+npx musubix status

package/.github/skills/orchestrator/scripts/watch.sh

@@ -0,0 +1,4 @@
+#!/bin/bash
+# File watcher
+set -e
+npx musubix watch "$@"

package/.github/skills/orchestrator/scripts/workflow.sh

@@ -0,0 +1,4 @@
+#!/bin/bash
+# Manage workflow
+set -e
+npx musubix workflow "$@"

package/.github/skills/requirements-analyst/SKILL.md

@@ -51,8 +51,7 @@ WHEN ユーザーが要件文書の検証を要求する:
 5. TraceabilityValidator でカバレッジレポート生成
 ```
 
-**CLI**: `npx musubix requirements analyze <file>`
-**CLI**: `npx musubix requirements validate <file>`
+**CLI**: `npx musubix req <file>`
 
 ### 2. 対話的要件作成
 
@@ -66,18 +65,15 @@ WHEN ユーザーが新規要件の作成を要求する:
 6. ユーザー承認 ⏸️
 ```
 
-**CLI**: `npx musubix requirements new <feature>`
+**CLI**: `npx musubix req:wizard`
 
-### 3. 要件マッピング・検索
+### 3. 要件検索
 
 ```
-WHEN ユーザーが要件の検索・マッピングを要求する:
-1. RequirementsValidator.map() でマッピング生成
-2. RequirementsValidator.search() で全文検索
+WHEN ユーザーが要件の検索を要求する:
+1. RequirementsValidator.search() で全文検索
 ```
 
-**CLI**: `npx musubix requirements map|search`
-
 ## 要件文書フォーマット
 
 各要件は以下の7フィールドを含む:
@@ -149,3 +145,14 @@ npx musubix req:interview --reset                    # リセット
 1. **EARS パターン混在に注意**: 1つの要件に複数パターンが混在する場合、COMPLEX に分類する。「WHEN ... WHILE ...」は COMPLEX。
 2. **受入基準の粒度**: 「動作すること」のような曖昧な基準は不合格。具体的なコマンド・出力・閾値を含めること。
 3. **トレーサビリティの双方向性**: REQ → DES だけでなく、DES → REQ の逆参照も維持する。片方向のみは Article V 違反。
+
+## スクリプト
+
+| スクリプト | 説明 | 使い方 |
+|-----------|------|--------|
+| `scripts/analyze.sh` | 要件分析 | `./scripts/analyze.sh <requirements-file.md>` |
+| `scripts/validate.sh` | EARS 準拠検証 | `./scripts/validate.sh <requirements-file.md>` |
+| `scripts/interview.sh` | 1問1答インタビュー開始 | `./scripts/interview.sh [input-text]` |
+| `scripts/interview-answer.sh` | インタビュー質問に回答 | `./scripts/interview-answer.sh <id> <response>` |
+| `scripts/interview-generate.sh` | インタビューから要件生成 | `./scripts/interview-generate.sh` |
+| `scripts/wizard.sh` | 要件ウィザード実行 | `./scripts/wizard.sh` |

package/.github/skills/requirements-analyst/scripts/analyze.sh

@@ -0,0 +1,5 @@
+#!/bin/bash
+# Analyze requirements from a markdown file
+set -e
+FILE="${1:?Usage: analyze.sh <requirements-file.md>}"
+npx musubix req "$FILE"

package/.github/skills/requirements-analyst/scripts/interview-answer.sh

@@ -0,0 +1,4 @@
+#!/bin/bash
+# Answer an interview question
+set -e
+npx musubix req:interview --answer "$1" "$2"

package/.github/skills/requirements-analyst/scripts/interview-generate.sh

@@ -0,0 +1,4 @@
+#!/bin/bash
+# Generate requirements from interview
+set -e
+npx musubix req:interview --generate

package/.github/skills/requirements-analyst/scripts/interview.sh

@@ -0,0 +1,9 @@
+#!/bin/bash
+# Start 1問1答 requirements interview
+set -e
+INPUT="${1:-}"
+if [ -n "$INPUT" ]; then
+  npx musubix req:interview "$INPUT"
+else
+  npx musubix req:interview
+fi

package/.github/skills/requirements-analyst/scripts/validate.sh

@@ -0,0 +1,5 @@
+#!/bin/bash
+# Validate requirements EARS compliance
+set -e
+FILE="${1:?Usage: validate.sh <requirements-file.md>}"
+npx musubix req "$FILE"

package/.github/skills/requirements-analyst/scripts/wizard.sh

@@ -0,0 +1,4 @@
+#!/bin/bash
+# Run requirements wizard
+set -e
+npx musubix req:wizard

package/.github/skills/review-orchestrator/SKILL.md

@@ -154,3 +154,9 @@ const canProceed = orchestrator.canProceedToImplementation();
 1. **モデル応答のばらつき**: 同じアーティファクトでもモデルの応答が異なる場合がある。合意チェックで一貫性を担保する。
 2. **ラウンド数と品質のトレードオフ**: ラウンド数が多いほど品質は上がるが、時間コストも増加する。5 ラウンド制限はこのバランスを取るもの。
 3. **Phase 遷移との連携**: review-orchestrator の承認は PhaseController の遷移条件に組み込まれる。review-orchestrator 単体では Phase を遷移させない。
+
+## スクリプト
+
+| スクリプト | 説明 | 使い方 |
+|-----------|------|--------|
+| `scripts/review.sh` | レビューワークフロー案内 | `./scripts/review.sh` |

package/.github/skills/review-orchestrator/scripts/review.sh

@@ -0,0 +1,13 @@
+#!/bin/bash
+# Start review workflow
+set -e
+echo "Review Orchestrator"
+echo "==================="
+echo "This skill orchestrates cross-model reviews."
+echo ""
+echo "Available commands:"
+echo "  npx musubix workflow      # Workflow management"
+echo "  npx musubix policy        # Policy validation"
+echo "  npx musubix trace:verify  # Traceability check"
+echo ""
+echo "For full review orchestration, use the AI agent with this skill."

package/.github/skills/test-engineer/SKILL.md

@@ -49,7 +49,7 @@ WHEN ユーザーがテスト生成を要求する:
 4. CoverageReporter でカバレッジ目標を設定
 ```
 
-**CLI**: `npx musubix codegen test <design-file>`
+**CLI**: `npx musubix test:gen <source-file>`
 
 ### 2. カバレッジ検証
 
@@ -131,3 +131,9 @@ export default defineConfig({
 1. **テストなしのコミット禁止**: Article III により、テストのないコードは Phase 4 完了の品質ゲートを通過できない。
 2. **モック依存の分離**: `SkillTestHarness` パターンに従い、外部依存はモック注入する。テスト内で直接ファイルシステムにアクセスしない。
 3. **EARS ID リンクの維持**: テスト名を変更する場合、REQ ID リンクも必ず更新する。`traceability-auditor` で検証可能。
+
+## スクリプト
+
+| スクリプト | 説明 | 使い方 |
+|-----------|------|--------|
+| `scripts/generate.sh` | テスト生成 | `./scripts/generate.sh [args]` |

package/.github/skills/test-engineer/scripts/generate.sh

@@ -0,0 +1,4 @@
+#!/bin/bash
+# Generate tests
+set -e
+npx musubix test:gen "$@"

package/.github/skills/traceability-auditor/SKILL.md

@@ -48,10 +48,10 @@ WHEN ユーザーがトレーサビリティマトリクスの生成を要求す
 
 **CLI**: `npx musubix trace matrix [--format md|json|csv]`
 
-### 2. ギャップ検出
+### 2. トレーサビリティ検証
 
 ```
-WHEN ユーザーがトレーサビリティギャップの検出を要求する:
+WHEN ユーザーがトレーサビリティの検証を要求する:
 1. 全 REQ ID を抽出
 2. 各 REQ に対応する DES を検索
 3. 各 DES に対応するソースファイルを検索
@@ -59,7 +59,8 @@ WHEN ユーザーがトレーサビリティギャップの検出を要求する
 5. 欠落リンクをレポート
 ```
 
-**CLI**: `npx musubix trace gaps`
+**CLI**: `npx musubix trace validate`
+**CLI**: `npx musubix trace:verify`
 
 ### 3. 影響分析
 
@@ -72,18 +73,14 @@ WHEN ユーザーが変更影響分析を要求する:
 
 **CLI**: `npx musubix trace impact <req-id|des-id>`
 
-### 4. トレーサビリティ同期
+### 4. 影響分析レポート
 
 ```
-WHEN ユーザーがトレーサビリティの同期を要求する:
-1. TraceSyncService で REQ ↔ DES ↔ コード間のリンクを検証
-2. 不整合を検出してレポート
-3. --dry-run で変更プレビュー
-4. 承認後に自動修正
+WHEN ユーザーが影響分析レポートの生成を要求する:
+1. ImpactAnalyzer で変更影響をまとめる
+2. 影響範囲を Markdown 形式でレポート
 ```
 
-**CLI**: `npx musubix trace sync [--dry-run]`
-
 ## マトリクス出力フォーマット
 
 ```markdown
@@ -107,3 +104,11 @@ WHEN ユーザーがトレーサビリティの同期を要求する:
 1. **N:M 関係の扱い**: 1つの REQ が複数の DES にマッピングされる場合がある。マトリクスでは全組み合わせを列挙すること。
 2. **DES-SDD-002a/b/c のような複合 ID**: サフィックス付き ID も個別にトレースすること。グループ化表記（`002a/b/c`）は表示用。
 3. **コード内の REQ ID コメント**: `// REQ-XXX-NNN` 形式のコメントを検索対象にする。テスト内の `describe('REQ-XXX-NNN: ...')` も対象。
+
+## スクリプト
+
+| スクリプト | 説明 | 使い方 |
+|-----------|------|--------|
+| `scripts/verify.sh` | トレーサビリティ検証 | `./scripts/verify.sh [args]` |
+| `scripts/matrix.sh` | トレーサビリティマトリクス生成 | `./scripts/matrix.sh [args]` |
+| `scripts/verify-detailed.sh` | 詳細トレーサビリティ検証 | `./scripts/verify-detailed.sh [args]` |

package/.github/skills/traceability-auditor/scripts/matrix.sh

@@ -0,0 +1,4 @@
+#!/bin/bash
+# Generate traceability matrix
+set -e
+npx musubix trace "$@"

package/.github/skills/traceability-auditor/scripts/verify-detailed.sh

@@ -0,0 +1,4 @@
+#!/bin/bash
+# Detailed traceability verification
+set -e
+npx musubix trace:verify "$@"

package/.github/skills/traceability-auditor/scripts/verify.sh

@@ -0,0 +1,4 @@
+#!/bin/bash
+# Verify traceability
+set -e
+npx musubix trace "$@"