musubix 3.6.1 → 3.7.3

package/AGENTS.md

@@ -1,1136 +1,333 @@
-# MUSUBIX - Neuro-Symbolic AI Integration System
+# AGENTS.md — MUSUBIX v3.7.2
 
-> **AI Coding Agent向け**: このファイルはAIエージェント（GitHub Copilot、Claude等）がMUSUBIXプロジェクトを理解するためのガイドです。
+> **AI Agent向け最適化ナレッジ** — WHEN/DO構文で明確なトリガーとアクションを定義
 
-## 🎯 プロジェクト概要
+## 🎯 クイックリファレンス
 
-**MUSUBIX**は、**Neural（LLM）** と **Symbolic（Knowledge Graph）** 推論を統合した次世代AIコーディングシステムです。MUSUBI SDD方法論とオントロジー推論を組み合わせ、高品質なソフトウェア開発を支援します。
-
-| 項目 | 詳細 |
-|------|------|
-| **バージョン** | 3.5.0 (Assistant Axis Integration) |
-| **言語** | TypeScript |
-| **ランタイム** | Node.js >= 20.0.0 |
-| **パッケージマネージャ** | npm >= 10.0.0 |
-| **ビルドシステム** | モノレポ（npm workspaces） |
-| **テストフレームワーク** | Vitest |
-| **テスト数** | 5095+ (全合格) |
-| **パッケージ数** | 28 |
-| **MCPツール数** | 114 |
-| **Agent Skills** | 15 (Claude Code対応) |
+| 項目 | 値 |
+|------|-----|
+| バージョン | 3.7.2 |
+| テストカバレッジ | 92%+ |
+| パッケージ数 | 28 |
+| MCP ツール | 114 |
+| Agent Skills | 15 |
 
 ---
 
-## 📦 アーキテクチャ
-
-### パッケージ構成
-
-```
-packages/
-├── core/           # @nahisaho/musubix-core
-├── mcp-server/     # @nahisaho/musubix-mcp-server  
-├── security/       # @nahisaho/musubix-security
-├── formal-verify/  # @nahisaho/musubix-formal-verify
-├── pattern-mcp/    # @nahisaho/musubix-pattern-mcp
-├── ontology-mcp/   # @nahisaho/musubix-ontology-mcp
-├── wake-sleep/     # @nahisaho/musubix-wake-sleep
-├── sdd-ontology/   # @nahisaho/musubix-sdd-ontology
-├── dfg/            # @nahisaho/musubix-dfg
-├── lean/           # @nahisaho/musubix-lean
-├── library-learner/# @nahisaho/musubix-library-learner
-├── neural-search/  # @nahisaho/musubix-neural-search
-├── synthesis/      # @nahisaho/musubix-synthesis
-├── agent-orchestrator/ # @nahisaho/musubix-agent-orchestrator
-├── 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!)
-├── deep-research/      # @nahisaho/musubix-deep-research (v3.4.0 NEW!)
-├── assistant-axis/     # @nahisaho/musubix-assistant-axis (v3.5.0 NEW!)
-├── knowledge/          # @musubix/knowledge (v3.0.0 NEW!)
-├── policy/             # @musubix/policy (v3.0.0 NEW!)
-└── decisions/          # @musubix/decisions (v3.0.0 NEW!)
-```
-
-| パッケージ | npm | 役割 |
-|-----------|-----|------|
-| `packages/core/` | `@nahisaho/musubix-core` | コアライブラリ - CLI、EARS検証、コード生成、設計パターン |
-| `packages/mcp-server/` | `@nahisaho/musubix-mcp-server` | MCPサーバー - 114ツール、5プロンプト |
-| `packages/security/` | `@nahisaho/musubix-security` | セキュリティ分析 - 脆弱性検出、シークレット検出、テイント解析 |
-| `packages/formal-verify/` | `@nahisaho/musubix-formal-verify` | 形式検証 - Z3統合、Hoare検証、EARS→SMT変換 |
-| `packages/pattern-mcp/` | `@nahisaho/musubix-pattern-mcp` | パターン学習 - 抽出・圧縮・ライブラリ |
-| `packages/ontology-mcp/` | `@nahisaho/musubix-ontology-mcp` | オントロジー - N3Store・推論エンジン |
-| `packages/wake-sleep/` | `@nahisaho/musubix-wake-sleep` | Wake-Sleep学習サイクル |
-| `packages/sdd-ontology/` | `@nahisaho/musubix-sdd-ontology` | SDD方法論オントロジー |
-| `packages/dfg/` | `@nahisaho/musubix-dfg` | **DFG/CFG抽出** - データフロー・制御フロー解析 |
-| `packages/lean/` | `@nahisaho/musubix-lean` | **Lean 4統合** - 定理証明・EARS変換 |
-| `packages/library-learner/` | `@nahisaho/musubix-library-learner` | **ライブラリ学習** - APIパターン抽出、メトリクスエクスポート |
-| `packages/knowledge/` | `@musubix/knowledge` | **知識ストア (v3.0.0 NEW!)** - Git-friendly JSON知識グラフ |
-| `packages/policy/` | `@musubix/policy` | **ポリシーエンジン (v3.0.0 NEW!)** - 10憲法条項検証 |
-| `packages/decisions/` | `@musubix/decisions` | **ADRマネージャー (v3.0.0 NEW!)** - Architecture Decision Records |
-| `packages/neural-search/` | `@nahisaho/musubix-neural-search` | **ニューラル検索** - 意味的コード検索、軌跡ロギング |
-| `packages/synthesis/` | `@nahisaho/musubix-synthesis` | **プログラム合成** - ニューラル誘導合成、説明生成 |
-| `packages/agent-orchestrator/` | `@nahisaho/musubix-agent-orchestrator` | **エージェント調整** - サブエージェント分散・複雑度分析 |
-| `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統合 |
-| `packages/deep-research/` | `@nahisaho/musubix-deep-research` | **Deep Research (v3.4.0 NEW!)** - AI駆動型深層リサーチ・6統合機能・433テスト |
-| `packages/assistant-axis/` | `@nahisaho/musubix-assistant-axis` | **Assistant Axis (v3.5.0 NEW!)** - ペルソナドリフト検出・129テスト |
-
-### 非推奨パッケージ（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)
-
-### Core パッケージモジュール
-
-```
-packages/core/src/
-├── auth/           # 認証・認可
-├── cli/            # CLIインターフェース
-│   └── generators/ # スキャフォールドジェネレーター (v3.3.0 NEW!)
-├── codegen/        # コード生成・解析
-├── design/         # 設計パターン・C4モデル
-├── error/          # エラーハンドリング
-├── explanation/    # 説明生成・可視化
-├── learning/       # 自己学習システム
-├── requirements/   # 要件分析・分解
-├── symbolic/       # シンボリック推論（v1.2.0 NEW!）
-├── traceability/   # トレーサビリティ
-├── types/          # 型定義
-├── utils/          # ユーティリティ
-└── validators/     # EARS検証
-```
+## 📦 パッケージ構成
+
+| カテゴリ | パッケージ | 用途 |
+|----------|------------|------|
+| **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 |
 
 ---
 
 ## 🛠️ CLI コマンド
 
-```bash
-# プロジェクト初期化
-npx musubix init [path] [--name <name>] [--force]
-
-# 要件分析（EARS形式）
-npx musubix requirements analyze <file>    # 自然言語 → EARS変換
-npx musubix requirements validate <file>   # EARS構文検証
-npx musubix requirements map <file>        # オントロジーマッピング
-npx musubix requirements search <query>    # 関連要件検索
-
-# 設計生成
-npx musubix design generate <file>         # 要件から設計生成
-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 --min-coverage 80  # カバレッジ閾値指定
-
-# コード生成
-npx musubix codegen generate <file>        # 設計からコード生成
-npx musubix codegen generate <file> --full-skeleton  # 4ファイル生成 (v3.3.10 NEW!)
-npx musubix codegen generate <file> --with-tests     # テストファイル付き (v3.3.10 NEW!)
-npx musubix codegen analyze <file>         # 静的解析
-npx musubix codegen security <path>        # セキュリティスキャン
-npx musubix codegen status <spec>          # ステータス遷移コード生成 (v3.1.0 NEW!)
-npx musubix codegen status <spec> --enum   # enum型で生成
-
-# テスト
-npx musubix test generate <file>           # テスト生成
-npx musubix test coverage <dir>            # カバレッジ測定
-
-# トレーサビリティ
-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 --dry-run           # プレビューのみ
-
-# 説明生成
-npx musubix explain why <id>               # 決定理由の説明
-npx musubix explain graph <id>             # 推論グラフ生成
-
-# 自己学習システム
-npx musubix learn status                   # 学習状態ダッシュボード
-npx musubix learn feedback <id>            # フィードバック記録
-npx musubix learn patterns                 # パターン一覧表示
-npx musubix learn add-pattern <name>       # パターン手動登録
-npx musubix learn remove-pattern <id>      # パターン削除
-npx musubix learn recommend                # コンテキストベースの推奨
-npx musubix learn decay                    # 未使用パターンの減衰
-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!)
-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.3.0 Enhanced!)
-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> -s "Order=pending,Task=open"  # 初期状態指定 (v3.3.0 NEW!)
-npx musubix scaffold minimal <name>        # 最小構成プロジェクト
-
-# プログラム合成 (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 --help
-npx musubix help <command>
-```
-
----
-
-## 🔌 MCP Server
-
-### 起動方法
+### 基本操作
 
 ```bash
