MUSUBIX2 SDD Orchestrator
SDD(Specification Driven Development)ワークフローのルーティングとフェーズ遷移を管理するスキル。
全スキルへのタスク振り分け、Phase 遷移条件の検証、品質ゲート制御、ニューロシンボリック機能の統合を担当する。
前提条件
steering/ を参照済みであること(Article VI: プロジェクトメモリ)
- 対象プロジェクトに SDD ワークフローが適用されていること
⚠️ ワークフロー強制ルール(不可侵)
機能追加・変更・拡張の依頼に対して、実装を直接開始することは禁止である。
必ず以下の順序を守り、各 Phase でユーザーの承認を得ること。
強制フロー
1. 要件定義(Phase 1)
└── requirements-analyst で EARS 要件を作成
└── 情報不足の場合は RequirementsInterviewer で 1問1答ヒアリング
└── ユーザーに要件定義書を提示 → レビュー → ⏸️ 承認待ち
2. 設計(Phase 2)
└── design-generator で設計書を生成
└── SOLID / C4 / ADR を含む
└── ユーザーに設計書を提示 → レビュー → ⏸️ 承認待ち
3. タスク分解(Phase 3)
└── 設計書からタスクを分解(TASK-XXX-NNN 形式)
└── 依存関係 DAG を生成
└── ユーザーにタスク一覧を提示 → レビュー → ⏸️ 承認待ち
4. 実装(Phase 4)
└── タスク順に Red → Green → Blue サイクルで実装
└── 各タスク完了後にテスト実行
5. 完了(Phase 5)
└── 全品質ゲート通過を確認
実装直行の判定と阻止
ユーザー: 「〇〇を実装して」「〇〇を追加して」「〇〇を作って」
│
├── Phase 1 の要件定義書が存在する?
│ ├── NO → 「まず要件を定義します」 → Phase 1 開始
│ └── YES → 承認済み?
│ ├── NO → 「要件のレビューが必要です」 → レビュー依頼
│ └── YES → Phase 2 チェックへ
│
├── Phase 2 の設計書が存在し承認済み?
│ ├── NO → 「設計を行います」 → Phase 2 開始
│ └── YES → Phase 3 チェックへ
│
├── Phase 3 のタスク分解が存在し承認済み?
│ ├── NO → 「タスクを分解します」 → Phase 3 開始
│ └── YES → Phase 4(実装開始許可)
│
└── 全 Phase 承認済み → 実装開始
例外(フル SDD を適用しないケース)
| 種別 |
フロー |
| バグ修正 |
問題分析 → 修正 → テスト |
| ドキュメント修正 |
直接修正 |
| 設定変更・バージョンバンプ |
直接修正 |
| リファクタリング(動作変更なし) |
テスト確認 → 修正 → テスト |
ルーティングルール
WHEN/DO マッピング
| WHEN(トリガー) |
DO(スキル / パッケージ) |
| 要件を作成・分析・検証する |
→ requirements-analyst |
| 要件ヒアリング・情報収集する |
→ requirements-analyst (RequirementsInterviewer: 1問1答) |
| 設計書を生成・レビュー・検証する |
→ design-generator |
| コードを生成・スキャフォールド・解析する |
→ code-generator |
| テストを作成・実行・カバレッジ確認する |
→ test-engineer |
| トレーサビリティを確認・マトリクス生成する |
→ traceability-auditor |
| 憲法準拠・ポリシー違反を検証する |
→ constitution-enforcer |
| レビュー・合意チェック・品質検証する |
→ review-orchestrator |
| 形式検証・SMT・Z3 検証する |
→ @musubix2/formal-verify |
| Lean 4 定理証明・ハイブリッド検証する |
→ @musubix2/lean |
| コード解析・AST・依存グラフを生成する |
→ @musubix2/codegraph |
| データフロー・制御フロー分析する |
→ @musubix2/dfg |
| ニューラル検索・類似度検索する |
→ @musubix2/neural-search |
| プログラム合成・DSL 変換する |
→ @musubix2/synthesis |
| パターン学習・E-graph 最適化する |
→ @musubix2/library-learner |
| Wake-Sleep パターン抽出・統合する |
→ @musubix2/wake-sleep |
| 知識グラフ操作・エンティティ管理する |
→ @musubix2/knowledge |
| オントロジー・トリプルストア・推論する |
→ @musubix2/ontology-mcp |
| セキュリティスキャン・脆弱性検出する |
→ @musubix2/security |
| リサーチ・調査・知識蓄積する |
→ @musubix2/deep-research |
| ADR・アーキテクチャ決定を記録する |
→ @musubix2/decisions |
| ドメイン分類・ドリフト分析する |
→ @musubix2/assistant-axis |
| Git 履歴から知識を抽出する |
→ @musubix2/git-knowledge |
| MCP ツール呼出・プロンプト・リソース取得する |
→ @musubix2/mcp-server |
| 多言語 AST 解析する(Python/Java/Go/Rust 等) |
→ @musubix2/codegraph (MultiLanguageParser) |
| SDD ワークフロー全体を実行する |
→ orchestrator(Phase 遷移ルール参照) |
Phase 遷移ルール
Phase 1 (Requirements) ──⏸️承認──→ Phase 2 (Design) ──⏸️承認──→ Phase 3 (Task Breakdown)
──⏸️承認──→ Phase 4 (Implementation) ──⏸️承認──→ Phase 5 (Complete)
遷移条件
| 遷移 |
条件 |
検証ツール |
| Phase 1 → 2 |
全要件が EARS 形式準拠、requirements-analyst 検証 PASS |
requirements-analyst, @musubix2/formal-verify |
| Phase 2 → 3 |
全 DES が REQ にトレース可能、design-generator 検証 PASS |
design-generator, traceability-auditor |
| Phase 3 → 4 |
タスク分解完了、カバレッジ 100% |
traceability-auditor, @musubix2/workflow-engine |
| Phase 4 → 5 |
テストカバレッジ 80%+、全条項 PASS、形式検証 PASS |
constitution-enforcer, @musubix2/formal-verify, @musubix2/lean |
⏸️ 承認ポイント
各 Phase 遷移時にユーザー承認を要求する。自動スキップ禁止。
Phase 3: タスク分解プロセス
Phase 2 (Design) 承認後、実装に入る前にタスク分解を実施する。
タスク分解フォーマット
各タスクは以下の形式で記述する:
### TASK-XXX-NNN: タスクタイトル
**トレーサビリティ**: REQ-XXX-NNN → DES-XXX-NNN
**パッケージ**: 対象パッケージ名
**種別**: backend / frontend / api / test / infra
**優先度**: P0 / P1 / P2
**依存**: TASK-XXX-NNN(なければ「なし」)
**実装内容**:
- 具体的な実装手順 1
- 具体的な実装手順 2
**受入基準**:
- [ ] テストが書かれている(Red)
- [ ] テストが通る(Green)
- [ ] リファクタリング済み(Blue)
分解ルール
- 1タスク = 1機能単位: 1つのAPIエンドポイント、1つのUIコンポーネント、1つのミドルウェア等
- 粒度基準: 1タスクは最大 2時間以内で完了できるサイズ
- REQ/DES マッピング必須: すべてのタスクは最低1つの REQ と DES にトレース可能
- テストファースト: 各タスクに Red→Green→Blue サイクルの受入基準を含める
- 依存関係の明示: 他タスクへの依存がある場合は
依存 フィールドに記載
分解プロセス
DES 一覧を入力
│
├── 1. DES ごとにバックエンドタスクを抽出
│ ├── データモデル定義 → TASK-MDL-*
│ ├── API ルート実装 → TASK-API-*
│ └── ミドルウェア → TASK-MID-*
│
├── 2. DES ごとにフロントエンドタスクを抽出
│ ├── HTML ページ → TASK-UI-*
│ ├── CSS スタイル → TASK-CSS-*
│ └── JS ロジック → TASK-JS-*
│
├── 3. 横断的タスクを抽出
│ ├── セキュリティ → TASK-SEC-*
│ ├── バリデーション → TASK-VAL-*
│ ├── エラーハンドリング → TASK-ERR-*
│ └── インフラ → TASK-INF-*
│
├── 4. テストタスクを抽出
│ ├── ユニットテスト → TASK-TST-*
│ ├── 統合テスト → TASK-INT-*
│ └── E2Eテスト → TASK-E2E-*
│
└── 5. 依存関係グラフを生成
└── DAG で実行順序を決定
タスク分解の品質ゲート
Phase 3 → 4 遷移には以下をすべて満たすこと:
| チェック項目 |
基準 |
| REQ カバレッジ |
全 REQ に対応するタスクが存在する(100%) |
| DES カバレッジ |
全 DES に対応するタスクが存在する(100%) |
| テストタスク |
各機能タスクに対応するテストタスクが存在する |
| 依存関係 |
循環依存がない(DAG である) |
| 粒度 |
全タスクが推定2時間以内 |
| フォーマット |
全タスクが TASK-XXX-NNN 形式に準拠 |
タスク分解レビュー
タスク分解文書もレビュー対象とする:
traceability-auditor で REQ↔DES↔TASK のカバレッジを検証
- 依存関係グラフに循環がないことを確認
- タスク粒度が適切であることを確認
- ユーザー承認 を取得してから Phase 4 へ遷移
使用パッケージ
@musubix2/workflow-engine — TaskBreakdownManager: タスク分解・依存管理
@musubix2/codegraph — ASTParser, GraphEngine: 既存コード構造からの依存分析
@musubix2/dfg — DataFlowAnalyzer: データフロー依存の抽出
ニューロシンボリック統合
SDD ワークフローの各フェーズでニューロシンボリック機能を活用する。
ニューラル側(学習・検索・パターン認識)
| パッケージ |
主要クラス |
機能 / SDD での利用場面 |
neural-search |
TfIdfEmbeddingModel, NeuralSearchEngine |
TF-IDF 埋込み + コサイン類似度検索 — 類似要件検索、既存設計の参照、コード重複検出 |
wake-sleep |
WakePhase, SleepPhase, CycleManager |
N-gram + PMI 統計パターン抽出 — コードパターンの自動学習、設計パターン発見 |
library-learner |
EGraphEngine, LibraryLearner |
E-graph 等価クラス + 構造類似性マージ — ライブラリ抽象化の発見、リファクタリング候補 |
deep-research |
ResearchEngine, DepthFirstStrategy, BreadthFirstStrategy |
反復リサーチ + 証拠チェーン — 技術調査、ベストプラクティス収集 |
シンボリック側(論理・検証・推論)
| パッケージ |
主要クラス |
機能 / SDD での利用場面 |
formal-verify |
EarsToSmtConverter, Z3Adapter, PreconditionVerifier |
EARS → SMT-LIB2 変換 + Z3 検証 — 要件の形式的一貫性検証、矛盾検出 |
lean |
LeanProofRunner, EarsToLeanConverter, HybridVerifier |
Lean 4 定理変換 + 証明実行 — 安全性要件の定理証明、ハイブリッド検証 |
codegraph |
ASTParser, MultiLanguageParser, GraphEngine, GraphRAGSearch |
多言語 AST 解析(6言語)+ GraphRAG — コード構造分析、影響範囲分析 |
dfg |
DataFlowAnalyzer |
DFG/CFG 構築 + 到達定義 — データフロー分析、セキュリティ汚染解析 |
ontology-mcp |
N3Store, RuleEngine, ConsistencyValidator |
N3 トリプルストア + 推論 — ドメインモデル推論、制約検証 |
knowledge |
FileKnowledgeStore |
エンティティ関係グラフ — プロジェクト知識管理、関係探索 |
git-knowledge |
GitLogParser, GitKnowledgeBuilder |
Git log/blame + 共変更分析 — Git 履歴からの知識自動抽出 |
統合・制御側(合成・変換・ワークフロー)
| パッケージ |
主要クラス |
機能 / SDD での利用場面 |
synthesis |
DSLBuilder, SynthesisEngine, VersionSpaceManager |
DSL ビルダー(16変換)— コード変換自動化、例示プログラミング |
security |
SecurityScanner, TaintAnalyzer |
脆弱性スキャン、汚染解析 |
decisions |
DecisionManager |
ADR 記録・管理 |
assistant-axis |
DomainClassifier, DriftAnalyzer |
ドメイン分類・ドリフト分析 |
pattern-mcp |
— |
AST パターン抽出 — パターンカタログ管理 |
sdd-ontology |
— |
SDD ドメイン概念 + Turtle 定義 — ワークフロー意味モデル |
workflow-engine |
PhaseController, StateTracker, TaskBreakdownManager |
Phase 遷移制御・タスク分解 |
agent-orchestrator |
SubagentDispatcher, ReviewOrchestrator |
サブエージェント振り分け・交互レビュー |
policy |
PolicyEngine, QualityGateRunner |
憲法検証・品質ゲート実行 |
mcp-server |
MCPServer, MCPToolRegistry, StdioTransport, SSETransport |
MCP プロトコルでのツール提供 |
skill-manager |
SkillRegistry, SkillManager, SkillExecutor |
スキル登録・実行 |
Phase 別ニューロシンボリック活用マップ
Phase 1 (Requirements)
├── RequirementsInterviewer: 情報不足時の1問1答ヒアリング
├── RequirementsDocGenerator: 収集情報から EARS 要件定義書生成
├── neural-search: 類似要件検索
├── formal-verify: EARS 形式検証 (SMT)
├── knowledge: 要件間関係グラフ
└── deep-research: 技術調査・ベストプラクティス
Phase 2 (Design)
├── codegraph: 既存コード構造分析 (MultiLanguageParser)
├── git-knowledge: Git 履歴からの共変更・エキスパート分析
├── ontology-mcp: ドメインモデル推論
├── neural-search: 類似設計パターン検索
└── decisions: ADR 記録
Phase 3 (Task Breakdown)
├── dfg: データフロー依存分析
├── library-learner: 再利用可能パターン発見
└── synthesis: タスク変換ルール生成
Phase 4 (Implementation)
├── codegraph: AST 解析 + 影響範囲分析 (MultiLanguageParser)
├── git-knowledge: 共変更ファイル検出、著者エキスパート特定
├── wake-sleep: コードパターン学習
├── synthesis: コード変換自動化
├── security: 脆弱性スキャン
└── lean: 安全性証明(オプション)
Phase 5 (Complete)
├── formal-verify: 最終一貫性検証
├── lean: ハイブリッド検証
├── knowledge: プロジェクト知識更新
├── git-knowledge: 最終 Git 知識グラフ構築
└── wake-sleep: 学習パターン統合
レビューオーケストレーション
SDD 成果物の品質保証には review-orchestrator スキルを使用する。
詳細は skills/review-orchestrator/SKILL.md を参照。
プロセス
- 各フェーズの成果物が完成したら
review-orchestrator を起動
- opus-4.6 と gpt-5.4 が交互にレビュー(エラー 0 まで)
- 両モデルの最終合意チェック(両方 PASS 必須)
- 全アーティファクト承認後に実装フェーズへ遷移可能
ルーティング
| トリガー |
スキル |
| レビュー / review / 品質検証 |
review-orchestrator |
| 合意チェック / consensus |
review-orchestrator |
| 実装許可 / proceed to implementation |
review-orchestrator |
MCP サーバー統合
クライアント(Claude Code / Copilot / Cursor)は stdio(StdioTransport)または
HTTP/SSE(SSETransport)経由で MCPServer に接続する。
レジストリは 3 種: MCPToolRegistry(61 tools)、PromptRegistry(4 prompts)、ResourceRegistry(3 resources)。
ツールカテゴリ(13カテゴリ / 61ツール)
| カテゴリ |
ツール数 |
代表的なツール |
| sdd-core |
12 |
sdd.requirements.create, sdd.requirements.interview.*, sdd.codegen.generate |
| knowledge |
7 |
knowledge.entity.get, knowledge.search, knowledge.traverse |
| policy |
3 |
policy.validate, policy.gate.run |
| ontology |
5 |
ontology.triple.add, ontology.sparql.query |
| code-analysis |
4 |
code.parse, code.graph.build, code.dfg.analyze |
| security |
4 |
security.scan, security.secrets.detect, security.taint.analyze |
| research |
3 |
research.query, research.iterative, research.evidence |
| neural |
5 |
neural.search, neural.embed, neural.patterns.extract |
| synthesis |
3 |
synthesis.dsl.build, synthesis.synthesize |
| formal-verify |
5 |
verify.z3.solve, verify.lean.run, verify.hybrid |
| workflow |
4 |
workflow.phase.current, workflow.gate.check |
| decisions |
3 |
decisions.create, decisions.list, decisions.search |
| skills |
3 |
skills.list, skills.register, skills.execute |
プロンプトテンプレート
| 名前 |
用途 |
sdd-requirements-template |
EARS 形式要件テンプレート |
sdd-design-template |
設計文書テンプレート |
sdd-review-checklist |
レビューチェックリスト |
sdd-task-breakdown-template |
タスク分解テンプレート |
リソース
| URI |
内容 |
musubix://constitution |
憲法条項一覧 |
musubix://ears-patterns |
EARS パターンリファレンス |
musubix://workflow-phases |
SDD ワークフローフェーズ定義 |
CLI コマンドマッピング
| CLI コマンド |
パッケージ |
説明 |
musubix init |
musubi |
プロジェクト初期化 |
musubix tasks |
workflow-engine |
タスク管理 (validate/list/stats) |
musubix req |
core |
要件管理 (analyze/validate) |
musubix req:wizard |
core |
要件作成ウィザード |
musubix req:interview |
core |
1問1答ヒアリング → 要件定義書生成 |
musubix design |
core |
設計生成 |
musubix design:c4 |
core |
C4 ダイアグラム生成 |
musubix design:verify |
core |
設計検証 |
musubix codegen |
core |
コード生成 |
musubix test:gen |
core |
テスト生成 |
musubix trace |
core |
トレーサビリティ検証 |
musubix trace:verify |
core |
トレーサビリティ詳細検証 |
musubix policy |
policy |
ポリシー検証 |
musubix ontology |
ontology-mcp |
オントロジー管理 |
musubix cg |
codegraph |
コードグラフ解析 |
musubix security |
security |
セキュリティスキャン |
musubix workflow |
workflow-engine |
ワークフロー管理 |
musubix status |
workflow-engine |
ステータス表示 |
musubix skills |
skill-manager |
スキル管理 (list/validate/create) |
musubix knowledge |
knowledge |
知識グラフ操作 (get/put/search/traverse/stats) |
musubix decision |
decisions |
ADR 管理 (create/list/accept/deprecate/search) |
musubix deep-research |
deep-research |
リサーチ (query/iterative/evidence) |
musubix repl |
core |
対話型 REPL |
musubix scaffold |
core |
プロジェクトスキャフォールド |
musubix explain |
core |
コード説明 |
musubix learn |
library-learner |
ライブラリパターン学習 |
musubix synthesis |
synthesis |
プログラム合成 (dsl/fromExamples) |
musubix watch |
core |
ファイル監視・自動再検証 |
禁止事項
- Phase をスキップしてはならない
- 承認なしで次 Phase に遷移してはならない
- テストなしでコードをコミットしてはならない
- EARS 形式に従わない要件を承認してはならない
- steering/ の参照をスキップしてはならない
- 形式検証をスキップして Phase 4→5 に遷移してはならない
緊急度トリアージ
| 緊急度 |
対応 |
| 🔴 Critical |
constitution-enforcer 違反 → 即時修正、Phase 進行ブロック |
| 🔴 Critical |
formal-verify 矛盾検出 → 要件修正まで Phase 進行ブロック |
| 🟡 Major |
テストカバレッジ不足 → test-engineer で補完後に進行 |
| 🟡 Major |
セキュリティ脆弱性検出 → security で修正後に進行 |
| 🟢 Minor |
ドキュメント不備 → 次回レビューで対応可 |
スクリプト
| スクリプト |
説明 |
使い方 |
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 |
1---2name: orchestrator-93description: >4 SDD ワークフロー全体のオーケストレーション — スキルルーティング、フェーズ遷移管理、品質ゲート制御、5 ニューロシンボリック機能統合、MCP サーバー制御、CLI コマンドディスパッチ。6 Use when routing tasks to the correct skill, managing phase transitions,7 running the full SDD workflow, invoking neurosymbolic capabilities,8 or serving tools via MCP protocol.9license: MIT10version: "3.0.1"11triggers:12 - ワークフロー13 - フェーズ遷移14 - オーケストレーション15 - タスクルーティング16 - SDD 全体管理17 - phase transition18 - orchestrate19 - route20 - 形式検証21 - formal verification22 - neural search23 - synthesis24 - research25 - MCP26 - tool catalog27 - git knowledge28 - multi-language parser29metadata:30 source: https://skillmd.com/skills/nahisaho/orchestrator-931---3233# MUSUBIX2 SDD Orchestrator3435SDD(Specification Driven Development)ワークフローのルーティングとフェーズ遷移を管理するスキル。36全スキルへのタスク振り分け、Phase 遷移条件の検証、品質ゲート制御、ニューロシンボリック機能の統合を担当する。3738## 前提条件3940- `steering/` を参照済みであること(Article VI: プロジェクトメモリ)41- 対象プロジェクトに SDD ワークフローが適用されていること4243## ⚠️ ワークフロー強制ルール(不可侵)4445**機能追加・変更・拡張の依頼に対して、実装を直接開始することは禁止である。**46**必ず以下の順序を守り、各 Phase でユーザーの承認を得ること。**4748### 強制フロー4950```511. 要件定義(Phase 1)52 └── requirements-analyst で EARS 要件を作成53 └── 情報不足の場合は RequirementsInterviewer で 1問1答ヒアリング54 └── ユーザーに要件定義書を提示 → レビュー → ⏸️ 承認待ち55562. 設計(Phase 2)57 └── design-generator で設計書を生成58 └── SOLID / C4 / ADR を含む59 └── ユーザーに設計書を提示 → レビュー → ⏸️ 承認待ち60613. タスク分解(Phase 3)62 └── 設計書からタスクを分解(TASK-XXX-NNN 形式)63 └── 依存関係 DAG を生成64 └── ユーザーにタスク一覧を提示 → レビュー → ⏸️ 承認待ち65664. 実装(Phase 4)67 └── タスク順に Red → Green → Blue サイクルで実装68 └── 各タスク完了後にテスト実行69705. 完了(Phase 5)71 └── 全品質ゲート通過を確認72```7374### 実装直行の判定と阻止7576```77ユーザー: 「〇〇を実装して」「〇〇を追加して」「〇〇を作って」78 │79 ├── Phase 1 の要件定義書が存在する?80 │ ├── NO → 「まず要件を定義します」 → Phase 1 開始81 │ └── YES → 承認済み?82 │ ├── NO → 「要件のレビューが必要です」 → レビュー依頼83 │ └── YES → Phase 2 チェックへ84 │85 ├── Phase 2 の設計書が存在し承認済み?86 │ ├── NO → 「設計を行います」 → Phase 2 開始87 │ └── YES → Phase 3 チェックへ88 │89 ├── Phase 3 のタスク分解が存在し承認済み?90 │ ├── NO → 「タスクを分解します」 → Phase 3 開始91 │ └── YES → Phase 4(実装開始許可)92 │93 └── 全 Phase 承認済み → 実装開始94```9596### 例外(フル SDD を適用しないケース)9798| 種別 | フロー |99|------|--------|100| バグ修正 | 問題分析 → 修正 → テスト |101| ドキュメント修正 | 直接修正 |102| 設定変更・バージョンバンプ | 直接修正 |103| リファクタリング(動作変更なし) | テスト確認 → 修正 → テスト |104105## ルーティングルール106107### WHEN/DO マッピング108109| WHEN(トリガー) | DO(スキル / パッケージ) |110|------------------|--------------------------|111| 要件を作成・分析・検証する | → `requirements-analyst` |112| 要件ヒアリング・情報収集する | → `requirements-analyst` (RequirementsInterviewer: 1問1答) |113| 設計書を生成・レビュー・検証する | → `design-generator` |114| コードを生成・スキャフォールド・解析する | → `code-generator` |115| テストを作成・実行・カバレッジ確認する | → `test-engineer` |116| トレーサビリティを確認・マトリクス生成する | → `traceability-auditor` |117| 憲法準拠・ポリシー違反を検証する | → `constitution-enforcer` |118| レビュー・合意チェック・品質検証する | → `review-orchestrator` |119| 形式検証・SMT・Z3 検証する | → `@musubix2/formal-verify` |120| Lean 4 定理証明・ハイブリッド検証する | → `@musubix2/lean` |121| コード解析・AST・依存グラフを生成する | → `@musubix2/codegraph` |122| データフロー・制御フロー分析する | → `@musubix2/dfg` |123| ニューラル検索・類似度検索する | → `@musubix2/neural-search` |124| プログラム合成・DSL 変換する | → `@musubix2/synthesis` |125| パターン学習・E-graph 最適化する | → `@musubix2/library-learner` |126| Wake-Sleep パターン抽出・統合する | → `@musubix2/wake-sleep` |127| 知識グラフ操作・エンティティ管理する | → `@musubix2/knowledge` |128| オントロジー・トリプルストア・推論する | → `@musubix2/ontology-mcp` |129| セキュリティスキャン・脆弱性検出する | → `@musubix2/security` |130| リサーチ・調査・知識蓄積する | → `@musubix2/deep-research` |131| ADR・アーキテクチャ決定を記録する | → `@musubix2/decisions` |132| ドメイン分類・ドリフト分析する | → `@musubix2/assistant-axis` |133| Git 履歴から知識を抽出する | → `@musubix2/git-knowledge` |134| MCP ツール呼出・プロンプト・リソース取得する | → `@musubix2/mcp-server` |135| 多言語 AST 解析する(Python/Java/Go/Rust 等) | → `@musubix2/codegraph` (MultiLanguageParser) |136| SDD ワークフロー全体を実行する | → `orchestrator`(Phase 遷移ルール参照) |137138## Phase 遷移ルール139140```141Phase 1 (Requirements) ──⏸️承認──→ Phase 2 (Design) ──⏸️承認──→ Phase 3 (Task Breakdown)142 ──⏸️承認──→ Phase 4 (Implementation) ──⏸️承認──→ Phase 5 (Complete)143```144145### 遷移条件146147| 遷移 | 条件 | 検証ツール |148|------|------|-----------|149| Phase 1 → 2 | 全要件が EARS 形式準拠、requirements-analyst 検証 PASS | `requirements-analyst`, `@musubix2/formal-verify` |150| Phase 2 → 3 | 全 DES が REQ にトレース可能、design-generator 検証 PASS | `design-generator`, `traceability-auditor` |151| Phase 3 → 4 | タスク分解完了、カバレッジ 100% | `traceability-auditor`, `@musubix2/workflow-engine` |152| Phase 4 → 5 | テストカバレッジ 80%+、全条項 PASS、形式検証 PASS | `constitution-enforcer`, `@musubix2/formal-verify`, `@musubix2/lean` |153154### ⏸️ 承認ポイント155156各 Phase 遷移時にユーザー承認を要求する。自動スキップ禁止。157158## Phase 3: タスク分解プロセス159160Phase 2 (Design) 承認後、実装に入る前にタスク分解を実施する。161162### タスク分解フォーマット163164各タスクは以下の形式で記述する:165166```markdown167### TASK-XXX-NNN: タスクタイトル168169**トレーサビリティ**: REQ-XXX-NNN → DES-XXX-NNN170**パッケージ**: 対象パッケージ名171**種別**: backend / frontend / api / test / infra172**優先度**: P0 / P1 / P2173**依存**: TASK-XXX-NNN(なければ「なし」)174175**実装内容**:176- 具体的な実装手順 1177- 具体的な実装手順 2178179**受入基準**:180- [ ] テストが書かれている(Red)181- [ ] テストが通る(Green)182- [ ] リファクタリング済み(Blue)183```184185### 分解ルール1861871. **1タスク = 1機能単位**: 1つのAPIエンドポイント、1つのUIコンポーネント、1つのミドルウェア等1882. **粒度基準**: 1タスクは最大 2時間以内で完了できるサイズ1893. **REQ/DES マッピング必須**: すべてのタスクは最低1つの REQ と DES にトレース可能1904. **テストファースト**: 各タスクに Red→Green→Blue サイクルの受入基準を含める1915. **依存関係の明示**: 他タスクへの依存がある場合は `依存` フィールドに記載192193### 分解プロセス194195```196DES 一覧を入力197 │198 ├── 1. DES ごとにバックエンドタスクを抽出199 │ ├── データモデル定義 → TASK-MDL-*200 │ ├── API ルート実装 → TASK-API-*201 │ └── ミドルウェア → TASK-MID-*202 │203 ├── 2. DES ごとにフロントエンドタスクを抽出204 │ ├── HTML ページ → TASK-UI-*205 │ ├── CSS スタイル → TASK-CSS-*206 │ └── JS ロジック → TASK-JS-*207 │208 ├── 3. 横断的タスクを抽出209 │ ├── セキュリティ → TASK-SEC-*210 │ ├── バリデーション → TASK-VAL-*211 │ ├── エラーハンドリング → TASK-ERR-*212 │ └── インフラ → TASK-INF-*213 │214 ├── 4. テストタスクを抽出215 │ ├── ユニットテスト → TASK-TST-*216 │ ├── 統合テスト → TASK-INT-*217 │ └── E2Eテスト → TASK-E2E-*218 │219 └── 5. 依存関係グラフを生成220 └── DAG で実行順序を決定221```222223### タスク分解の品質ゲート224225Phase 3 → 4 遷移には以下をすべて満たすこと:226227| チェック項目 | 基準 |228|-------------|------|229| REQ カバレッジ | 全 REQ に対応するタスクが存在する(100%) |230| DES カバレッジ | 全 DES に対応するタスクが存在する(100%) |231| テストタスク | 各機能タスクに対応するテストタスクが存在する |232| 依存関係 | 循環依存がない(DAG である) |233| 粒度 | 全タスクが推定2時間以内 |234| フォーマット | 全タスクが TASK-XXX-NNN 形式に準拠 |235236### タスク分解レビュー237238タスク分解文書もレビュー対象とする:2392401. `traceability-auditor` で REQ↔DES↔TASK のカバレッジを検証2412. 依存関係グラフに循環がないことを確認2423. タスク粒度が適切であることを確認2434. **ユーザー承認** を取得してから Phase 4 へ遷移244245### 使用パッケージ246247- `@musubix2/workflow-engine` — `TaskBreakdownManager`: タスク分解・依存管理248- `@musubix2/codegraph` — `ASTParser`, `GraphEngine`: 既存コード構造からの依存分析249- `@musubix2/dfg` — `DataFlowAnalyzer`: データフロー依存の抽出250251## ニューロシンボリック統合252253SDD ワークフローの各フェーズでニューロシンボリック機能を活用する。254255### ニューラル側(学習・検索・パターン認識)256257| パッケージ | 主要クラス | 機能 / SDD での利用場面 |258|-----------|-----------|------------------------|259| `neural-search` | `TfIdfEmbeddingModel`, `NeuralSearchEngine` | TF-IDF 埋込み + コサイン類似度検索 — 類似要件検索、既存設計の参照、コード重複検出 |260| `wake-sleep` | `WakePhase`, `SleepPhase`, `CycleManager` | N-gram + PMI 統計パターン抽出 — コードパターンの自動学習、設計パターン発見 |261| `library-learner` | `EGraphEngine`, `LibraryLearner` | E-graph 等価クラス + 構造類似性マージ — ライブラリ抽象化の発見、リファクタリング候補 |262| `deep-research` | `ResearchEngine`, `DepthFirstStrategy`, `BreadthFirstStrategy` | 反復リサーチ + 証拠チェーン — 技術調査、ベストプラクティス収集 |263264### シンボリック側(論理・検証・推論)265266| パッケージ | 主要クラス | 機能 / SDD での利用場面 |267|-----------|-----------|------------------------|268| `formal-verify` | `EarsToSmtConverter`, `Z3Adapter`, `PreconditionVerifier` | EARS → SMT-LIB2 変換 + Z3 検証 — 要件の形式的一貫性検証、矛盾検出 |269| `lean` | `LeanProofRunner`, `EarsToLeanConverter`, `HybridVerifier` | Lean 4 定理変換 + 証明実行 — 安全性要件の定理証明、ハイブリッド検証 |270| `codegraph` | `ASTParser`, `MultiLanguageParser`, `GraphEngine`, `GraphRAGSearch` | 多言語 AST 解析(6言語)+ GraphRAG — コード構造分析、影響範囲分析 |271| `dfg` | `DataFlowAnalyzer` | DFG/CFG 構築 + 到達定義 — データフロー分析、セキュリティ汚染解析 |272| `ontology-mcp` | `N3Store`, `RuleEngine`, `ConsistencyValidator` | N3 トリプルストア + 推論 — ドメインモデル推論、制約検証 |273| `knowledge` | `FileKnowledgeStore` | エンティティ関係グラフ — プロジェクト知識管理、関係探索 |274| `git-knowledge` | `GitLogParser`, `GitKnowledgeBuilder` | Git log/blame + 共変更分析 — Git 履歴からの知識自動抽出 |275276### 統合・制御側(合成・変換・ワークフロー)277278| パッケージ | 主要クラス | 機能 / SDD での利用場面 |279|-----------|-----------|------------------------|280| `synthesis` | `DSLBuilder`, `SynthesisEngine`, `VersionSpaceManager` | DSL ビルダー(16変換)— コード変換自動化、例示プログラミング |281| `security` | `SecurityScanner`, `TaintAnalyzer` | 脆弱性スキャン、汚染解析 |282| `decisions` | `DecisionManager` | ADR 記録・管理 |283| `assistant-axis` | `DomainClassifier`, `DriftAnalyzer` | ドメイン分類・ドリフト分析 |284| `pattern-mcp` | — | AST パターン抽出 — パターンカタログ管理 |285| `sdd-ontology` | — | SDD ドメイン概念 + Turtle 定義 — ワークフロー意味モデル |286| `workflow-engine` | `PhaseController`, `StateTracker`, `TaskBreakdownManager` | Phase 遷移制御・タスク分解 |287| `agent-orchestrator` | `SubagentDispatcher`, `ReviewOrchestrator` | サブエージェント振り分け・交互レビュー |288| `policy` | `PolicyEngine`, `QualityGateRunner` | 憲法検証・品質ゲート実行 |289| `mcp-server` | `MCPServer`, `MCPToolRegistry`, `StdioTransport`, `SSETransport` | MCP プロトコルでのツール提供 |290| `skill-manager` | `SkillRegistry`, `SkillManager`, `SkillExecutor` | スキル登録・実行 |291292### Phase 別ニューロシンボリック活用マップ293294```295Phase 1 (Requirements)296 ├── RequirementsInterviewer: 情報不足時の1問1答ヒアリング297 ├── RequirementsDocGenerator: 収集情報から EARS 要件定義書生成298 ├── neural-search: 類似要件検索299 ├── formal-verify: EARS 形式検証 (SMT)300 ├── knowledge: 要件間関係グラフ301 └── deep-research: 技術調査・ベストプラクティス302303Phase 2 (Design)304 ├── codegraph: 既存コード構造分析 (MultiLanguageParser)305 ├── git-knowledge: Git 履歴からの共変更・エキスパート分析306 ├── ontology-mcp: ドメインモデル推論307 ├── neural-search: 類似設計パターン検索308 └── decisions: ADR 記録309310Phase 3 (Task Breakdown)311 ├── dfg: データフロー依存分析312 ├── library-learner: 再利用可能パターン発見313 └── synthesis: タスク変換ルール生成314315Phase 4 (Implementation)316 ├── codegraph: AST 解析 + 影響範囲分析 (MultiLanguageParser)317 ├── git-knowledge: 共変更ファイル検出、著者エキスパート特定318 ├── wake-sleep: コードパターン学習319 ├── synthesis: コード変換自動化320 ├── security: 脆弱性スキャン321 └── lean: 安全性証明(オプション)322323Phase 5 (Complete)324 ├── formal-verify: 最終一貫性検証325 ├── lean: ハイブリッド検証326 ├── knowledge: プロジェクト知識更新327 ├── git-knowledge: 最終 Git 知識グラフ構築328 └── wake-sleep: 学習パターン統合329```330331## レビューオーケストレーション332333SDD 成果物の品質保証には `review-orchestrator` スキルを使用する。334詳細は `skills/review-orchestrator/SKILL.md` を参照。335336### プロセス3373381. 各フェーズの成果物が完成したら `review-orchestrator` を起動3392. opus-4.6 と gpt-5.4 が交互にレビュー(エラー 0 まで)3403. 両モデルの最終合意チェック(両方 PASS 必須)3414. 全アーティファクト承認後に実装フェーズへ遷移可能342343### ルーティング344345| トリガー | スキル |346|---------|--------|347| レビュー / review / 品質検証 | `review-orchestrator` |348| 合意チェック / consensus | `review-orchestrator` |349| 実装許可 / proceed to implementation | `review-orchestrator` |350351## MCP サーバー統合352353クライアント(Claude Code / Copilot / Cursor)は stdio(`StdioTransport`)または354HTTP/SSE(`SSETransport`)経由で `MCPServer` に接続する。355レジストリは 3 種: `MCPToolRegistry`(61 tools)、`PromptRegistry`(4 prompts)、`ResourceRegistry`(3 resources)。356357### ツールカテゴリ(13カテゴリ / 61ツール)358359| カテゴリ | ツール数 | 代表的なツール |360|---------|---------|---------------|361| sdd-core | 12 | sdd.requirements.create, sdd.requirements.interview.*, sdd.codegen.generate |362| knowledge | 7 | knowledge.entity.get, knowledge.search, knowledge.traverse |363| policy | 3 | policy.validate, policy.gate.run |364| ontology | 5 | ontology.triple.add, ontology.sparql.query |365| code-analysis | 4 | code.parse, code.graph.build, code.dfg.analyze |366| security | 4 | security.scan, security.secrets.detect, security.taint.analyze |367| research | 3 | research.query, research.iterative, research.evidence |368| neural | 5 | neural.search, neural.embed, neural.patterns.extract |369| synthesis | 3 | synthesis.dsl.build, synthesis.synthesize |370| formal-verify | 5 | verify.z3.solve, verify.lean.run, verify.hybrid |371| workflow | 4 | workflow.phase.current, workflow.gate.check |372| decisions | 3 | decisions.create, decisions.list, decisions.search |373| skills | 3 | skills.list, skills.register, skills.execute |374375### プロンプトテンプレート376377| 名前 | 用途 |378|------|------|379| `sdd-requirements-template` | EARS 形式要件テンプレート |380| `sdd-design-template` | 設計文書テンプレート |381| `sdd-review-checklist` | レビューチェックリスト |382| `sdd-task-breakdown-template` | タスク分解テンプレート |383384### リソース385386| URI | 内容 |387|-----|------|388| `musubix://constitution` | 憲法条項一覧 |389| `musubix://ears-patterns` | EARS パターンリファレンス |390| `musubix://workflow-phases` | SDD ワークフローフェーズ定義 |391392## CLI コマンドマッピング393394| CLI コマンド | パッケージ | 説明 |395|-------------|-----------|------|396| `musubix init` | musubi | プロジェクト初期化 |397| `musubix tasks` | workflow-engine | タスク管理 (validate/list/stats) |398| `musubix req` | core | 要件管理 (analyze/validate) |399| `musubix req:wizard` | core | 要件作成ウィザード |400| `musubix req:interview` | core | 1問1答ヒアリング → 要件定義書生成 |401| `musubix design` | core | 設計生成 |402| `musubix design:c4` | core | C4 ダイアグラム生成 |403| `musubix design:verify` | core | 設計検証 |404| `musubix codegen` | core | コード生成 |405| `musubix test:gen` | core | テスト生成 |406| `musubix trace` | core | トレーサビリティ検証 |407| `musubix trace:verify` | core | トレーサビリティ詳細検証 |408| `musubix policy` | policy | ポリシー検証 |409| `musubix ontology` | ontology-mcp | オントロジー管理 |410| `musubix cg` | codegraph | コードグラフ解析 |411| `musubix security` | security | セキュリティスキャン |412| `musubix workflow` | workflow-engine | ワークフロー管理 |413| `musubix status` | workflow-engine | ステータス表示 |414| `musubix skills` | skill-manager | スキル管理 (list/validate/create) |415| `musubix knowledge` | knowledge | 知識グラフ操作 (get/put/search/traverse/stats) |416| `musubix decision` | decisions | ADR 管理 (create/list/accept/deprecate/search) |417| `musubix deep-research` | deep-research | リサーチ (query/iterative/evidence) |418| `musubix repl` | core | 対話型 REPL |419| `musubix scaffold` | core | プロジェクトスキャフォールド |420| `musubix explain` | core | コード説明 |421| `musubix learn` | library-learner | ライブラリパターン学習 |422| `musubix synthesis` | synthesis | プログラム合成 (dsl/fromExamples) |423| `musubix watch` | core | ファイル監視・自動再検証 |424425## 禁止事項426427- Phase をスキップしてはならない428- 承認なしで次 Phase に遷移してはならない429- テストなしでコードをコミットしてはならない430- EARS 形式に従わない要件を承認してはならない431- steering/ の参照をスキップしてはならない432- 形式検証をスキップして Phase 4→5 に遷移してはならない433434## 緊急度トリアージ435436| 緊急度 | 対応 |437|--------|------|438| 🔴 Critical | constitution-enforcer 違反 → 即時修正、Phase 進行ブロック |439| 🔴 Critical | formal-verify 矛盾検出 → 要件修正まで Phase 進行ブロック |440| 🟡 Major | テストカバレッジ不足 → test-engineer で補完後に進行 |441| 🟡 Major | セキュリティ脆弱性検出 → security で修正後に進行 |442| 🟢 Minor | ドキュメント不備 → 次回レビューで対応可 |443444## スクリプト445446| スクリプト | 説明 | 使い方 |447|-----------|------|--------|448| `scripts/status.sh` | プロジェクトステータス表示 | `./scripts/status.sh` |449| `scripts/workflow.sh` | ワークフロー管理 | `./scripts/workflow.sh [args]` |450| `scripts/knowledge.sh` | ナレッジグラフ操作 | `./scripts/knowledge.sh [args]` |451| `scripts/research.sh` | ディープリサーチ | `./scripts/research.sh [args]` |452| `scripts/security.sh` | セキュリティスキャン | `./scripts/security.sh [args]` |453| `scripts/skills.sh` | スキル管理 | `./scripts/skills.sh [args]` |454| `scripts/learn.sh` | ライブラリ学習 | `./scripts/learn.sh [args]` |455| `scripts/watch.sh` | ファイルウォッチャー | `./scripts/watch.sh [args]` |456| `scripts/repl.sh` | インタラクティブ REPL | `./scripts/repl.sh` |