musubix 1.1.9 → 1.1.14
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/.github/skills/musubix-adr-generation/SKILL.md +209 -0
- package/.github/skills/musubix-best-practices/SKILL.md +315 -0
- package/.github/skills/musubix-c4-design/SKILL.md +162 -0
- package/.github/skills/musubix-domain-inference/SKILL.md +196 -0
- package/.github/skills/musubix-test-generation/SKILL.md +212 -0
- package/.github/skills/musubix-traceability/SKILL.md +141 -0
- package/AGENTS.md +54 -29
- package/README.ja.md +1 -1
- package/README.md +4 -4
- package/docs/Test-prompt.md +105 -0
- package/docs/evolution-from-musubi-to-musubix.md +213 -19
- package/package.json +4 -5
- package/steering/project.yml +3 -3
- package/steering/tech.ja.md +62 -8
package/README.md
CHANGED
|
@@ -7,11 +7,11 @@
|
|
|
7
7
|
[](https://nodejs.org/)
|
|
8
8
|
[](LICENSE)
|
|
9
9
|
[](https://www.typescriptlang.org/)
|
|
10
|
-
[](https://github.com/nahisaho/MUSUBIX)
|
|
11
11
|
|
|
12
12
|
> Next-generation AI Coding System powered by MUSUBI × YATA Integration
|
|
13
13
|
>
|
|
14
|
-
> **v1.1.
|
|
14
|
+
> **v1.1.10** - New Best Practices from Project-13/14, Enhanced Code Generator
|
|
15
15
|
|
|
16
16
|
**[日本語版 README](README.ja.md)**
|
|
17
17
|
|
|
@@ -207,5 +207,5 @@ See [CHANGELOG.md](CHANGELOG.md)
|
|
|
207
207
|
---
|
|
208
208
|
|
|
209
209
|
**Document ID**: README
|
|
210
|
-
**Version**: 1.0.
|
|
211
|
-
**Last Updated**: 2026-01-
|
|
210
|
+
**Version**: 1.0.21
|
|
211
|
+
**Last Updated**: 2026-01-04
|
|
@@ -0,0 +1,105 @@
|
|
|
1
|
+
あなたは経験豊富なソフトウェアアーキテクトとして、2つの新しい仮想プロジェクトでSDD(仕様駆動開発)ワークフローを完全に実施してください。このタスクは、MUSUBIXシステムの自己学習機能を活用した本格的な開発プロセスの実践です。
|
|
2
|
+
|
|
3
|
+
### プロジェクト概要
|
|
4
|
+
- **プロジェクト数**: 2つの独立した仮想プロジェクト
|
|
5
|
+
- **保存場所**: `virtual-projects/` ディレクトリ配下
|
|
6
|
+
- **目的**: SDDワークフローの完全実施とMUSUBIX改善のためのデータ収集
|
|
7
|
+
|
|
8
|
+
### 実施するSDDワークフロー(各プロジェクトで厳密に実行)
|
|
9
|
+
|
|
10
|
+
#### Phase 1: 要件定義フェーズ
|
|
11
|
+
1. **初期要件作成**
|
|
12
|
+
- ビジネス要件の明確化
|
|
13
|
+
- 機能要件・非機能要件の定義
|
|
14
|
+
- ユースケースの洗い出し
|
|
15
|
+
|
|
16
|
+
2. **要件レビュー**
|
|
17
|
+
- 完全性・一貫性のチェック
|
|
18
|
+
- 曖昧さの特定
|
|
19
|
+
- ステークホルダー視点での検証
|
|
20
|
+
|
|
21
|
+
3. **要件修正**
|
|
22
|
+
- レビューフィードバックの反映
|
|
23
|
+
- 再レビュー(必要に応じて繰り返し)
|
|
24
|
+
- 要件の確定
|
|
25
|
+
|
|
26
|
+
#### Phase 2: 設計フェーズ
|
|
27
|
+
1. **アーキテクチャ設計**
|
|
28
|
+
- システム構成の設計
|
|
29
|
+
- 技術スタックの選定
|
|
30
|
+
- インターフェース設計
|
|
31
|
+
|
|
32
|
+
2. **設計レビュー**
|
|
33
|
+
- 設計の妥当性検証
|
|
34
|
+
- スケーラビリティ・保守性の評価
|
|
35
|
+
- セキュリティ考慮事項の確認
|
|
36
|
+
|
|
37
|
+
3. **設計修正**
|
|
38
|
+
- レビュー指摘事項の改善
|
|
39
|
+
- 再レビュー(必要に応じて繰り返し)
|
|
40
|
+
- 設計の確定
|
|
41
|
+
|
|
42
|
+
#### Phase 3: タスク分解
|
|
43
|
+
- 実装可能な単位へのタスク分割
|
|
44
|
+
- 各タスクの優先順位付け
|
|
45
|
+
- 依存関係の明確化
|
|
46
|
+
- 見積もりの作成
|
|
47
|
+
|
|
48
|
+
#### Phase 4: 実装フェーズ(タスクごとに実施)
|
|
49
|
+
各タスクについて以下を繰り返し:
|
|
50
|
+
1. **コード作成**
|
|
51
|
+
- 設計に基づいた実装
|
|
52
|
+
- コーディング規約の遵守
|
|
53
|
+
|
|
54
|
+
2. **テスト作成・実行**
|
|
55
|
+
- ユニットテストの作成
|
|
56
|
+
- テストの実行と結果確認
|
|
57
|
+
|
|
58
|
+
3. **修正・改善**
|
|
59
|
+
- テスト結果に基づく修正
|
|
60
|
+
- コードレビューと品質改善
|
|
61
|
+
- 再テスト(必要に応じて繰り返し)
|
|
62
|
+
|
|
63
|
+
#### Phase 5: リリース
|
|
64
|
+
- 統合テスト
|
|
65
|
+
- ドキュメント整備
|
|
66
|
+
- リリースノート作成
|
|
67
|
+
- 成果物の最終確認
|
|
68
|
+
|
|
69
|
+
### プロジェクト提案
|
|
70
|
+
|
|
71
|
+
以下のようなプロジェクトを想定していますが、より良いアイデアがあれば提案してください:
|
|
72
|
+
|
|
73
|
+
**プロジェクト候補A**: タスク管理API
|
|
74
|
+
- RESTful API設計
|
|
75
|
+
- CRUD操作の実装
|
|
76
|
+
- 認証・認可機能
|
|
77
|
+
|
|
78
|
+
**プロジェクト候補B**: データ分析ダッシュボード
|
|
79
|
+
- データ可視化コンポーネント
|
|
80
|
+
- リアルタイム更新機能
|
|
81
|
+
- フィルタリング・ソート機能
|
|
82
|
+
|
|
83
|
+
### 自己学習機能の活用
|
|
84
|
+
各フェーズで以下を記録・分析:
|
|
85
|
+
- レビューで発見された問題パターン
|
|
86
|
+
- 修正が必要となった理由
|
|
87
|
+
- 効果的だった設計判断
|
|
88
|
+
- 改善すべきプロセス
|
|
89
|
+
|
|
90
|
+
この情報をMUSUBIXの改善に活用してください。
|
|
91
|
+
|
|
92
|
+
### 成果物の要件
|
|
93
|
+
- 各フェーズの完全なドキュメント
|
|
94
|
+
- 実装コードとテストコード
|
|
95
|
+
- レビュー記録と修正履歴
|
|
96
|
+
- プロセス改善提案
|
|
97
|
+
|
|
98
|
+
### 実行方法
|
|
99
|
+
1. まず2つのプロジェクトのテーマを提案または確認
|
|
100
|
+
2. プロジェクト1のPhase 1から順次実施
|
|
101
|
+
3. 各フェーズ完了時に進捗を報告
|
|
102
|
+
4. プロジェクト1完了後、プロジェクト2へ
|
|
103
|
+
5. 最後に学習成果とMUSUBIX改善提案をまとめ
|
|
104
|
+
|
|
105
|
+
**準備ができたら、プロジェクトのテーマ提案から開始してください。**
|
|
@@ -7,7 +7,7 @@ tags:
|
|
|
7
7
|
- LLM
|
|
8
8
|
- ニューロシンボリック
|
|
9
9
|
private: false
|
|
10
|
-
updated_at: '2026-01-
|
|
10
|
+
updated_at: '2026-01-05'
|
|
11
11
|
id: null
|
|
12
12
|
organization_url_name: null
|
|
13
13
|
slide: false
|
|
@@ -21,13 +21,13 @@ AIコーディング支援ツールは急速に進化しています。本記事
|
|
|
21
21
|
|
|
22
22
|
# TL;DR
|
|
23
23
|
|
|
24
|
-
> **最新バージョン**: v1.1.
|
|
24
|
+
> **最新バージョン**: v1.1.10 | **62ドメイン対応** | **224コンポーネント** | **459テスト** | **17ベストプラクティス**
|
|
25
25
|
|
|
26
26
|
| 項目 | MUSUBI | MUSUBIX |
|
|
27
|
-
|
|
27
|
+
|------|--------|---------|
|
|
28
28
|
| **コンセプト** | 仕様駆動開発(SDD) | ニューロシンボリックAI |
|
|
29
29
|
| **推論方式** | ニューラル(LLM)のみ | ニューラル + シンボリック |
|
|
30
|
-
| **知識基盤** | プロジェクトメモリ | 知識グラフ(YATA) |
|
|
30
|
+
| **知識基盤** | プロジェクトメモリ | プロジェクトメモリ + 知識グラフ(YATA) |
|
|
31
31
|
| **信頼性** | LLMの確率的出力 | 形式的検証による確実性 |
|
|
32
32
|
| **統合対象** | 7つのAIエージェント | MUSUBI + YATA + 7エージェント |
|
|
33
33
|
| **ドメイン** | 汎用 | 62専門ドメイン対応 |
|
|
@@ -37,12 +37,67 @@ AIコーディング支援ツールは急速に進化しています。本記事
|
|
|
37
37
|
|
|
38
38
|
## 1.1 概要
|
|
39
39
|
|
|
40
|
-
**MUSUBI**(結び)は、AI
|
|
40
|
+
**MUSUBI**(結び)は、AIコーディングエージェントのための**仕様駆動開発(SDD: Specification-Driven Development)フレームワーク**です。
|
|
41
|
+
|
|
42
|
+
従来のAIコーディング支援は「コードを書く」ことに焦点を当てていましたが、MUSUBIは**要件定義から設計、実装、テストまでの開発ライフサイクル全体**をAIと協調して進めることを目指しています。
|
|
41
43
|
|
|
42
44
|
```
|
|
43
45
|
🤖 7つのAIエージェント × 📋 31の専門スキル × ⚖️ 憲法ガバナンス
|
|
44
46
|
```
|
|
45
47
|
|
|
48
|
+
### MUSUBIの核心思想
|
|
49
|
+
|
|
50
|
+
1. **Specification First(仕様優先)**: コードを書く前に、まず要件と設計を明確にする
|
|
51
|
+
2. **Constitutional AI Governance(憲法ガバナンス)**: 9つの不変条項でAIの振る舞いを統治
|
|
52
|
+
3. **Project Memory(プロジェクトメモリ)**: steering/フォルダに決定事項を永続化し、AIが常に参照
|
|
53
|
+
4. **Full Traceability(完全追跡可能性)**: 要件→設計→コード→テストの双方向トレース
|
|
54
|
+
|
|
55
|
+
### 対応AIエージェント
|
|
56
|
+
|
|
57
|
+
MUSUBIは以下の7つの主要AIコーディングエージェントで動作します:
|
|
58
|
+
|
|
59
|
+
| エージェント | 特徴 |
|
|
60
|
+
|-------------|------|
|
|
61
|
+
| **Claude Code** | Anthropic製、高い推論能力、Agent Skills対応 |
|
|
62
|
+
| **GitHub Copilot** | VS Code統合、広範な言語サポート |
|
|
63
|
+
| **Cursor IDE** | AI-first IDE、インライン編集 |
|
|
64
|
+
| **Gemini CLI** | Google製、マルチモーダル対応 |
|
|
65
|
+
| **Codex CLI** | OpenAI製、GPT-4ベース |
|
|
66
|
+
| **Qwen Code** | Alibaba製、オープンソース |
|
|
67
|
+
| **Windsurf** | Codeium製、高速補完 |
|
|
68
|
+
|
|
69
|
+
### Claude Code Agent Skills
|
|
70
|
+
|
|
71
|
+
MUSUBIXは**Claude Code Agent Skills**に対応しています。`.github/skills/`フォルダにSKILL.mdファイルを配置することで、Claude Codeが専門的なワークフローを自動的に認識・実行できます。
|
|
72
|
+
|
|
73
|
+
現在、**9つのスキル**が利用可能です:
|
|
74
|
+
|
|
75
|
+
| スキル名 | 説明 |
|
|
76
|
+
|---------|------|
|
|
77
|
+
| `musubix-sdd-workflow` | SDD開発ワークフロー全体のガイド |
|
|
78
|
+
| `musubix-ears-validation` | EARS形式の要件検証 |
|
|
79
|
+
| `musubix-code-generation` | 設計からのコード生成 |
|
|
80
|
+
| `musubix-c4-design` | C4モデル(Context/Container/Component/Code)設計 |
|
|
81
|
+
| `musubix-traceability` | 要件↔設計↔タスク↔コード↔テストの追跡 |
|
|
82
|
+
| `musubix-test-generation` | TDDパターンに基づくテスト生成 |
|
|
83
|
+
| `musubix-adr-generation` | Architecture Decision Records作成 |
|
|
84
|
+
| `musubix-best-practices` | 17種のベストプラクティス適用 |
|
|
85
|
+
| `musubix-domain-inference` | 62ドメイン検出・コンポーネント推論 |
|
|
86
|
+
|
|
87
|
+
スキルファイルの配置:
|
|
88
|
+
```
|
|
89
|
+
.github/skills/
|
|
90
|
+
├── musubix-sdd-workflow/SKILL.md # コアワークフロー
|
|
91
|
+
├── musubix-ears-validation/SKILL.md # 要件検証
|
|
92
|
+
├── musubix-code-generation/SKILL.md # コード生成
|
|
93
|
+
├── musubix-c4-design/SKILL.md # C4設計
|
|
94
|
+
├── musubix-traceability/SKILL.md # トレーサビリティ
|
|
95
|
+
├── musubix-test-generation/SKILL.md # テスト生成
|
|
96
|
+
├── musubix-adr-generation/SKILL.md # ADR生成
|
|
97
|
+
├── musubix-best-practices/SKILL.md # ベストプラクティス
|
|
98
|
+
└── musubix-domain-inference/SKILL.md # ドメイン推論
|
|
99
|
+
```
|
|
100
|
+
|
|
46
101
|
## 1.2 主な特徴
|
|
47
102
|
|
|
48
103
|
```mermaid
|
|
@@ -74,6 +129,7 @@ flowchart LR
|
|
|
74
129
|
| **ADR生成** | アーキテクチャ決定記録の自動作成 |
|
|
75
130
|
| **憲法ガバナンス** | 9つの不変条項による品質保証 |
|
|
76
131
|
| **トレーサビリティ** | 要件→設計→コード→テストの完全追跡 |
|
|
132
|
+
| **プロジェクトメモリ** | steering/フォルダによる決定・方針の永続化 |
|
|
77
133
|
|
|
78
134
|
## 1.3 MUSUBIの課題
|
|
79
135
|
|
|
@@ -279,8 +335,8 @@ flowchart TB
|
|
|
279
335
|
flowchart TB
|
|
280
336
|
subgraph MUSUBIX["MUSUBIX System v1.0.20"]
|
|
281
337
|
subgraph Packages["パッケージ構成"]
|
|
282
|
-
Core["@nahisaho/musubix-core<br/>
|
|
283
|
-
MCP["@nahisaho/musubix-mcp-server<br/>9ツール,
|
|
338
|
+
Core["@nahisaho/musubix-core<br/>77モジュール | 62ドメイン | 224コンポーネント"]
|
|
339
|
+
MCP["@nahisaho/musubix-mcp-server<br/>9ツール, 6プロンプト"]
|
|
284
340
|
YATA_Client["@nahisaho/musubix-yata-client"]
|
|
285
341
|
end
|
|
286
342
|
|
|
@@ -441,13 +497,13 @@ flowchart LR
|
|
|
441
497
|
| **技術オントロジー** | 設計パターン、フレームワーク | 設計の自動提案 |
|
|
442
498
|
| **SDDオントロジー** | EARS、C4、ADRの形式知識 | 成果物の検証 |
|
|
443
499
|
|
|
444
|
-
### 4.2.4
|
|
500
|
+
### 4.2.4 62ドメイン対応(v1.1.10)
|
|
445
501
|
|
|
446
|
-
MUSUBIXは**
|
|
502
|
+
MUSUBIXは**62の専門ドメイン**に対応し、各ドメインに最適化されたコンポーネント推論を提供します。
|
|
447
503
|
|
|
448
504
|
```mermaid
|
|
449
505
|
flowchart TB
|
|
450
|
-
subgraph Domains["
|
|
506
|
+
subgraph Domains["62ドメイン対応"]
|
|
451
507
|
subgraph Business["ビジネス系"]
|
|
452
508
|
B1[ecommerce]
|
|
453
509
|
B2[finance]
|
|
@@ -481,7 +537,7 @@ flowchart TB
|
|
|
481
537
|
end
|
|
482
538
|
end
|
|
483
539
|
|
|
484
|
-
Domains --> Components["
|
|
540
|
+
Domains --> Components["224コンポーネント定義"]
|
|
485
541
|
```
|
|
486
542
|
|
|
487
543
|
| カテゴリ | ドメイン例 | コンポーネント例 |
|
|
@@ -492,7 +548,7 @@ flowchart TB
|
|
|
492
548
|
| **サービス** | restaurant, hotel, travel | ReservationService, MenuManager, BookingEngine |
|
|
493
549
|
| **技術** | iot, security, ai | DeviceManager, ThreatDetector, ModelInference |
|
|
494
550
|
|
|
495
|
-
**対応ドメイン一覧**(
|
|
551
|
+
**対応ドメイン一覧**(62ドメイン):
|
|
496
552
|
|
|
497
553
|
<details>
|
|
498
554
|
<summary>クリックして全ドメインを表示</summary>
|
|
@@ -559,6 +615,8 @@ flowchart TB
|
|
|
559
615
|
| 58 | aviation | 航空 |
|
|
560
616
|
| 59 | shipping | 海運 |
|
|
561
617
|
| 60 | telecom | 通信 |
|
|
618
|
+
| 61 | security | セキュリティ |
|
|
619
|
+
| 62 | ai | AI |
|
|
562
620
|
|
|
563
621
|
</details>
|
|
564
622
|
|
|
@@ -604,8 +662,8 @@ MUSUBIXは以下の新規モジュールを追加:
|
|
|
604
662
|
| | SOLIDValidator | SOLID検証 |
|
|
605
663
|
| | C4ModelGenerator | C4モデル生成 |
|
|
606
664
|
| | ADRGenerator | ADR生成 |
|
|
607
|
-
| | DomainDetector | ドメイン自動検出(
|
|
608
|
-
| | ComponentInference | コンポーネント推論(~
|
|
665
|
+
| | DomainDetector | ドメイン自動検出(62ドメイン) |
|
|
666
|
+
| | ComponentInference | コンポーネント推論(~430定義) |
|
|
609
667
|
| **コード** | StaticAnalyzer | 静的解析 |
|
|
610
668
|
| | SecurityScanner | セキュリティスキャン |
|
|
611
669
|
| | QualityMetricsCalculator | 品質メトリクス |
|
|
@@ -660,7 +718,7 @@ approvalWorkflow.transition('pending', 'approve'); // 'approved'
|
|
|
660
718
|
reservationWorkflow.transition('tentative', 'confirm'); // 'confirmed'
|
|
661
719
|
```
|
|
662
720
|
|
|
663
|
-
## 4.4 MCPサーバー(9ツール、
|
|
721
|
+
## 4.4 MCPサーバー(9ツール、6プロンプト)
|
|
664
722
|
|
|
665
723
|
```mermaid
|
|
666
724
|
flowchart TB
|
|
@@ -673,10 +731,13 @@ flowchart TB
|
|
|
673
731
|
T5[説明系ツール]
|
|
674
732
|
end
|
|
675
733
|
|
|
676
|
-
subgraph Prompts["
|
|
734
|
+
subgraph Prompts["6 Prompts"]
|
|
677
735
|
P1[sdd_requirements_analysis]
|
|
678
736
|
P2[sdd_requirements_review]
|
|
679
737
|
P3[sdd_design_generation]
|
|
738
|
+
P4[sdd_design_review]
|
|
739
|
+
P5[sdd_task_decomposition]
|
|
740
|
+
P6[sdd_project_steering]
|
|
680
741
|
end
|
|
681
742
|
end
|
|
682
743
|
|
|
@@ -916,7 +977,94 @@ npx musubix-mcp
|
|
|
916
977
|
| @nahisaho/musubix-mcp-server | `npm install @nahisaho/musubix-mcp-server` | MCPサーバー |
|
|
917
978
|
| @nahisaho/musubix-yata-client | `npm install @nahisaho/musubix-yata-client` | YATAクライアント |
|
|
918
979
|
|
|
919
|
-
## 8.3
|
|
980
|
+
## 8.3 利用方法の選択
|
|
981
|
+
|
|
982
|
+
MUSUBIXには**2つの利用方法**があります。用途に応じて選択してください。
|
|
983
|
+
|
|
984
|
+
```mermaid
|
|
985
|
+
flowchart TB
|
|
986
|
+
subgraph Install["インストール"]
|
|
987
|
+
I1[npm install musubix]
|
|
988
|
+
end
|
|
989
|
+
|
|
990
|
+
Install --> Choice{利用方法の選択}
|
|
991
|
+
|
|
992
|
+
Choice -->|方法1| Direct["📁 直接利用<br/>AGENTS.md + プロンプト"]
|
|
993
|
+
Choice -->|方法2| MCP["🔌 MCP経由<br/>MCPサーバー連携"]
|
|
994
|
+
|
|
995
|
+
Direct --> D1[GitHub Copilot]
|
|
996
|
+
Direct --> D2[Claude Code]
|
|
997
|
+
Direct --> D3[Cursor IDE]
|
|
998
|
+
|
|
999
|
+
MCP --> M1[Claude Desktop]
|
|
1000
|
+
MCP --> M2[VS Code + MCP拡張]
|
|
1001
|
+
MCP --> M3[その他MCPクライアント]
|
|
1002
|
+
```
|
|
1003
|
+
|
|
1004
|
+
| 方法 | 特徴 | 推奨ユースケース |
|
|
1005
|
+
|------|------|------------------|
|
|
1006
|
+
| **方法1: 直接利用** | 設定不要、即座に利用可能 | 日常のコーディング、要件定義、設計 |
|
|
1007
|
+
| **方法2: MCP経由** | 高度なツール連携、知識グラフ統合 | 大規模プロジェクト、チーム開発 |
|
|
1008
|
+
|
|
1009
|
+
## 8.4 方法1: 直接利用(GitHub Copilot等)
|
|
1010
|
+
|
|
1011
|
+
musubixパッケージをインストールすると、**AGENTS.md**と**プロンプトファイル**が `node_modules/musubix/` に配置されます。GitHub Copilotなどのエディタ統合AIは、これらのファイルを自動的に認識し、MUSUBIXの機能を利用できます。
|
|
1012
|
+
|
|
1013
|
+
### セットアップ手順
|
|
1014
|
+
|
|
1015
|
+
```bash
|
|
1016
|
+
# 1. musubixをインストール
|
|
1017
|
+
npm install musubix
|
|
1018
|
+
|
|
1019
|
+
# 2. AGENTS.mdをプロジェクトルートにコピー(推奨)
|
|
1020
|
+
cp node_modules/musubix/AGENTS.md ./AGENTS.md
|
|
1021
|
+
|
|
1022
|
+
# 3. プロンプトファイルをコピー(オプション)
|
|
1023
|
+
cp -r node_modules/musubix/.github/prompts ./.github/prompts
|
|
1024
|
+
```
|
|
1025
|
+
|
|
1026
|
+
### 自動認識されるファイル
|
|
1027
|
+
|
|
1028
|
+
| ファイル | 場所 | 説明 |
|
|
1029
|
+
|---------|------|------|
|
|
1030
|
+
| **AGENTS.md** | プロジェクトルート | AIエージェント向けの包括的なガイド |
|
|
1031
|
+
| **プロンプトファイル** | `.github/prompts/` | SDD各フェーズ専用のプロンプト |
|
|
1032
|
+
|
|
1033
|
+
### 提供されるプロンプトファイル
|
|
1034
|
+
|
|
1035
|
+
```
|
|
1036
|
+
.github/prompts/
|
|
1037
|
+
├── sdd-requirements.prompt.md # 要件定義フェーズ
|
|
1038
|
+
├── sdd-design.prompt.md # 設計フェーズ
|
|
1039
|
+
├── sdd-implement.prompt.md # 実装フェーズ
|
|
1040
|
+
├── sdd-tasks.prompt.md # タスク分解
|
|
1041
|
+
├── sdd-validate.prompt.md # 検証フェーズ
|
|
1042
|
+
├── sdd-steering.prompt.md # プロジェクト方針
|
|
1043
|
+
├── sdd-change-init.prompt.md # 変更開始
|
|
1044
|
+
├── sdd-change-apply.prompt.md # 変更適用
|
|
1045
|
+
└── sdd-change-archive.prompt.md # 変更アーカイブ
|
|
1046
|
+
```
|
|
1047
|
+
|
|
1048
|
+
### 使い方(GitHub Copilot / Cursor / Claude Code)
|
|
1049
|
+
|
|
1050
|
+
```markdown
|
|
1051
|
+
# プロンプトファイルを使用
|
|
1052
|
+
@workspace /sdd-requirements 予約管理システムの要件を定義してください
|
|
1053
|
+
|
|
1054
|
+
# または AGENTS.md のガイドに従って質問
|
|
1055
|
+
MUSUBIXのEARS形式で要件を書いてください
|
|
1056
|
+
```
|
|
1057
|
+
|
|
1058
|
+
### メリット
|
|
1059
|
+
|
|
1060
|
+
- ✅ **設定不要**: インストール後すぐに利用可能
|
|
1061
|
+
- ✅ **軽量**: MCPサーバーの起動不要
|
|
1062
|
+
- ✅ **汎用性**: 主要なAIエディタで動作
|
|
1063
|
+
- ✅ **オフライン対応**: ネットワーク不要
|
|
1064
|
+
|
|
1065
|
+
## 8.5 方法2: MCP経由(MCPサーバー連携)
|
|
1066
|
+
|
|
1067
|
+
MCP(Model Context Protocol)を使用すると、**9つの専用ツール**と**3つのプロンプト**を利用でき、より高度な機能(知識グラフクエリ、トレーサビリティ検証等)が使えます。
|
|
920
1068
|
|
|
921
1069
|
### Claude Code(CLI)
|
|
922
1070
|
|
|
@@ -956,6 +1104,52 @@ claude mcp list
|
|
|
956
1104
|
}
|
|
957
1105
|
```
|
|
958
1106
|
|
|
1107
|
+
### 利用可能なMCPツール(9ツール)
|
|
1108
|
+
|
|
1109
|
+
| ツール名 | 説明 |
|
|
1110
|
+
|---------|------|
|
|
1111
|
+
| `sdd_create_requirements` | EARS形式の要件ドキュメント作成 |
|
|
1112
|
+
| `sdd_validate_requirements` | 要件のEARS検証・憲法準拠チェック |
|
|
1113
|
+
| `sdd_create_design` | C4モデル設計ドキュメント作成 |
|
|
1114
|
+
| `sdd_validate_design` | 設計の要件トレーサビリティ検証 |
|
|
1115
|
+
| `sdd_create_tasks` | 設計から実装タスク生成 |
|
|
1116
|
+
| `sdd_query_knowledge` | YATA知識グラフへのクエリ |
|
|
1117
|
+
| `sdd_update_knowledge` | 知識グラフの更新 |
|
|
1118
|
+
| `sdd_validate_constitution` | 9憲法条項への準拠検証 |
|
|
1119
|
+
| `sdd_validate_traceability` | 要件↔設計↔タスクのトレーサビリティ検証 |
|
|
1120
|
+
|
|
1121
|
+
### メリット
|
|
1122
|
+
|
|
1123
|
+
- ✅ **高度な機能**: 知識グラフ連携、矛盾検出
|
|
1124
|
+
- ✅ **ツール統合**: AIが直接ツールを呼び出し可能
|
|
1125
|
+
- ✅ **リアルタイム検証**: 作成中のドキュメントを即座に検証
|
|
1126
|
+
- ✅ **トレーサビリティ**: 要件から実装までの完全追跡
|
|
1127
|
+
|
|
1128
|
+
## 8.6 どちらを選ぶべきか?
|
|
1129
|
+
|
|
1130
|
+
```mermaid
|
|
1131
|
+
flowchart TD
|
|
1132
|
+
Start[MUSUBIXを使いたい] --> Q1{MCPを使う<br/>環境がある?}
|
|
1133
|
+
|
|
1134
|
+
Q1 -->|はい| Q2{高度な機能が<br/>必要?}
|
|
1135
|
+
Q1 -->|いいえ| Direct[方法1: 直接利用]
|
|
1136
|
+
|
|
1137
|
+
Q2 -->|はい| MCP[方法2: MCP経由]
|
|
1138
|
+
Q2 -->|いいえ| Both[両方併用]
|
|
1139
|
+
|
|
1140
|
+
Direct --> Use1[AGENTS.md + プロンプト<br/>で日常開発]
|
|
1141
|
+
MCP --> Use2[MCPツールで<br/>高度な検証・分析]
|
|
1142
|
+
Both --> Use3[普段は直接利用<br/>必要時にMCP]
|
|
1143
|
+
```
|
|
1144
|
+
|
|
1145
|
+
| シナリオ | 推奨方法 |
|
|
1146
|
+
|---------|---------|
|
|
1147
|
+
| 個人開発、小規模プロジェクト | 方法1(直接利用) |
|
|
1148
|
+
| チーム開発、大規模プロジェクト | 方法2(MCP経由) |
|
|
1149
|
+
| 要件定義・設計のみ利用 | 方法1(直接利用) |
|
|
1150
|
+
| 知識グラフ連携が必要 | 方法2(MCP経由) |
|
|
1151
|
+
| 両方の利点を活かしたい | 両方併用 |
|
|
1152
|
+
|
|
959
1153
|
詳細は [インストールガイド](https://github.com/nahisaho/MUSUBIX/blob/main/docs/INSTALL-GUIDE.ja.md) を参照してください。
|
|
960
1154
|
|
|
961
1155
|
# 参考リンク
|
|
@@ -969,5 +1163,5 @@ claude mcp list
|
|
|
969
1163
|
|
|
970
1164
|
**著者**: nahisaho
|
|
971
1165
|
**公開日**: 2026-01-02
|
|
972
|
-
**更新日**: 2026-01-
|
|
973
|
-
**バージョン**: v1.1.
|
|
1166
|
+
**更新日**: 2026-01-05
|
|
1167
|
+
**バージョン**: v1.1.10
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "musubix",
|
|
3
|
-
"version": "1.1.
|
|
3
|
+
"version": "1.1.14",
|
|
4
4
|
"description": "Neuro-Symbolic AI Coding System - MUSUBI × YATA Integration",
|
|
5
5
|
"type": "module",
|
|
6
6
|
"workspaces": [
|
|
@@ -62,9 +62,8 @@
|
|
|
62
62
|
},
|
|
63
63
|
"dependencies": {
|
|
64
64
|
"@modelcontextprotocol/sdk": "1.25.1",
|
|
65
|
-
"@nahisaho/musubix-core": "^1.1.
|
|
66
|
-
"@nahisaho/musubix-mcp-server": "^1.1.
|
|
67
|
-
"@nahisaho/musubix-yata-client": "^1.1.
|
|
68
|
-
"musubix": "^1.1.3"
|
|
65
|
+
"@nahisaho/musubix-core": "^1.1.14",
|
|
66
|
+
"@nahisaho/musubix-mcp-server": "^1.1.14",
|
|
67
|
+
"@nahisaho/musubix-yata-client": "^1.1.14"
|
|
69
68
|
}
|
|
70
69
|
}
|
package/steering/project.yml
CHANGED
|
@@ -2,7 +2,7 @@
|
|
|
2
2
|
name: MUSUBIX
|
|
3
3
|
description: Neuro-Symbolic AI Integration System - Neural (LLM) + Symbolic (YATA Knowledge Graph)
|
|
4
4
|
locale: ja
|
|
5
|
-
version: "1.
|
|
5
|
+
version: "1.1.10"
|
|
6
6
|
created: 2026-01-01
|
|
7
7
|
updated: 2026-01-04
|
|
8
8
|
|
|
@@ -30,8 +30,8 @@ packages:
|
|
|
30
30
|
|
|
31
31
|
# Domain Support
|
|
32
32
|
domains:
|
|
33
|
-
count:
|
|
34
|
-
components: ~
|
|
33
|
+
count: 62
|
|
34
|
+
components: ~430
|
|
35
35
|
categories:
|
|
36
36
|
- general (13 components)
|
|
37
37
|
- manufacturing, logistics, education (8 each)
|
package/steering/tech.ja.md
CHANGED
|
@@ -1,8 +1,8 @@
|
|
|
1
1
|
# Technology Stack
|
|
2
2
|
|
|
3
3
|
**Project**: MUSUBIX
|
|
4
|
-
**Last Updated**: 2026-01-
|
|
5
|
-
**Version**: 1.
|
|
4
|
+
**Last Updated**: 2026-01-04
|
|
5
|
+
**Version**: 1.1.10
|
|
6
6
|
**Status**: Production Ready
|
|
7
7
|
|
|
8
8
|
---
|
|
@@ -28,9 +28,9 @@ MUSUBIXはニューロシンボリックAIコーディングシステムであ
|
|
|
28
28
|
|
|
29
29
|
```
|
|
30
30
|
packages/
|
|
31
|
-
├── core/ # @nahisaho/musubix-core (v1.
|
|
32
|
-
├── mcp-server/ # @nahisaho/musubix-mcp-server (v1.
|
|
33
|
-
└── yata-client/ # @nahisaho/musubix-yata-client (v1.
|
|
31
|
+
├── core/ # @nahisaho/musubix-core (v1.1.9)
|
|
32
|
+
├── mcp-server/ # @nahisaho/musubix-mcp-server (v1.1.9)
|
|
33
|
+
└── yata-client/ # @nahisaho/musubix-yata-client (v1.1.9)
|
|
34
34
|
```
|
|
35
35
|
|
|
36
36
|
### Core Package モジュール
|
|
@@ -71,7 +71,7 @@ packages/
|
|
|
71
71
|
|
|
72
72
|
### 1. EARS検証器(Symbolic Reasoning)
|
|
73
73
|
|
|
74
|
-
5つのEARS
|
|
74
|
+
5つのEARSパターンをサポート(**Markdownブロッククォート形式対応** v1.1.9+):
|
|
75
75
|
|
|
76
76
|
| パターン | 構文 | 信頼度ボーナス |
|
|
77
77
|
|---------|------|---------------|
|
|
@@ -146,8 +146,62 @@ npm run clean
|
|
|
146
146
|
| パターンマッチング | <5ms | 信頼度計算含む |
|
|
147
147
|
| トレーサビリティリンク検索 | O(1) | インデックス利用 |
|
|
148
148
|
| C4モデル生成 | <10ms | 11要素、6関係 |
|
|
149
|
-
| 全テスト(
|
|
149
|
+
| 全テスト(459件) | ~1.0s | Vitest実行 |
|
|
150
|
+
|
|
151
|
+
## Self-Learning System (v1.1.10)
|
|
152
|
+
|
|
153
|
+
### ベストプラクティスCLI
|
|
154
|
+
|
|
155
|
+
```bash
|
|
156
|
+
# 一覧表示
|
|
157
|
+
npx musubix learn bp-list
|
|
158
|
+
|
|
159
|
+
# 詳細表示(コード例付き)
|
|
160
|
+
npx musubix learn bp-show BP-CODE-001
|
|
161
|
+
|
|
162
|
+
# カテゴリ別フィルタ
|
|
163
|
+
npx musubix learn best-practices --category code
|
|
164
|
+
```
|
|
165
|
+
|
|
166
|
+
### 学習済みパターン(17件)
|
|
167
|
+
|
|
168
|
+
| ID | 名称 | 信頼度 | ソース |
|
|
169
|
+
|----|------|--------|--------|
|
|
170
|
+
| BP-CODE-001 | Entity Input DTO | 95% | P07-08 |
|
|
171
|
+
| BP-CODE-002 | Date-based ID Format | 90% | P07-08 |
|
|
172
|
+
| BP-CODE-003 | Value Objects | 90% | P08 |
|
|
173
|
+
| BP-CODE-004 | Function-based Value Objects | 95% | P13-14 |
|
|
174
|
+
| BP-CODE-005 | Result Type | 95% | P13-14 |
|
|
175
|
+
| BP-DESIGN-001 | Status Transition Map | 95% | P08, P13-14 |
|
|
176
|
+
| BP-DESIGN-002 | Repository Async Pattern | 85% | P08 |
|
|
177
|
+
| BP-DESIGN-003 | Service Layer with DI | 90% | P07-08 |
|
|
178
|
+
| BP-DESIGN-004 | Optimistic Locking | 90% | P10 |
|
|
179
|
+
| BP-DESIGN-005 | AuditService | 85% | P09-10 |
|
|
180
|
+
| BP-DESIGN-006 | Entity Counter Reset | 95% | P13-14 |
|
|
181
|
+
| BP-DESIGN-007 | Expiry Time Logic | 90% | P14 |
|
|
182
|
+
| BP-TEST-001 | Test Counter Reset | 95% | P07 |
|
|
183
|
+
| BP-TEST-002 | Verify API Before Test | 80% | P08 |
|
|
184
|
+
| BP-TEST-003 | Vitest ESM Configuration | 85% | P07 |
|
|
185
|
+
| BP-TEST-004 | Result Type Test Pattern | 95% | P13-14 |
|
|
186
|
+
| BP-TEST-005 | Status Transition Testing | 90% | P14 |
|
|
187
|
+
|
|
188
|
+
### コード生成テンプレート(12タイプ)
|
|
189
|
+
|
|
190
|
+
| タイプ | 説明 | 追加バージョン |
|
|
191
|
+
|--------|------|----------------|
|
|
192
|
+
| class | クラス定義 | v1.0.0 |
|
|
193
|
+
| interface | インターフェース | v1.0.0 |
|
|
194
|
+
| function | 関数 | v1.0.0 |
|
|
195
|
+
| module | モジュール | v1.0.0 |
|
|
196
|
+
| test | テストファイル | v1.0.0 |
|
|
197
|
+
| api-endpoint | APIエンドポイント | v1.0.0 |
|
|
198
|
+
| model | データモデル | v1.0.0 |
|
|
199
|
+
| repository | リポジトリ | v1.0.0 |
|
|
200
|
+
| service | サービス層 | v1.0.0 |
|
|
201
|
+
| controller | コントローラ | v1.0.0 |
|
|
202
|
+
| value-object | Value Object (function-based) | v1.1.10 |
|
|
203
|
+
| entity | エンティティ (status transition, counter reset) | v1.1.10 |
|
|
150
204
|
|
|
151
205
|
---
|
|
152
206
|
|
|
153
|
-
*Last Updated: 2026-01-
|
|
207
|
+
*Last Updated: 2026-01-04 by MUSUBIX v1.1.10*
|