-npx @nahisaho/musubix-mcp-server
-npx musubix-mcp --transport stdio
-```
-
-### ツール一覧（61ツール）
-
-#### SDD基本ツール（7ツール）
-
-| ツール名 | 説明 |
-|---------|------|
-| `sdd_create_requirements` | EARS形式の要件ドキュメント作成 |
-| `sdd_validate_requirements` | 要件のEARS検証・憲法準拠チェック |
-| `sdd_create_design` | C4モデル設計ドキュメント作成 |
-| `sdd_validate_design` | 設計の要件トレーサビリティ検証 |
-| `sdd_create_tasks` | 設計から実装タスク生成 |
-| `sdd_validate_constitution` | 10憲法条項への準拠検証 |
-| `sdd_validate_traceability` | 要件↔設計↔タスクのトレーサビリティ検証 |
-
-#### パターン統合ツール（7ツール）- v1.3.0 NEW!
-
-| ツール名 | 説明 |
-|---------|------|
-| `pattern_extract` | コードからパターンを抽出 |
-| `pattern_compress` | パターンの抽象化・圧縮 |
-| `pattern_store` | パターンライブラリへの保存 |
-| `pattern_query` | パターンの検索・取得 |
-| `pattern_consolidate` | 類似パターンの統合 |
-| `ontology_query` | オントロジーグラフへのクエリ |
-| `ontology_infer` | オントロジーによる推論実行 |
-
-#### オントロジー検証ツール（3ツール）- v1.4.1 NEW!
-
-| ツール名 | 説明 |
-|---------|------|
-| `consistency_validate` | 知識グラフの整合性検証 |
-| `validate_triple` | 単一トリプルの事前検証 |
-| `check_circular` | 循環依存の検出 |
-
-#### Synthesisツール（5ツール）- v2.2.0 NEW!
-
-| ツール名 | 説明 |
-|---------|------|
-| `synthesis_from_examples` | 例からプログラム合成 |
-| `synthesis_analyze_examples` | 例題品質分析 |
-| `synthesis_learn_patterns` | パターン学習 |
-| `synthesis_query_patterns` | パターン検索 |
-| `synthesis_get_stats` | 統計取得 |
-
-#### Agent Orchestratorツール（4ツール）- v2.4.0 NEW!
-
-| ツール名 | 説明 |
-|---------|------|
-| `agent_analyze_complexity` | タスク複雑度分析・サブエージェント分散判定 |
-| `agent_dispatch` | サブエージェントへのタスクディスパッチ |
-| `agent_collect_results` | サブエージェント結果の収集・統合 |
-| `agent_get_status` | エージェント実行状態の取得 |
-
-#### Workflow Engineツール（5ツール）- v2.4.0 NEW!
-
-| ツール名 | 説明 |
-|---------|------|
-| `workflow_create` | 新規ワークフロー作成（5フェーズ制御） |
-| `workflow_advance_phase` | 次フェーズへの遷移（品質ゲート検証付き） |
-| `workflow_set_approval` | ユーザー承認状態の設定 |
-| `workflow_get_status` | ワークフロー現在状態の取得 |
-| `workflow_validate_transition` | フェーズ遷移の事前検証 |
-
-#### Skill Managerツール（5ツール）- v2.4.0 NEW!
-
-| ツール名 | 説明 |
-|---------|------|
-| `skill_register` | 新規スキルの登録 |
-| `skill_execute` | スキルの実行 |
-| `skill_list` | 登録済みスキル一覧の取得 |
-| `skill_get_info` | スキル詳細情報の取得 |
-| `skill_validate` | スキル定義の検証 |
-
-#### Knowledge Storeツール（6ツール）- v3.0.0 NEW!
-
-| ツール名 | 説明 |
-|---------|------|
-| `knowledge_put_entity` | エンティティの作成・更新 |
-| `knowledge_get_entity` | エンティティの取得 |
-| `knowledge_delete_entity` | エンティティの削除 |
-| `knowledge_add_relation` | リレーションの追加 |
-| `knowledge_query` | グラフクエリによる検索 |
-| `knowledge_traverse` | グラフ走査による関連エンティティ探索 |
-
-#### Policy Engineツール（4ツール）- v3.0.0 NEW!
-
-| ツール名 | 説明 |
-|---------|------|
-| `policy_validate` | プロジェクトのポリシー検証 |
-| `policy_list` | 登録済みポリシー一覧 |
-| `policy_get` | ポリシー詳細取得 |
-| `policy_check_file` | 単一ファイルのポリシー検証 |
-
-#### Decision Recordsツール（8ツール）- v3.0.0 NEW!
-
-| ツール名 | 説明 |
-|---------|------|
-| `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` | ADRインデックス生成 |
-
-### プロンプト一覧（5プロンプト）
-
-| プロンプト名 | 説明 |
-|-------------|------|
-| `sdd_requirements_analysis` | 機能説明からEARS形式要件を生成 |
-| `sdd_requirements_review` | 要件の完全性・憲法準拠レビュー |
-| `sdd_design_generation` | 要件からC4モデル設計を生成 |
-| `synthesis_guidance` | 合成ガイダンス (v2.2.0 NEW!) |
-| `synthesis_explain_pattern` | パターン説明 (v2.2.0 NEW!) |
-
----
-
-## 📋 10憲法条項（Constitutional Articles）
-
-すべての開発活動を統治する不変のルールです。
-
-| 条項 | 名称 | 概要 |
-|-----|------|------|
-| **I** | Library-First | 機能は独立ライブラリとして開始 |
-| **II** | CLI Interface | すべてのライブラリはCLI公開必須 |
-| **III** | Test-First | Red-Green-Blueサイクルでテスト先行 |
-| **IV** | EARS Format | 要件はEARS形式で記述 |
-| **V** | Traceability | 要件↔設計↔コード↔テストの100%追跡 |
-| **VI** | Project Memory | steering/を参照してから決定 |
-| **VII** | Design Patterns | 設計パターン適用の文書化 |
-| **VIII** | Decision Records | すべての決定をADRで記録 |
-| **IX** | Quality Gates | フェーズ移行前の品質検証 |
-| **X** | **Implementation Prerequisites** | **要件・設計・タスクなしの実装禁止** |
-
-### ⛔ Article X: Implementation Prerequisites (v3.0.9)
+# プロジェクト全体
+pnpm i && pnpm build && pnpm test
 
-**絶対ルール**: 要件定義書・設計書・タスク分解が承認されていない限り、実装を開始してはならない。
-
-```
-⛔ 禁止: Phase 2 (設計) → Phase 4 (実装) の直接遷移
-✅ 必須: Phase 1 → Phase 2 → Phase 3 → Phase 4 の順序遵守
+# 個別パッケージ
+pnpm --filter @musubix/core test
+pnpm --filter @musubix/knowledge test
 ```
 
-実装開始前に`workflow-engine`が自動検証:
-- ✅ Phase 1 (要件定義) が承認済みかつ成果物あり
-- ✅ Phase 2 (設計) が承認済みかつ成果物あり
-- ✅ Phase 3 (タスク分解) が承認済みかつ成果物あり
-
-**詳細**: [steering/rules/constitution.md](steering/rules/constitution.md)
-
----
-
-## 📁 プロジェクトメモリ（Steering）
-
-AIエージェントは決定前に必ずこれらのファイルを参照してください。
-
-| ファイル | 内容 |
-|---------|------|
-| `steering/structure.ja.md` | アーキテクチャパターン、レイヤー構造 |
-| `steering/tech.ja.md` | 技術スタック（TypeScript, Node.js 20+） |
-| `steering/product.ja.md` | プロダクトコンテキスト |
-| `steering/rules/constitution.md` | 10憲法条項 |
-| `steering/project.yml` | プロジェクト設定 |
-
----
-
-## 📂 ストレージ構造
-
-| パス | 内容 |
-|-----|------|
-| `storage/specs/` | 要件(REQ-*)、設計(DES-*)、タスク(TSK-*) |
-| `storage/design/` | 設計ドキュメント、C4ダイアグラム |
-| `storage/traceability/` | トレーサビリティマトリクス |
-| `storage/reviews/` | コードレビュー、検証結果 |
-| `storage/changes/` | 変更履歴 |
-| `storage/archive/` | アーカイブ |
-
----
-
-## 🧪 開発コマンド
+### ナレッジ操作
 
 ```bash
-# 依存関係インストール
-npm install
+# 追加・検索
+musubix knowledge add --source ./src --output ./knowledge.json
+musubix knowledge search "認証" --semantic --top-k 5
 
-# 全パッケージビルド
-npm run build
-
-# テスト実行
-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 clean
+# コードグラフ
+musubix codegraph analyze ./src --include-dependencies
+musubix codegraph query "関数 -> 依存関係"
 ```
 
----
+### SDD ワークフロー
 
-## 🔑 主要機能
-
-### 1. Neuro-Symbolic統合（REQ-INT-001〜003準拠）
-- **Neural（LLM）**: 創造的なコード生成、自然言語理解
-- **Symbolic（Ontology）**: オントロジーによる精密な推論、一貫性検証
-- **信頼度評価ルール** (REQ-INT-002):
-  | シンボリック結果 | ニューラル信頼度 | 最終決定 |
-  |-----------------|-----------------|---------|
-  | invalid | - | ニューラル結果を棄却 |
-  | valid | ≥0.8 | ニューラル結果を採用 |
-  | valid | <0.8 | シンボリック結果を優先 |
-
-### 2. EARS要件分析
-5つのEARSパターンで要件を形式化（REQ-RA-001準拠）：
-
-| パターン | 構文 | 用途 |
-|---------|------|------|
-| Ubiquitous | `THE [system] SHALL [requirement]` | システムが常に満たすべき要件 |
-| Event-driven | `WHEN [event], THE [system] SHALL [response]` | 特定イベント発生時の要件 |
-| State-driven | `WHILE [state], THE [system] SHALL [response]` | 特定状態における要件 |
-| Unwanted | `THE [system] SHALL NOT [behavior]` | 回避すべき動作の要件 |
-| Optional | `IF [condition], THEN THE [system] SHALL [response]` | 条件付き要件 |
-
-**要件総数**: 41要件（REQ-MUSUBIX-001定義）  
-**優先度**: P0（必須）、P1（重要）、P2（任意）
-
-### 3. C4モデル設計
-4つのレベルで設計を構造化：
-- **Context**: システム境界と外部アクター
-- **Container**: 技術選択とコンテナ構成
-- **Component**: コンテナ内部構造
-- **Code**: 実装詳細
-
-**C4コード生成** (v1.0.12 NEW!):
 ```bash
-# C4設計ドキュメントからTypeScriptスケルトンコードを自動生成
-npx musubix codegen generate <design.md> --output src/
+# 仕様駆動開発
+musubix sdd init --domain "Eコマース" --output ./specs
+musubix sdd validate ./specs --strict
+musubix sdd generate ./specs --output ./src
 ```
-- 設計パターン（Repository, Service, Factory等）を自動検出
-- コンポーネントごとにTypeScriptファイル生成
-- 設計との完全なトレーサビリティを維持
 
-### 4. 完全なトレーサビリティ
-```
-要件(REQ-*) → 設計(DES-*) → タスク(TSK-*) → コード → テスト
-```
+### MCP サーバー
 
-### 5. 自己学習システム（REQ-LEARN-001〜006準拠）
-- **フィードバック収集**: accept/reject/modifyの記録と分析
-- **パターン抽出**: 繰り返しパターンの自動検出・登録
-- **適応的推論**: 学習済みパターンに基づく推論調整
-- **プライバシー保護**: 機密情報の自動フィルタリング（ローカルストレージのみ）
-
-```
-フィードバック → パターン候補 → 閾値超過 → パターン登録 → 推論に適用
+```bash
+# 起動
+musubix-mcp serve
+musubix-mcp serve --port 3000 --skills-dir ./skills
 ```
 
-### 6. Wake-Sleep学習サイクル（v1.3.0 NEW!）
-
-Wake-Sleepアルゴリズムに基づいた継続的学習システム：
-
-| フェーズ | 処理内容 |
-|---------|----------|
-| **Wake** | コード観察 → パターン抽出 → 知識グラフ更新 |
-| **Sleep** | パターン統合 → 類似パターン圧縮 → メモリ最適化 |
-
-```
-Wake Phase: observe() → extractPatterns() → updateKnowledge()
-Sleep Phase: consolidate() → compress() → optimize()
-```
+---
 
-**主要コンポーネント**:
-- `WakeSleepCycle`: 学習サイクル全体の制御
-- `PatternLibrary`: 学習済みパターンの永続化管理
-- `PatternOntologyBridge`: パターン↔オントロジー相互変換
-- `N3Store`: RDF/OWLベースの知識グラフストレージ
+## 🔌 MCP ツール（主要）
 
-### 7. Git-Native Knowledge System（v3.0.0 NEW!）
+| カテゴリ | ツール | 用途 |
+|----------|--------|------|
+| **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` | 検索 |
 
-サーバーレス・Git-friendlyな知識グラフシステム：
+**全114ツール**: `musubix-mcp list-tools` で確認
 
-| 特徴 | 説明 |
-|------|------|
-| **サーバーレス** | データベース不要、JSONファイルで完結 |
-| **Git-friendly** | diff/merge/PR対応、バージョン管理可能 |
-| **軽量** | ゼロ依存（外部ライブラリ不要） |
-| **階層型ID** | `requirement:REQ-001`、`design:DES-001` |
+---
 
-```
-.knowledge/
-└── graph.json      # 全エンティティ・リレーション
-```
+## 📜 10憲法条項
+
+| # | 条項 | ルール |
+|---|------|--------|
+| 1 | コンテキスト最優先 | Steering/product.ja.md, structure.ja.md を必ず参照 |
+| 2 | ナレッジ駆動 | 既存知識を検索・活用してから回答 |
+| 3 | 仕様駆動 (SDD) | 要件→設計→実装→検証の順序厳守 |
+| 4 | トレーサビリティ | 決定事項は ADR として記録 |
+| 5 | 段階的詳細化 | 抽象から具体へ、一度に1レベル |
+| 6 | 自律学習 | Wake-Sleepサイクルで継続的改善 |
+| 7 | 形式検証 | 重要ロジックはLean4で証明 |
+| 8 | パターン適用 | 学習済みベストプラクティスを活用 |
+| 9 | 明示的コミュニケーション | 不明点は確認、仮定を明示 |
+| 10 | 品質最優先 | テスト・レビュー・検証を省略しない |
 
-**主要API**:
-```typescript
-import { createKnowledgeStore } from '@musubix/knowledge';
-
-const store = createKnowledgeStore('.knowledge');
-
-// エンティティ操作
-await store.putEntity({
-  id: 'requirement:REQ-001',
-  type: 'requirement',
-  name: 'User Authentication',
-  properties: { ears: 'WHEN user logs in...' },
-  tags: ['security', 'auth'],
-});
-
-const req = await store.getEntity('requirement:REQ-001');
-
-// リレーション追加
-await store.addRelation({
-  source: 'requirement:REQ-001',
-  target: 'design:DES-001',
-  type: 'tracesTo',
-  properties: { confidence: 0.95 },
-});
-
-// クエリ
-const entities = await store.query({ type: 'requirement', tags: ['security'] });
-
-// グラフ走査
-const related = await store.traverse('requirement:REQ-001', {
-  direction: 'outgoing',
-  relationTypes: ['tracesTo'],
-  maxDepth: 2,
-});
-```
-
-**関連パッケージ**:
-- `@musubix/policy`: 10憲法条項の自動検証
-- `@musubix/decisions`: Architecture Decision Records管理
+---
 
-**ドキュメント**: [docs/packages/knowledge.md](docs/packages/knowledge.md)
+## 🧭 Project Memory（Steering）
 
-### 8. Advanced Learning Enhancement（v2.2.0 NEW!）
+| ファイル | 用途 | 参照タイミング |
+|----------|------|----------------|
+| `steering/product.ja.md` | 製品ビジョン・ゴール | プロジェクト理解時 |
+| `steering/structure.ja.md` | アーキテクチャ構造 | 設計・実装時 |
+| `steering/tech.ja.md` | 技術スタック・制約 | 技術選定時 |
+| `steering/project.yml` | プロジェクトメタデータ | CI/CD設定時 |
+| `steering/rules/*.md` | ドメイン固有ルール | コード生成時 |
 
-3パッケージに高度な学習機能を追加：
+---
 
-#### Neural Search強化
-```typescript
-import {
-  ContextAwareEmbedder,   // コンテキスト認識埋め込み
-  HybridRanker,           // BM25 + ベクトル類似度
-  EmbeddingCache,         // LRU + TTL キャッシュ
-  createTrajectoryLogger, // 検索軌跡ロギング
-} from '@nahisaho/musubix-neural-search';
-
-const logger = createTrajectoryLogger();
-logger.logBranch({ depth: 1, score: 0.85, action: 'expand' });
-const parquet = logger.export('parquet');
-```
+## 🔬 主要機能
 
-#### Library Learner強化
-```typescript
-import {
-  SemanticChunker,        // AST境界認識チャンキング
-  PatternVersionManager,  // Git風バージョン管理
-  createMetricsExporter,  // メトリクスエクスポート
-} from '@nahisaho/musubix-library-learner';
-
-const exporter = createMetricsExporter(library);
-const markdown = exporter.export('markdown');
-const summary = exporter.getSummary(); // { healthStatus: 'good' }
-```
+### 1. Wake-Sleep 自律学習
 
-#### Synthesis強化
 ```typescript
-import {
-  createMetaLearningEngine,    // メタ学習エンジン
-  createExampleAnalyzer,       // 例題品質分析
-  createExplanationGenerator,  // 説明生成
-} from '@nahisaho/musubix-synthesis';
-
-const explainer = createExplanationGenerator();
-const explanation = explainer.generate(program);
-const summary = explainer.summarize(program);
-// "Converts to uppercase"
+// WHEN: パターン学習が必要
+// DO: Wake-Sleepサイクルを実行
+const result = await wakeSleep.observe("./src/**/*.ts");
+const patterns = await wakeSleep.consolidate(result);
+await wakeSleep.apply(patterns);
 ```
 
-### 9. Performance Optimization（v3.1.0 NEW!）
-
-CLI・パターン処理の性能最適化ユーティリティ：
+### 2. Knowledge Graph
 
-#### 性能計測
 ```typescript
-import {
-  PerformanceTimer,
-  measureAsync,
-  measureSync,
-  PerformanceCollector,
-  createPerformanceCollector,
-  formatPerformanceReport,
-} from '@nahisaho/musubix-core/cli';
-
-// 非同期処理の計測
-const { result, performance } = await measureAsync('api-call', async () => {
-  return await fetchData();
-});
-console.log(`Duration: ${performance.durationMs}ms`);
-
-// 性能レポート生成
-const collector = createPerformanceCollector();
-collector.addResult(performance);
-const report = collector.generateReport();
-console.log(formatPerformanceReport(report));
+// WHEN: 情報の関連付けが必要
+// DO: エンティティとリレーションを追加
+await knowledge.addEntity({ type: "Function", name: "auth" });
+await knowledge.addRelation("auth", "uses", "jwt-library");
+const related = await knowledge.search("認証", { semantic: true });
 ```
 
-#### 遅延読み込み
-```typescript
-import {
-  createLazyLoader,
-  LazyModuleRegistry,
-  globalLazyRegistry,
-  BatchLoader,
-} from '@nahisaho/musubix-core/cli';
-
-// モジュールの遅延読み込み
-const heavyModule = createLazyLoader(() => import('./heavy-module'));
-const module = await heavyModule(); // 初回アクセス時にのみ読み込み
-
-// バッチ読み込み
-const loader = new BatchLoader(async (keys) => {
-  const results = await fetchMany(keys);
-  return new Map(keys.map((k, i) => [k, results[i]]));
-});
-const [a, b, c] = await Promise.all([
-  loader.load('a'),
-  loader.load('b'),
-  loader.load('c'),
-]); // 1回のバッチリクエストで取得
-```
+### 3. CodeGraph 解析
 
-#### パターンキャッシュ
 ```typescript
-import {
-  LRUCache,
-  PatternCache,
-  globalPatternCache,
-  memoize,
-  memoizeAsync,
-} from '@nahisaho/musubix-core/learning';
-
-// LRUキャッシュ（TTL対応）
-const cache = new LRUCache<string, Pattern>({
-  maxSize: 100,
-  ttlMs: 60000, // 1分
-});
-cache.set('pattern-1', patternData);
-const pattern = cache.get('pattern-1');
-
-// 関数メモ化
-const expensiveFn = memoize((x: number) => {
-  // 重い計算
-  return x * 2;
-});
-
-// 非同期関数メモ化
-const fetchUser = memoizeAsync(async (id: string) => {
-  return await api.getUser(id);
-});
+// WHEN: コード依存関係の把握が必要
+// DO: 解析してクエリ実行
+const graph = await codegraph.analyze("./src");
+const deps = await codegraph.query("Function -> Dependency");
 ```
 
-### 10. Scaffold Enhancement & Pattern Learning Integration（v3.3.0 NEW!）
+### 4. SDD ワークフロー
 
-スキャフォールドコマンドとパターン学習システムの統合強化：
-
-#### Value Object Generator
 ```typescript
-import {
-  generators,
-  type generators.ValueObjectSpec,
-} from '@nahisaho/musubix-core';
-
-const generator = generators.createValueObjectGenerator();
-const spec: generators.ValueObjectSpec = {
-  name: 'Price',
-  fields: [
-    { name: 'amount', type: 'number', validation: { min: 100, max: 1000000 } },
-    { name: 'currency', type: 'string', validation: { pattern: 'JPY|USD|EUR' } }
-  ],
-  domainPrefix: 'SHOP'
-};
-
-const files = generator.generate(spec);
-// → [{ path: 'price.ts', content: '...' }, { path: 'price.test.ts', content: '...' }]
+// WHEN: 新機能の仕様策定
+// DO: init → validate → generate
+await sdd.init({ domain: "Payment", output: "./specs" });
+await sdd.validate("./specs", { strict: true });
+await sdd.generate("./specs", { output: "./src" });
 ```
 
-#### Status Machine Generator
-```typescript
-import {
-  generators,
-  type generators.StatusMachineSpec,
-} from '@nahisaho/musubix-core';
-
-const generator = generators.createStatusMachineGenerator();
-const spec: generators.StatusMachineSpec = {
-  name: 'Order',
-  statuses: ['pending', 'confirmed', 'shipped', 'delivered', 'cancelled'],
-  initialStatus: 'pending',  // v3.3.0: 初期状態を明示指定可能
-  transitions: [
-    { from: 'pending', to: 'confirmed' },
-    { from: 'pending', to: 'cancelled' },
-    { from: 'confirmed', to: 'shipped' },
-    // ...
-  ],
-  domainPrefix: 'SHOP'
-};
-
-const files = generator.generate(spec);
-// → [{ path: 'order-status.ts', content: '...' }, { path: 'order-status.test.ts', content: '...' }]
-```
+### 5. Formal Verification
 
-#### Pattern Learning Service（新規）
 ```typescript
-import { generators } from '@nahisaho/musubix-core';
-
-// スキャフォールド生成結果からパターンを学習
-const service = generators.createPatternLearningService();
-
-// コードからパターン抽出
-await service.learnFromCode(generatedCode);
-
-// 学習したパターンを次回生成に活用
-const suggestions = await service.getSuggestions(context);
-// → [{ pattern: 'ValueObject+ResultType', confidence: 0.95 }]
-
-// 学習状況のサマリー
-const summary = await service.getSummary();
-// → { totalPatterns: 15, healthStatus: 'good' }
+// WHEN: 重要ロジックの証明が必要
+// DO: Lean4に変換して検証
+const leanCode = await formal.translate(tsCode);
+const proof = await formal.verify(leanCode);
 ```
 
-#### Expert Integration（AIエキスパート委譲統合）
-```typescript
-import { generators } from '@nahisaho/musubix-core';
-
-const expert = generators.createExpertIntegration({
-  ...generators.DEFAULT_EXPERT_CONFIG,
-  timeout: 30000,  // ADR-v3.3.0-002: 30秒タイムアウト
-  fallbackEnabled: true,  // タイムアウト時フォールバック有効
-});
-
-// スキャフォールド生成にAIエキスパートを活用
-const recommendation = await expert.consultForScaffold({
-  type: 'value-object',
-  spec: valueObjectSpec,
-  context: projectContext,
-});
-// → { validationRules: [...], suggestedPatterns: [...] }
-```
-
-#### CLI使用例（v3.3.0強化）
-```bash
-# 初期状態を明示指定してステータスマシンを生成
-npx musubix scaffold domain-model shop -s "Order=pending,Task=open"
+---
 
-# 上記コマンドで生成されるファイル:
-# - order-status.ts (初期状態: 'pending')
-# - task-status.ts (初期状態: 'open')
-# - *.test.ts (対応テスト)
-```
+## 📚 学習済みベストプラクティス
+
+| パターン | 適用条件 | 効果 |
+|----------|----------|------|
+| Result型 | エラーハンドリング | 型安全なエラー処理 |
+| Repository | データアクセス | 永続化層の抽象化 |
+| ValueObject | 不変データ | 値の整合性保証 |
+| AggregateRoot | 整合性境界 | トランザクション境界の明確化 |
+| CQRS | 読み書き分離 | パフォーマンス最適化 |
+| EventSourcing | 状態追跡 | 完全な監査証跡 |
+| DomainEvent | 疎結合通知 | モジュール間の依存削減 |
+| Specification | 条件カプセル化 | 再利用可能なビジネスルール |
+| Factory | 生成ロジック | 複雑なオブジェクト生成の隠蔽 |
+| Strategy | アルゴリズム切替 | 実行時の振る舞い変更 |
 
 ---
 
-## 📚 学習済みベストプラクティス（v1.1.10 Updated!）
+## 🤖 Agent Skills（15スキル）
 
-Project-07〜14の実装から学習したパターンです。
+### Core Skills
 
-### コードパターン
+| スキル | トリガー | 機能 |
+|--------|----------|------|
+| `knowledge-capture` | 新情報入力時 | エンティティ抽出・関係構築 |
+| `knowledge-integration` | 統合要求時 | 複数ソースの知識統合 |
+| `structured-summary` | 要約要求時 | 構造化300字要約 |
+| `deep-research` | 調査要求時 | 多段階深層調査 |
+| `learning-extraction` | パターン発見時 | ベストプラクティス抽出 |
 
-| ID | 名称 | 概要 | 信頼度 |
-|----|------|------|--------|
-| BP-CODE-001 | Entity Input DTO | エンティティ作成にInput DTOオブジェクトを使用 | 95% |
-| BP-CODE-002 | Date-based ID Format | PREFIX-YYYYMMDD-NNN形式でIDを生成 | 90% |
-| BP-CODE-003 | Value Objects | ドメイン概念にValue Objectを使用 | 90% |
-| BP-CODE-004 | Function-based Value Objects | クラスではなくinterface+factory関数でVO実装 | 95% |
-| BP-CODE-005 | Result Type | 失敗可能な操作にResult<T, E>を使用 | 95% |
+### SDD Skills
 
-**Function-based Value Object例**:
-```typescript
-// ✅ 推奨: Interface + Factory Function
-interface Price {
-  readonly amount: number;
-  readonly currency: 'JPY';
-}
-
-function createPrice(amount: number): Result<Price, ValidationError> {
-  if (amount < 100 || amount > 1_000_000) {
-    return err(new ValidationError('Price must be between 100 and 1,000,000 JPY'));
-  }
-  return ok({ amount, currency: 'JPY' });
-}
-
-// ❌ 非推奨: クラスベース（構造的型付けと相性が悪い）
-class Price {
-  private constructor(readonly amount: number) {}
-  static create(amount: number): Price { ... }
-}
-```
+| スキル | トリガー | 機能 |
+|--------|----------|------|
+| `musubix-domain-inference` | 要件分析時 | ドメインモデル推論 |
+| `musubix-sdd-workflow` | SDD開始時 | 仕様駆動開発ガイド |
+| `musubix-code-generation` | コード生成時 | SDD準拠コード生成 |
+| `musubix-test-generation` | テスト生成時 | 仕様ベーステスト生成 |
+| `musubix-traceability` | 追跡確認時 | 要件-実装追跡 |
 
-### 設計パターン
+### Documentation Skills
 
-| ID | 名称 | 概要 | 信頼度 |
-|----|------|------|--------|
-| BP-DESIGN-001 | Status Transition Map | 有効なステータス遷移をMapで定義 | 95% |
-| BP-DESIGN-002 | Repository Async Pattern | 将来のDB移行に備えてasync化 | 85% |
-| BP-DESIGN-003 | Service Layer with DI | リポジトリをDIしたService層 | 90% |
-| BP-DESIGN-004 | Optimistic Locking | 同時編集検出のためのversion管理 | 90% |
-| BP-DESIGN-005 | AuditService | データ変更の監査ログ記録 | 85% |
-| BP-DESIGN-006 | Entity Counter Reset | テスト用のresetXxxCounter()関数を提供 | 95% |
-| BP-DESIGN-007 | Expiry Time Logic | 有効期限をexpiresAtフィールドで明示管理 | 90% |
+| スキル | トリガー | 機能 |
+|--------|----------|------|
+| `musubix-adr-generation` | 決定記録時 | ADR自動生成 |
+| `musubix-c4-design` | 設計図作成時 | C4モデル生成 |
+| `musubix-technical-writing` | 文書作成時 | 技術文書生成 |
+| `musubix-best-practices` | ノウハウ整理時 | ベストプラクティス文書化 |
+| `musubix-ears-validation` | 要件検証時 | EARS構文検証 |
 
-**Status Transition Map例**:
-```typescript
-const validStatusTransitions: Record<Status, Status[]> = {
-  draft: ['active', 'cancelled'],
-  active: ['completed', 'cancelled'],
-  completed: [],
-  cancelled: [],
-};
-```
+---
 
-### テストパターン
+## 📋 AI Agent ガイドライン
 
-| ID | 名称 | 概要 | 信頼度 |
-|----|------|------|--------|
-| BP-TEST-001 | Test Counter Reset | beforeEachでIDカウンターをリセット | 95% |
-| BP-TEST-002 | Verify API Before Test | テスト前にAPIシグネチャを確認 | 80% |
-| BP-TEST-003 | Vitest ESM Configuration | Vitest + TypeScript ESM構成 | 85% |
-| BP-TEST-004 | Result Type Test Pattern | isOk()/isErr()で両方のケースをテスト | 95% |
-| BP-TEST-005 | Status Transition Testing | 有効・無効な遷移を網羅的にテスト | 90% |
+### WHEN: 新規タスク開始
 
-**Result Type Test例**:
-```typescript
-describe('createPrice', () => {
-  it('should create valid price', () => {
-    const result = createPrice(1000);
-    expect(result.isOk()).toBe(true);
-    if (result.isOk()) {
-      expect(result.value.amount).toBe(1000);
-    }
-  });
-
-  it('should reject price below minimum', () => {
-    const result = createPrice(50);
-    expect(result.isErr()).toBe(true);
-    if (result.isErr()) {
-      expect(result.error.message).toContain('100');
-    }
-  });
-});
 ```
-
-### CLIでベストプラクティスを表示
-
-```bash
-# 全ベストプラクティス表示
-npx musubix learn best-practices
-
-# カテゴリ別フィルタ
-npx musubix learn best-practices --category code
-npx musubix learn best-practices --category design
-npx musubix learn best-practices --category test
-
-# 高信頼度パターンのみ
-npx musubix learn best-practices --high-confidence
-
-# Markdown出力
-npx musubix learn best-practices --format markdown
+DO:
+1. steering/ を読んでコンテキスト把握
+2. knowledge search で既存知識確認
+3. 関連 ADR を確認
+4. 必要なスキルを特定
 ```
 
----
-
-## �📚 ドキュメント
-
-| ドキュメント | 説明 |
-|-------------|------|
-| [docs/INSTALL-GUIDE.md](docs/INSTALL-GUIDE.md) | インストールガイド |
-| [docs/USER-GUIDE.md](docs/USER-GUIDE.md) | ユーザーガイド |
-| [docs/API-REFERENCE.md](docs/API-REFERENCE.md) | APIリファレンス |
-| [README.md](README.md) | 英語版README |
-| [README.ja.md](README.ja.md) | 日本語版README |
-
----
-
-## 🤝 AI Agent向けガイドライン
-
-### コード生成時の注意点
-
-1. **憲法条項の遵守**: 9条項を必ず確認
-2. **steering/参照**: 決定前にproject memoryを確認
-3. **EARS形式**: 要件は必ずEARS形式で記述
-4. **トレーサビリティ**: コードコメントに要件IDを記載
-5. **テスト先行**: Red-Green-Blueサイクルを遵守
-6. **モノレポ構造**: パッケージ間の依存関係に注意
-
-### 要件定義時の自動ヒアリング（v3.3.9 NEW!）
-
-「○○の要件定義を開始」と依頼された場合、コンテキストが不足しているときは自動的にヒアリングを行います。
-
-#### ヒアリングフロー
+### WHEN: コード生成
 
 ```
-ユーザー: 「ログイン機能の要件定義を開始」
-    ↓
-AIエージェント: sdd_create_requirements(featureName: "login") を呼び出し
-    ↓
-MCPサーバー: needsClarification: true を返却
-    ↓
-AIエージェント: 以下の質問をユーザーに提示
+DO:
+1. SDD ワークフローに従う
+2. 学習済みパターンを適用
+3. テストを同時生成
+4. トレーサビリティを維持
 ```
 
-#### 5つの核心質問
-
-| # | 観点 | 質問 |
-|---|------|------|
-| 1 | **WHY** | この機能で解決したい「本当の課題」は何ですか？ |
-| 2 | **WHO** | この機能を最も必要としているのは誰ですか？ |
-| 3 | **WHAT-IF** | もしこの機能が完璧に動作したら、何が変わりますか？ |
-| 4 | **CONSTRAINT** | この機能で「絶対にやってはいけないこと」はありますか？ |
-| 5 | **SUCCESS** | この機能が「成功した」と言えるのはどんな状態ですか？ |
-
-#### 質問提示フォーマット
+### WHEN: エラー発生
 
 ```
-📋 要件を明確にするため、いくつか質問させてください：
-
-1. この機能で解決したい「本当の課題」は何ですか？
-2. この機能を最も必要としているのは誰ですか？
-3. もしこの機能が完璧に動作したら、何が変わりますか？
-4. この機能で「絶対にやってはいけないこと」はありますか？
-5. この機能が「成功した」と言えるのはどんな状態ですか？
-
-回答をお願いします。
+DO:
+1. Result型でエラーをラップ
+2. コンテキスト情報を付加
+3. リカバリー戦略を検討
+4. 学習データとして記録
 ```
 
-#### コンテキスト収集後の再呼び出し
+### WHEN: 不明点がある
 
-```typescript
-// ユーザーが回答を提供した後
-sdd_create_requirements({
-  projectName: "MyProject",
-  featureName: "login",
-  context: {
-    purpose: "ログイン処理を簡素化し、UXを向上させる",
-    targetUser: "一般ユーザー（技術レベル：初〜中級）",
-    successState: "2秒以内にログイン完了、エラー率1%未満",
-    constraints: "パスワードを平文で保存しない、ログイン試行回数制限",
-    successCriteria: "ログイン成功率99%以上、平均ログイン時間2秒以下",
-  },
-})
+```
+DO:
+1. 仮定を明示して確認を求める
+2. 複数の選択肢を提示
+3. 決定事項は ADR に記録
 ```
 
-#### コンテキスト充足度レベル
-
-| レベル | 条件 | アクション |
-|--------|------|-----------|
-| **complete** | 5つの質問すべてに回答あり | 要件生成を開始 |
-| **partial** | 2-4つの質問に回答あり | 不足分の質問を返す |
-| **minimal** | 0-1つの質問に回答あり | 5つの核心質問すべてを返す |
-
-### 推奨ワークフロー
+---
 
-> **⚠️ 重要ルール**: Phase 1〜3（要件定義・設計・タスク分解）は、**レビュー結果をユーザーに表示し、修正か次ステップかを確認すること**。ユーザーから明示的な承認を得るまで次フェーズに進んではならない。
->
-> **🚫 絶対禁止**: **設計（Phase 2）から直接実装（Phase 4）に進むことは禁止**。必ずタスク分解（Phase 3）を経ること。タスク分解なしでの実装開始は憲法違反とみなす。
+## 🔄 推奨ワークフロー
 
 ```
-【Phase 1: 要件定義】
-┌─────────────────────────────────────────────────────────────┐
-│ 1. steering/ を読む                                         │
-│ 2. 要件定義書を作成（EARS形式）                              │
-│ 3. ユーザーに提示                                           │
-│                                                              │
-│ 4. セルフレビュー実施                                        │
-│    - 既存実装との整合性チェック                              │
-│    - EARS形式の検証                                          │
-│    - 要件の網羅性・完全性確認                                │
-│                                                              │
-│ 5. レビュー結果を表示                                        │
-│    ┌───────────────────────────────────────────────────────┐│
-│    │ 📋 レビュー結果:                                       ││
-│    │ ✅ EARS形式: 準拠                                      ││
-│    │ ✅ 優先度設定: 完了                                    ││
-│    │ ⚠️ 整合性: 既存REQ-XXXと重複の可能性あり              ││
-│    │                                                        ││
-│    │ 👉 修正しますか？それとも次に進みますか？              ││
-│    │    - 「修正」→ 指摘箇所を修正して再提示               ││
-│    │    - 「承認」→ Phase 2（設計）へ進む                  ││
-│    └───────────────────────────────────────────────────────┘│
-│                                                              │
-│ 6. ユーザー応答待ち                                          │
-│    - 修正指示 → 修正して3へ戻る                             │
-│    - 承認 → Phase 2へ                                       │
-└─────────────────────────────────────────────────────────────┘
-
-【Phase 2: 設計】
-┌─────────────────────────────────────────────────────────────┐
-│ 1. 設計書を作成（C4モデル）                                  │
-│ 2. ユーザーに提示                                           │
-│                                                              │
-│ 3. セルフレビュー実施                                        │
-│    - 既存実装との型・インターフェース整合性                   │
-│    - 要件トレーサビリティ（REQ-* → DES-*）                   │
-│    - 設計パターン・SOLID原則の適用確認                       │
-│    - 後方互換性・移行パスの確認                              │
-│                                                              │
-│ 4. レビュー結果を表示                                        │
-│    ┌───────────────────────────────────────────────────────┐│
-│    │ 📋 レビュー結果:                                       ││
-│    │ ✅ トレーサビリティ: REQ-001→DES-001 完了              ││
-│    │ ✅ 型整合性: 既存インターフェースと互換                 ││
-│    │ ✅ 設計パターン: Repository, Service適用               ││
-│    │                                                        ││
-│    │ 👉 修正しますか？それとも次に進みますか？              ││
-│    │    - 「修正」→ 指摘箇所を修正して再提示               ││
-│    │    - 「承認」→ Phase 3（タスク分解）へ進む            ││
-│    │    ⚠️ 実装への直接遷移は禁止！必ずタスク分解を経る    ││
-│    └───────────────────────────────────────────────────────┘│
-│                                                              │
-│ 5. ユーザー応答待ち                                          │
-│    - 修正指示 → 修正して2へ戻る                             │
-│    - 承認 → Phase 3へ（※Phase 4への直接遷移は禁止）        │
-└─────────────────────────────────────────────────────────────┘
-
-【Phase 3: タスク分解】⚠️ 必須フェーズ - スキップ禁止
-┌─────────────────────────────────────────────────────────────┐
-│ 1. タスク分解書を作成（設計→実装タスク）                     │
-│ 2. ユーザーに提示                                           │
-│                                                              │
-│ 3. セルフレビュー実施                                        │
-│    - 設計との対応確認（DES-* → TSK-*）                       │
-│    - タスクサイズの適切性                                    │
-│    - 依存関係・実行順序の妥当性                              │
-│    - 工数見積もりの現実性                                    │
-│                                                              │
-│ 4. レビュー結果を表示                                        │
-│    ┌───────────────────────────────────────────────────────┐│
-│    │ 📋 レビュー結果:                                       ││
-│    │ ✅ トレーサビリティ: DES-001→TSK-001〜003 完了         ││
-│    │ ✅ タスクサイズ: 各2-4時間で適切                       ││
-│    │ ✅ 依存関係: TSK-001→TSK-002→TSK-003 明確             ││
-│    │                                                        ││
-│    │ 👉 修正しますか？それとも実装に進みますか？            ││
-│    │    - 「修正」→ 指摘箇所を修正して再提示               ││
-│    │    - 「承認」→ Phase 4（実装）へ進む                  ││
-│    └───────────────────────────────────────────────────────┘│
-│                                                              │
-│ 5. ユーザー応答待ち                                          │
-│    - 修正指示 → 修正して2へ戻る                             │
-│    - 承認 → Phase 4へ                                       │
-└─────────────────────────────────────────────────────────────┘
-
-【Phase 4: 実装】⚠️ 前提条件: Phase 3（タスク分解）の承認が必須
-┌─────────────────────────────────────────────────────────────┐
-│ ⛔ 開始前チェック:                                           │
-│    □ Phase 3（タスク分解）が完了し、ユーザー承認済みか？     │
-│    □ TSK-* が定義されているか？                              │
-│    → 未完了の場合、Phase 3に戻ること                        │
-│                                                              │
-│ タスクごとに:                                                │
-│ 1. テスト作成（Red）                                        │
-│ 2. 実装（Green）                                            │
-│ 3. リファクタリング（Blue）                                  │
-│ 4. ユニットテスト実行・合格確認                              │
-│ 5. 必要に応じて統合テスト                                    │
-└─────────────────────────────────────────────────────────────┘
-
-【Phase 5: 完了】
-┌─────────────────────────────────────────────────────────────┐
-│ 1. CHANGELOG.md を更新                                      │
-│ 2. 必要に応じてその他ドキュメント更新                        │
-│ 3. Git コミット・プッシュ                                    │
-└─────────────────────────────────────────────────────────────┘
+Phase 1: Context   │ steering/ 読込 → knowledge search → ADR確認
+        ↓
+Phase 2: Plan      │ スキル選定 → タスク分解 → 依存関係整理
+        ↓
+Phase 3: Execute   │ SDD準拠実装 → パターン適用 → テスト生成
+        ↓
+Phase 4: Verify    │ 形式検証 → トレーサビリティ確認 → レビュー
+        ↓
+Phase 5: Learn     │ Wake-Sleep → パターン抽出 → ナレッジ更新
 ```
 
-### レビュー結果の表示フォーマット
+---
 
-各フェーズ終了時に以下の形式でレビュー結果を表示:
+## 📁 ストレージ構造
 
-```
-📋 **レビュー結果**
+| ディレクトリ | 用途 |
+|--------------|------|
+| `storage/learning/` | 学習データ |
+| `storage/specs/` | SDD仕様 |
+| `storage/design/` | 設計文書 |
+| `storage/changes/` | 変更履歴 |
+| `storage/reviews/` | レビュー記録 |
+| `storage/dashboard/` | メトリクス |
 
-| 観点 | 状態 | 詳細 |
-|------|------|------|
-| チェック項目1 | ✅ OK | 説明 |
-| チェック項目2 | ⚠️ 警告 | 要確認事項 |
-| チェック項目3 | ❌ NG | 修正が必要 |
+---
 
-👉 **次のアクションを選択してください:**
-- 「修正」/ 具体的な修正指示 → 修正して再提示
-- 「承認」/「OK」/「進める」 → 次フェーズへ
-```
+## 🚨 重要な制約
 
-### 承認キーワード
+| 制約 | 理由 |
+|------|------|
+| Node.js 20+ | ESM・最新API |
+| TypeScript strict | 型安全性 |
+| pnpm workspace | モノレポ管理 |
+| Vitest | 高速テスト |
+| ESLint flat config | 統一リント |
 
-ユーザーが以下のキーワードを使用した場合、次フェーズへ進む:
-- `承認` / `approve` / `LGTM` / `進める` / `OK` / `実装`
+---
+
+## 📞 トラブルシューティング
 
-> **⚠️ 注意**: 「実装」キーワードが使われても、**現在のフェーズがPhase 2（設計）の場合は、必ずPhase 3（タスク分解）を先に実行すること**。タスク分解をスキップして実装に進むことは禁止されている。
+| 症状 | 対処 |
+|------|------|
+| 依存解決エラー | `pnpm i --force` |
+| 型エラー | `pnpm build` で再ビルド |
+| テスト失敗 | `pnpm --filter <pkg> test` で個別実行 |
+| MCP接続失敗 | ポート確認、`--debug` オプション |
 
 ---
 
-**Agent**: GitHub Copilot / Claude
-**Last Updated**: 2026-01-11
-**Version**: 3.0.0
+**最終更新**: 2025-01-29 | **バージョン**: 3.7.2