musubi-sdd 0.1.2 → 0.1.3
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/README.ja.md +108 -27
- package/README.md +108 -27
- package/bin/musubi-init.js +35 -0
- package/package.json +2 -2
- package/src/agents/registry.js +28 -19
- package/src/templates/agents/claude-code/commands/sdd-change-apply.md +734 -0
- package/src/templates/agents/claude-code/commands/sdd-change-archive.md +628 -0
- package/src/templates/agents/claude-code/commands/sdd-change-init.md +580 -0
- package/src/templates/agents/codex/commands/sdd-change-apply.md +734 -0
- package/src/templates/agents/codex/commands/sdd-change-archive.md +628 -0
- package/src/templates/agents/codex/commands/sdd-change-init.md +580 -0
- package/src/templates/agents/cursor/commands/sdd-change-apply.md +734 -0
- package/src/templates/agents/cursor/commands/sdd-change-archive.md +628 -0
- package/src/templates/agents/cursor/commands/sdd-change-init.md +580 -0
- package/src/templates/agents/gemini-cli/commands/sdd-change-apply.toml +220 -0
- package/src/templates/agents/gemini-cli/commands/sdd-change-archive.toml +191 -0
- package/src/templates/agents/gemini-cli/commands/sdd-change-init.toml +297 -0
- package/src/templates/agents/github-copilot/commands/sdd-change-apply.md +734 -0
- package/src/templates/agents/github-copilot/commands/sdd-change-archive.md +628 -0
- package/src/templates/agents/github-copilot/commands/sdd-change-init.md +580 -0
- package/src/templates/agents/qwen-code/commands/sdd-change-apply.md +734 -0
- package/src/templates/agents/qwen-code/commands/sdd-change-archive.md +628 -0
- package/src/templates/agents/qwen-code/commands/sdd-change-init.md +580 -0
- package/src/templates/agents/shared/AGENTS.md +579 -0
- package/src/templates/agents/windsurf/commands/sdd-change-apply.md +734 -0
- package/src/templates/agents/windsurf/commands/sdd-change-archive.md +628 -0
- package/src/templates/agents/windsurf/commands/sdd-change-init.md +580 -0
package/README.ja.md
CHANGED
|
@@ -7,8 +7,11 @@ MUSUBIは、6つの主要フレームワークのベスト機能を統合した
|
|
|
7
7
|
## 特徴
|
|
8
8
|
|
|
9
9
|
- 🤖 **マルチエージェント対応** - 7つのAIコーディングエージェントに対応(Claude Code、GitHub Copilot、Cursor、Gemini CLI、Codex CLI、Qwen Code、Windsurf)
|
|
10
|
-
- 📄 **柔軟なコマンド形式** - Markdown
|
|
11
|
-
- 🎯 **25
|
|
10
|
+
- 📄 **柔軟なコマンド形式** - Markdown、TOML、AGENTS.md形式に対応
|
|
11
|
+
- 🎯 **25の専門エージェント(全プラットフォーム対応)** - オーケストレーター、ステアリング、要件、アーキテクチャ、開発、品質、セキュリティ、インフラ
|
|
12
|
+
- Claude Code: Skills API(25スキル)
|
|
13
|
+
- GitHub Copilot & Cursor: AGENTS.md(公式サポート)
|
|
14
|
+
- その他4エージェント: AGENTS.md(互換形式)
|
|
12
15
|
- 📋 **憲法ガバナンス** - 9つの不変条項 + フェーズ-1ゲートによる品質保証
|
|
13
16
|
- 📝 **EARS要件形式** - 完全なトレーサビリティを持つ明確な要件
|
|
14
17
|
- 🔄 **差分仕様** - ブラウンフィールドおよびグリーンフィールドプロジェクト対応
|
|
@@ -20,20 +23,22 @@ MUSUBIは、6つの主要フレームワークのベスト機能を統合した
|
|
|
20
23
|
|
|
21
24
|
MUSUBIは7つのAIコーディングエージェントに対応し、それぞれに最適化された設定を提供します。
|
|
22
25
|
|
|
23
|
-
| エージェント | スキルAPI | コマンド形式 | コマンドファイル形式 | インストールディレクトリ |
|
|
24
|
-
|
|
25
|
-
| **Claude Code** | ✅ (25スキル) | `/sdd-*` | Markdown | `.claude/skills/`, `.claude/commands/` |
|
|
26
|
-
| **GitHub Copilot** | ❌ | `#sdd-*` | Markdown | `.github/prompts
|
|
27
|
-
| **Cursor IDE** | ❌ | `/sdd-*` | Markdown | `.cursor/commands
|
|
28
|
-
| **Gemini CLI** | ❌ | `/sdd-*` |
|
|
29
|
-
| **Codex CLI** | ❌ | `/prompts:sdd-*` | Markdown | `.codex/prompts
|
|
30
|
-
| **Qwen Code** | ❌ | `/sdd-*` | Markdown | `.qwen/commands
|
|
31
|
-
| **Windsurf IDE** | ❌ | `/sdd-*` | Markdown | `.windsurf/workflows
|
|
26
|
+
| エージェント | スキルAPI | 25エージェント | コマンド形式 | コマンドファイル形式 | インストールディレクトリ |
|
|
27
|
+
|-------|-----------|-----------|----------------|---------------------|----------------------|
|
|
28
|
+
| **Claude Code** | ✅ (25スキル) | ✅ | `/sdd-*` | Markdown | `.claude/skills/`, `.claude/commands/` |
|
|
29
|
+
| **GitHub Copilot** | ❌ | ✅ (AGENTS.md) | `#sdd-*` | Markdown + AGENTS.md | `.github/prompts/`, `.github/AGENTS.md` |
|
|
30
|
+
| **Cursor IDE** | ❌ | ✅ (AGENTS.md) | `/sdd-*` | Markdown + AGENTS.md | `.cursor/commands/`, `.cursor/AGENTS.md` |
|
|
31
|
+
| **Gemini CLI** | ❌ | ✅ (GEMINI.md) | `/sdd-*` | TOML + GEMINI.md | `.gemini/commands/`, `GEMINI.md` |
|
|
32
|
+
| **Codex CLI** | ❌ | ✅ (AGENTS.md) | `/prompts:sdd-*` | Markdown + AGENTS.md | `.codex/prompts/`, `.codex/AGENTS.md` |
|
|
33
|
+
| **Qwen Code** | ❌ | ✅ (AGENTS.md) | `/sdd-*` | Markdown + AGENTS.md | `.qwen/commands/`, `.qwen/AGENTS.md` |
|
|
34
|
+
| **Windsurf IDE** | ❌ | ✅ (AGENTS.md) | `/sdd-*` | Markdown + AGENTS.md | `.windsurf/workflows/`, `.windsurf/AGENTS.md` |
|
|
32
35
|
|
|
33
36
|
**注意事項**:
|
|
34
37
|
- スキルAPIはClaude Code専用です
|
|
35
|
-
-
|
|
36
|
-
-
|
|
38
|
+
- **全7プラットフォームが25エージェントに対応**(Skills APIまたはAGENTS.md経由)
|
|
39
|
+
- AGENTS.md: OpenAI仕様、GitHub Copilot & Cursorが公式サポート
|
|
40
|
+
- Gemini CLIはTOML形式 + GEMINI.md統合を使用
|
|
41
|
+
- その他のエージェントはMarkdown形式 + AGENTS.mdを使用
|
|
37
42
|
|
|
38
43
|
## クイックスタート
|
|
39
44
|
|
|
@@ -42,26 +47,26 @@ MUSUBIは7つのAIコーディングエージェントに対応し、それぞ
|
|
|
42
47
|
```bash
|
|
43
48
|
# 好みのエージェント向けにMUSUBIを初期化
|
|
44
49
|
|
|
45
|
-
# Claude Code(デフォルト) - 25
|
|
50
|
+
# Claude Code(デフォルト) - 25 Skills API
|
|
46
51
|
npx musubi-sdd init
|
|
47
52
|
npx musubi-sdd init --claude
|
|
48
53
|
|
|
49
|
-
# GitHub Copilot
|
|
54
|
+
# GitHub Copilot - 25エージェント(AGENTS.md、公式サポート)
|
|
50
55
|
npx musubi-sdd init --copilot
|
|
51
56
|
|
|
52
|
-
# Cursor IDE
|
|
57
|
+
# Cursor IDE - 25エージェント(AGENTS.md、公式サポート)
|
|
53
58
|
npx musubi-sdd init --cursor
|
|
54
59
|
|
|
55
|
-
# Gemini CLI
|
|
60
|
+
# Gemini CLI - 25エージェント(GEMINI.md統合)
|
|
56
61
|
npx musubi-sdd init --gemini
|
|
57
62
|
|
|
58
|
-
# Codex CLI
|
|
63
|
+
# Codex CLI - 25エージェント(AGENTS.md)
|
|
59
64
|
npx musubi-sdd init --codex
|
|
60
65
|
|
|
61
|
-
# Qwen Code
|
|
66
|
+
# Qwen Code - 25エージェント(AGENTS.md)
|
|
62
67
|
npx musubi-sdd init --qwen
|
|
63
68
|
|
|
64
|
-
# Windsurf IDE
|
|
69
|
+
# Windsurf IDE - 25エージェント(AGENTS.md)
|
|
65
70
|
npx musubi-sdd init --windsurf
|
|
66
71
|
|
|
67
72
|
# またはグローバルインストール
|
|
@@ -69,14 +74,78 @@ npm install -g musubi-sdd
|
|
|
69
74
|
musubi init --claude # または --copilot、--cursorなど
|
|
70
75
|
```
|
|
71
76
|
|
|
77
|
+
### プロジェクトタイプ
|
|
78
|
+
|
|
79
|
+
初期化時、MUSUBIは**プロジェクトタイプ**の選択を求めます。これにより、利用可能なワークフローと機能が決定されます。
|
|
80
|
+
|
|
81
|
+
#### Greenfield(0→1)
|
|
82
|
+
- **概要**: ゼロから新しいプロジェクトを開始
|
|
83
|
+
- **使用例**:
|
|
84
|
+
- 新規アプリケーション開発
|
|
85
|
+
- 概念実証プロジェクト
|
|
86
|
+
- グリーンフィールドマイクロサービス
|
|
87
|
+
- **有効化される機能**:
|
|
88
|
+
- 完全な8段階SDDワークフロー(調査 → モニタリング)
|
|
89
|
+
- `/sdd-steering` - 初期プロジェクトメモリの生成
|
|
90
|
+
- `/sdd-requirements` - ゼロから新規要件を作成
|
|
91
|
+
- `/sdd-design` - アーキテクチャ設計(C4モデル + ADR)
|
|
92
|
+
- `/sdd-tasks` - 要件をタスクに分解
|
|
93
|
+
- `/sdd-implement` - 機能実装(テストファースト)
|
|
94
|
+
- `/sdd-validate` - 憲法準拠チェック
|
|
95
|
+
- **メリット**:
|
|
96
|
+
- ベストプラクティスが最初から適用されたクリーンなスタート
|
|
97
|
+
- 初日から憲法ガバナンス
|
|
98
|
+
- 要件からコードまで完全なトレーサビリティ
|
|
99
|
+
|
|
100
|
+
#### Brownfield(1→n)
|
|
101
|
+
- **概要**: 既存のコードベースでの作業
|
|
102
|
+
- **使用例**:
|
|
103
|
+
- 既存アプリケーションへの機能追加
|
|
104
|
+
- レガシーコードのリファクタリング
|
|
105
|
+
- システムの移行/モダナイゼーション
|
|
106
|
+
- **有効化される機能**:
|
|
107
|
+
- 差分仕様(ADDED/MODIFIED/REMOVED)
|
|
108
|
+
- `/sdd-change-init` - 変更提案の作成
|
|
109
|
+
- `/sdd-change-apply` - 影響分析付き変更適用
|
|
110
|
+
- `/sdd-change-archive` - 完了した変更のアーカイブ
|
|
111
|
+
- `change-impact-analyzer`スキル(Claude Code) - 自動影響検出
|
|
112
|
+
- リバースエンジニアリング: `/sdd-steering`が既存コードを分析
|
|
113
|
+
- **メリット**:
|
|
114
|
+
- 影響分析による安全な段階的変更
|
|
115
|
+
- 段階的改善を行いながら既存アーキテクチャを保持
|
|
116
|
+
- 変更内容と理由の完全な監査証跡
|
|
117
|
+
|
|
118
|
+
#### Both(両方)
|
|
119
|
+
- **概要**: 複雑なシナリオ向けハイブリッドアプローチ
|
|
120
|
+
- **使用例**:
|
|
121
|
+
- モノリス → マイクロサービス移行(ブラウンフィールド + グリーンフィールドサービス)
|
|
122
|
+
- プラットフォームモダナイゼーション(一部保持、一部再構築)
|
|
123
|
+
- 成熟度が異なるマルチコンポーネントシステム
|
|
124
|
+
- **有効化される機能**:
|
|
125
|
+
- すべてのGreenfield + Brownfield機能
|
|
126
|
+
- コンポーネントごとにワークフローを選択する柔軟性
|
|
127
|
+
- 同一プロジェクト内で差分仕様とグリーンフィールド仕様を混在
|
|
128
|
+
- **メリット**:
|
|
129
|
+
- 複雑な変革プロジェクトのための最大限の柔軟性
|
|
130
|
+
- すべてのコンポーネント全体で統一されたステアリング/ガバナンス
|
|
131
|
+
- モダナイゼーション全体を単一ツールで実施
|
|
132
|
+
|
|
133
|
+
**選択例**:
|
|
134
|
+
```
|
|
135
|
+
? Project type:
|
|
136
|
+
❯ Greenfield (0→1) ← 新規プロジェクト
|
|
137
|
+
Brownfield (1→n) ← 既存コードベース
|
|
138
|
+
Both ← 複雑/ハイブリッドシナリオ
|
|
139
|
+
```
|
|
140
|
+
|
|
72
141
|
### インストールされる内容
|
|
73
142
|
|
|
74
|
-
#### Claude Code
|
|
143
|
+
#### Claude Code(Skills API)
|
|
75
144
|
|
|
76
145
|
```
|
|
77
146
|
your-project/
|
|
78
147
|
├── .claude/
|
|
79
|
-
│ ├── skills/ # 25
|
|
148
|
+
│ ├── skills/ # 25 Skills API(Claude Code専用機能)
|
|
80
149
|
│ │ ├── orchestrator/
|
|
81
150
|
│ │ ├── steering/
|
|
82
151
|
│ │ ├── requirements-analyst/
|
|
@@ -100,8 +169,10 @@ your-project/
|
|
|
100
169
|
```
|
|
101
170
|
your-project/
|
|
102
171
|
├── .github/prompts/ # GitHub Copilot用(#sdd-*、Markdown)
|
|
172
|
+
│ ├── AGENTS.md # 25エージェント定義(公式サポート)
|
|
103
173
|
│ または
|
|
104
174
|
├── .cursor/commands/ # Cursor用(/sdd-*、Markdown)
|
|
175
|
+
│ ├── AGENTS.md # 25エージェント定義(公式サポート)
|
|
105
176
|
│ または
|
|
106
177
|
├── .gemini/commands/ # Gemini CLI用(/sdd-*、TOML)
|
|
107
178
|
│ │ ├── sdd-steering.toml
|
|
@@ -109,21 +180,26 @@ your-project/
|
|
|
109
180
|
│ │ └── ... (6つのTOMLファイル)
|
|
110
181
|
│ または
|
|
111
182
|
├── .codex/prompts/ # Codex CLI用(/prompts:sdd-*、Markdown)
|
|
183
|
+
│ ├── AGENTS.md # 25エージェント定義
|
|
112
184
|
│ または
|
|
113
185
|
├── .qwen/commands/ # Qwen Code用(/sdd-*、Markdown)
|
|
186
|
+
│ ├── AGENTS.md # 25エージェント定義
|
|
114
187
|
│ または
|
|
115
188
|
├── .windsurf/workflows/ # Windsurf用(/sdd-*、Markdown)
|
|
189
|
+
│ ├── AGENTS.md # 25エージェント定義
|
|
116
190
|
│
|
|
117
|
-
├──
|
|
191
|
+
├── GEMINI.md(ルート、Gemini用) # 25エージェントを既存ファイルに統合
|
|
118
192
|
├── steering/ # プロジェクトメモリ(全て共通)
|
|
119
193
|
├── templates/ # ドキュメントテンプレート(全て共通)
|
|
120
194
|
└── storage/ # 仕様、変更、機能(全て共通)
|
|
121
195
|
```
|
|
122
196
|
|
|
123
197
|
**主な違い**:
|
|
124
|
-
- Claude Code
|
|
125
|
-
-
|
|
126
|
-
-
|
|
198
|
+
- **Claude Code**: 25 Skills API(専用) + コマンド(Markdown)
|
|
199
|
+
- **GitHub Copilot & Cursor**: AGENTS.md(公式サポート) + コマンド(Markdown)
|
|
200
|
+
- **Gemini CLI**: GEMINI.md統合(25エージェント) + TOMLコマンド(ユニーク)
|
|
201
|
+
- **その他**: AGENTS.md(互換) + Markdownコマンド
|
|
202
|
+
- **全プラットフォーム**: 同じ25エージェント、異なる実装形式
|
|
127
203
|
|
|
128
204
|
## 使用方法
|
|
129
205
|
|
|
@@ -275,7 +351,12 @@ MUSUBIプロジェクトの現在の状態を表示します。
|
|
|
275
351
|
/prompts:sdd-validate authentication
|
|
276
352
|
```
|
|
277
353
|
|
|
278
|
-
## 25
|
|
354
|
+
## 25エージェント概要(全プラットフォーム対応)
|
|
355
|
+
|
|
356
|
+
**全7プラットフォームで利用可能**:
|
|
357
|
+
- **Claude Code**: Skills API(自動起動)
|
|
358
|
+
- **GitHub Copilot & Cursor**: AGENTS.md(公式サポート、`@エージェント名`で参照)
|
|
359
|
+
- **Gemini、Windsurf、Codex、Qwen**: AGENTS.md(互換形式、自然言語で参照)
|
|
279
360
|
|
|
280
361
|
### オーケストレーションと管理(3)
|
|
281
362
|
- **orchestrator** - マルチスキルワークフローのマスターコーディネーター
|
package/README.md
CHANGED
|
@@ -7,8 +7,11 @@ MUSUBI is a comprehensive SDD (Specification Driven Development) framework that
|
|
|
7
7
|
## Features
|
|
8
8
|
|
|
9
9
|
- 🤖 **Multi-Agent Support** - Works with 7 AI coding agents (Claude Code, GitHub Copilot, Cursor, Gemini CLI, Codex CLI, Qwen Code, Windsurf)
|
|
10
|
-
- 📄 **Flexible Command Formats** - Supports
|
|
11
|
-
- 🎯 **25 Specialized
|
|
10
|
+
- 📄 **Flexible Command Formats** - Supports Markdown, TOML, and AGENTS.md formats
|
|
11
|
+
- 🎯 **25 Specialized Agents (All Platforms)** - Orchestrator, Steering, Requirements, Architecture, Development, Quality, Security, Infrastructure
|
|
12
|
+
- Claude Code: Skills API (25 skills)
|
|
13
|
+
- GitHub Copilot & Cursor: AGENTS.md (official support)
|
|
14
|
+
- Other 4 agents: AGENTS.md (compatible format)
|
|
12
15
|
- 📋 **Constitutional Governance** - 9 immutable articles + Phase -1 Gates for quality enforcement
|
|
13
16
|
- 📝 **EARS Requirements Format** - Unambiguous requirements with complete traceability
|
|
14
17
|
- 🔄 **Delta Specifications** - Brownfield and greenfield project support
|
|
@@ -20,20 +23,22 @@ MUSUBI is a comprehensive SDD (Specification Driven Development) framework that
|
|
|
20
23
|
|
|
21
24
|
MUSUBI supports 7 AI coding agents, each with tailored configurations:
|
|
22
25
|
|
|
23
|
-
| Agent | Skills API | Command Format | Command File Format | Installation Directory |
|
|
24
|
-
|
|
25
|
-
| **Claude Code** | ✅ (25 skills) | `/sdd-*` | Markdown | `.claude/skills/`, `.claude/commands/` |
|
|
26
|
-
| **GitHub Copilot** | ❌ | `#sdd-*` | Markdown | `.github/prompts
|
|
27
|
-
| **Cursor IDE** | ❌ | `/sdd-*` | Markdown | `.cursor/commands
|
|
28
|
-
| **Gemini CLI** | ❌ | `/sdd-*` |
|
|
29
|
-
| **Codex CLI** | ❌ | `/prompts:sdd-*` | Markdown | `.codex/prompts
|
|
30
|
-
| **Qwen Code** | ❌ | `/sdd-*` | Markdown | `.qwen/commands
|
|
31
|
-
| **Windsurf IDE** | ❌ | `/sdd-*` | Markdown | `.windsurf/workflows
|
|
26
|
+
| Agent | Skills API | 25 Agents | Command Format | Command File Format | Installation Directory |
|
|
27
|
+
|-------|-----------|-----------|----------------|---------------------|----------------------|
|
|
28
|
+
| **Claude Code** | ✅ (25 skills) | ✅ | `/sdd-*` | Markdown | `.claude/skills/`, `.claude/commands/` |
|
|
29
|
+
| **GitHub Copilot** | ❌ | ✅ (AGENTS.md) | `#sdd-*` | Markdown + AGENTS.md | `.github/prompts/`, `.github/AGENTS.md` |
|
|
30
|
+
| **Cursor IDE** | ❌ | ✅ (AGENTS.md) | `/sdd-*` | Markdown + AGENTS.md | `.cursor/commands/`, `.cursor/AGENTS.md` |
|
|
31
|
+
| **Gemini CLI** | ❌ | ✅ (GEMINI.md) | `/sdd-*` | TOML + GEMINI.md | `.gemini/commands/`, `GEMINI.md` |
|
|
32
|
+
| **Codex CLI** | ❌ | ✅ (AGENTS.md) | `/prompts:sdd-*` | Markdown + AGENTS.md | `.codex/prompts/`, `.codex/AGENTS.md` |
|
|
33
|
+
| **Qwen Code** | ❌ | ✅ (AGENTS.md) | `/sdd-*` | Markdown + AGENTS.md | `.qwen/commands/`, `.qwen/AGENTS.md` |
|
|
34
|
+
| **Windsurf IDE** | ❌ | ✅ (AGENTS.md) | `/sdd-*` | Markdown + AGENTS.md | `.windsurf/workflows/`, `.windsurf/AGENTS.md` |
|
|
32
35
|
|
|
33
36
|
**Notes**:
|
|
34
37
|
- Skills API is exclusive to Claude Code
|
|
35
|
-
-
|
|
36
|
-
-
|
|
38
|
+
- **All 7 platforms now support 25 agents** via Skills API (Claude Code) or AGENTS.md (others)
|
|
39
|
+
- AGENTS.md: OpenAI specification, officially supported by GitHub Copilot & Cursor
|
|
40
|
+
- Gemini CLI uses TOML format + GEMINI.md integration
|
|
41
|
+
- All other agents use Markdown format + AGENTS.md
|
|
37
42
|
|
|
38
43
|
## Quick Start
|
|
39
44
|
|
|
@@ -42,26 +47,26 @@ MUSUBI supports 7 AI coding agents, each with tailored configurations:
|
|
|
42
47
|
```bash
|
|
43
48
|
# Initialize MUSUBI for your preferred agent
|
|
44
49
|
|
|
45
|
-
# Claude Code (default) -
|
|
50
|
+
# Claude Code (default) - 25 Skills API
|
|
46
51
|
npx musubi-sdd init
|
|
47
52
|
npx musubi-sdd init --claude
|
|
48
53
|
|
|
49
|
-
# GitHub Copilot
|
|
54
|
+
# GitHub Copilot - 25 agents (AGENTS.md, official support)
|
|
50
55
|
npx musubi-sdd init --copilot
|
|
51
56
|
|
|
52
|
-
# Cursor IDE
|
|
57
|
+
# Cursor IDE - 25 agents (AGENTS.md, official support)
|
|
53
58
|
npx musubi-sdd init --cursor
|
|
54
59
|
|
|
55
|
-
# Gemini CLI
|
|
60
|
+
# Gemini CLI - 25 agents (GEMINI.md integration)
|
|
56
61
|
npx musubi-sdd init --gemini
|
|
57
62
|
|
|
58
|
-
# Codex CLI
|
|
63
|
+
# Codex CLI - 25 agents (AGENTS.md)
|
|
59
64
|
npx musubi-sdd init --codex
|
|
60
65
|
|
|
61
|
-
# Qwen Code
|
|
66
|
+
# Qwen Code - 25 agents (AGENTS.md)
|
|
62
67
|
npx musubi-sdd init --qwen
|
|
63
68
|
|
|
64
|
-
# Windsurf IDE
|
|
69
|
+
# Windsurf IDE - 25 agents (AGENTS.md)
|
|
65
70
|
npx musubi-sdd init --windsurf
|
|
66
71
|
|
|
67
72
|
# Or install globally
|
|
@@ -69,14 +74,78 @@ npm install -g musubi-sdd
|
|
|
69
74
|
musubi init --claude # or --copilot, --cursor, etc.
|
|
70
75
|
```
|
|
71
76
|
|
|
77
|
+
### Project Types
|
|
78
|
+
|
|
79
|
+
During initialization, MUSUBI asks you to select a **Project Type**. This determines the workflow and features available:
|
|
80
|
+
|
|
81
|
+
#### Greenfield (0→1)
|
|
82
|
+
- **What it is**: Starting a new project from scratch
|
|
83
|
+
- **Use cases**:
|
|
84
|
+
- New application development
|
|
85
|
+
- Proof-of-concept projects
|
|
86
|
+
- Greenfield microservices
|
|
87
|
+
- **Features enabled**:
|
|
88
|
+
- Full 8-stage SDD workflow (Research → Monitoring)
|
|
89
|
+
- `/sdd-steering` - Generate initial project memory
|
|
90
|
+
- `/sdd-requirements` - Create new requirements from scratch
|
|
91
|
+
- `/sdd-design` - Design architecture (C4 model + ADR)
|
|
92
|
+
- `/sdd-tasks` - Break requirements into tasks
|
|
93
|
+
- `/sdd-implement` - Implement features (test-first)
|
|
94
|
+
- `/sdd-validate` - Constitutional compliance checks
|
|
95
|
+
- **Benefits**:
|
|
96
|
+
- Clean start with best practices enforced
|
|
97
|
+
- Constitutional governance from day one
|
|
98
|
+
- Complete traceability from requirements to code
|
|
99
|
+
|
|
100
|
+
#### Brownfield (1→n)
|
|
101
|
+
- **What it is**: Working with existing codebases
|
|
102
|
+
- **Use cases**:
|
|
103
|
+
- Adding features to existing applications
|
|
104
|
+
- Refactoring legacy code
|
|
105
|
+
- Migrating/modernizing systems
|
|
106
|
+
- **Features enabled**:
|
|
107
|
+
- Delta Specifications (ADDED/MODIFIED/REMOVED)
|
|
108
|
+
- `/sdd-change-init` - Create change proposal
|
|
109
|
+
- `/sdd-change-apply` - Apply changes with impact analysis
|
|
110
|
+
- `/sdd-change-archive` - Archive completed changes
|
|
111
|
+
- `change-impact-analyzer` skill (Claude Code) - Automatic impact detection
|
|
112
|
+
- Reverse engineering: `/sdd-steering` analyzes existing code
|
|
113
|
+
- **Benefits**:
|
|
114
|
+
- Safe incremental changes with impact analysis
|
|
115
|
+
- Preserves existing architecture while improving incrementally
|
|
116
|
+
- Full audit trail of what changed and why
|
|
117
|
+
|
|
118
|
+
#### Both
|
|
119
|
+
- **What it is**: Hybrid approach for complex scenarios
|
|
120
|
+
- **Use cases**:
|
|
121
|
+
- Monolith → Microservices migration (brownfield + greenfield services)
|
|
122
|
+
- Platform modernization (keep some, rebuild others)
|
|
123
|
+
- Multi-component systems with mixed maturity
|
|
124
|
+
- **Features enabled**:
|
|
125
|
+
- All Greenfield + Brownfield features
|
|
126
|
+
- Flexibility to choose workflow per component
|
|
127
|
+
- Mixed delta specs and greenfield specs in same project
|
|
128
|
+
- **Benefits**:
|
|
129
|
+
- Maximum flexibility for complex transformation projects
|
|
130
|
+
- Unified steering/governance across all components
|
|
131
|
+
- Single tool for entire modernization journey
|
|
132
|
+
|
|
133
|
+
**Example Selection**:
|
|
134
|
+
```
|
|
135
|
+
? Project type:
|
|
136
|
+
❯ Greenfield (0→1) ← New projects
|
|
137
|
+
Brownfield (1→n) ← Existing codebases
|
|
138
|
+
Both ← Complex/hybrid scenarios
|
|
139
|
+
```
|
|
140
|
+
|
|
72
141
|
### What Gets Installed
|
|
73
142
|
|
|
74
|
-
#### Claude Code (
|
|
143
|
+
#### Claude Code (Skills API)
|
|
75
144
|
|
|
76
145
|
```
|
|
77
146
|
your-project/
|
|
78
147
|
├── .claude/
|
|
79
|
-
│ ├── skills/ # 25
|
|
148
|
+
│ ├── skills/ # 25 Skills API (Claude Code exclusive feature)
|
|
80
149
|
│ │ ├── orchestrator/
|
|
81
150
|
│ │ ├── steering/
|
|
82
151
|
│ │ ├── requirements-analyst/
|
|
@@ -100,8 +169,10 @@ your-project/
|
|
|
100
169
|
```
|
|
101
170
|
your-project/
|
|
102
171
|
├── .github/prompts/ # For GitHub Copilot (#sdd-*, Markdown)
|
|
172
|
+
│ ├── AGENTS.md # 25 agents definition (official support)
|
|
103
173
|
│ OR
|
|
104
174
|
├── .cursor/commands/ # For Cursor (/sdd-*, Markdown)
|
|
175
|
+
│ ├── AGENTS.md # 25 agents definition (official support)
|
|
105
176
|
│ OR
|
|
106
177
|
├── .gemini/commands/ # For Gemini CLI (/sdd-*, TOML)
|
|
107
178
|
│ │ ├── sdd-steering.toml
|
|
@@ -109,21 +180,26 @@ your-project/
|
|
|
109
180
|
│ │ └── ... (6 TOML files)
|
|
110
181
|
│ OR
|
|
111
182
|
├── .codex/prompts/ # For Codex CLI (/prompts:sdd-*, Markdown)
|
|
183
|
+
│ ├── AGENTS.md # 25 agents definition
|
|
112
184
|
│ OR
|
|
113
185
|
├── .qwen/commands/ # For Qwen Code (/sdd-*, Markdown)
|
|
186
|
+
│ ├── AGENTS.md # 25 agents definition
|
|
114
187
|
│ OR
|
|
115
188
|
├── .windsurf/workflows/ # For Windsurf (/sdd-*, Markdown)
|
|
189
|
+
│ ├── AGENTS.md # 25 agents definition
|
|
116
190
|
│
|
|
117
|
-
├──
|
|
191
|
+
├── GEMINI.md (root, for Gemini) # 25 agents integrated into existing file
|
|
118
192
|
├── steering/ # Project memory (same for all)
|
|
119
193
|
├── templates/ # Document templates (same for all)
|
|
120
194
|
└── storage/ # Specs, changes, features (same for all)
|
|
121
195
|
```
|
|
122
196
|
|
|
123
197
|
**Key Differences**:
|
|
124
|
-
- Claude Code
|
|
125
|
-
-
|
|
126
|
-
-
|
|
198
|
+
- **Claude Code**: 25 Skills API (exclusive) + commands (Markdown)
|
|
199
|
+
- **GitHub Copilot & Cursor**: AGENTS.md (official support) + commands (Markdown)
|
|
200
|
+
- **Gemini CLI**: GEMINI.md integration (25 agents) + TOML commands (unique)
|
|
201
|
+
- **Others**: AGENTS.md (compatible) + Markdown commands
|
|
202
|
+
- **All platforms**: Same 25 agents, different implementation formats
|
|
127
203
|
|
|
128
204
|
## Usage
|
|
129
205
|
|
|
@@ -275,7 +351,12 @@ For comprehensive validation, use your agent's `/sdd-validate` (or equivalent) c
|
|
|
275
351
|
/prompts:sdd-validate authentication
|
|
276
352
|
```
|
|
277
353
|
|
|
278
|
-
## 25
|
|
354
|
+
## 25 Agents Overview (All Platforms)
|
|
355
|
+
|
|
356
|
+
**Available on all 7 platforms** via:
|
|
357
|
+
- **Claude Code**: Skills API (automatic invocation)
|
|
358
|
+
- **GitHub Copilot & Cursor**: AGENTS.md (official support, reference via `@agent-name`)
|
|
359
|
+
- **Gemini, Windsurf, Codex, Qwen**: AGENTS.md (compatible format, natural language reference)
|
|
279
360
|
|
|
280
361
|
### Orchestration & Management (3)
|
|
281
362
|
- **orchestrator** - Master coordinator for multi-skill workflows
|
package/bin/musubi-init.js
CHANGED
|
@@ -181,6 +181,12 @@ async function main(agent, agentKey) {
|
|
|
181
181
|
console.log(chalk.green(` Installed ${commandType}`));
|
|
182
182
|
}
|
|
183
183
|
|
|
184
|
+
// Install AGENTS.md (all platforms get 25 agent definitions)
|
|
185
|
+
if (agent.layout.agentsFile) {
|
|
186
|
+
await copyAgentsFile(agent);
|
|
187
|
+
console.log(chalk.green(' Installed 25 agent definitions (AGENTS.md)'));
|
|
188
|
+
}
|
|
189
|
+
|
|
184
190
|
// Generate steering context
|
|
185
191
|
if (answers.createSteering) {
|
|
186
192
|
await generateSteering(answers);
|
|
@@ -233,6 +239,35 @@ async function copyCommands(agent, agentKey) {
|
|
|
233
239
|
}
|
|
234
240
|
}
|
|
235
241
|
|
|
242
|
+
async function copyAgentsFile(agent) {
|
|
243
|
+
const sharedAgentsFile = path.join(AGENTS_TEMPLATE_DIR, 'shared', 'AGENTS.md');
|
|
244
|
+
const destFile = agent.layout.agentsFile;
|
|
245
|
+
|
|
246
|
+
// For Gemini CLI, AGENTS.md is embedded in GEMINI.md
|
|
247
|
+
if (destFile === 'GEMINI.md') {
|
|
248
|
+
// Read shared AGENTS.md
|
|
249
|
+
const agentsContent = await fs.readFile(sharedAgentsFile, 'utf8');
|
|
250
|
+
|
|
251
|
+
// Read existing GEMINI.md template if exists
|
|
252
|
+
const geminiTemplate = path.join(AGENTS_TEMPLATE_DIR, 'gemini-cli', 'GEMINI.md');
|
|
253
|
+
let geminiContent = '';
|
|
254
|
+
if (fs.existsSync(geminiTemplate)) {
|
|
255
|
+
geminiContent = await fs.readFile(geminiTemplate, 'utf8');
|
|
256
|
+
} else {
|
|
257
|
+
geminiContent = `# Gemini CLI - MUSUBI Configuration\n\n` +
|
|
258
|
+
`This file configures Gemini CLI for MUSUBI SDD.\n\n` +
|
|
259
|
+
`---\n\n`;
|
|
260
|
+
}
|
|
261
|
+
|
|
262
|
+
// Append AGENTS.md content
|
|
263
|
+
geminiContent += agentsContent;
|
|
264
|
+
await fs.writeFile(destFile, geminiContent);
|
|
265
|
+
} else {
|
|
266
|
+
// For other platforms, copy AGENTS.md as-is
|
|
267
|
+
await fs.copy(sharedAgentsFile, destFile);
|
|
268
|
+
}
|
|
269
|
+
}
|
|
270
|
+
|
|
236
271
|
async function generateSteering(answers) {
|
|
237
272
|
const steeringTemplates = path.join(SHARED_TEMPLATE_DIR, 'steering');
|
|
238
273
|
|
package/package.json
CHANGED
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "musubi-sdd",
|
|
3
|
-
"version": "0.1.
|
|
4
|
-
"description": "Ultimate Specification Driven Development Tool with 25 Claude Code
|
|
3
|
+
"version": "0.1.3",
|
|
4
|
+
"description": "Ultimate Specification Driven Development Tool with 25 Agents for 7 AI Coding Platforms (Claude Code, GitHub Copilot, Cursor, Gemini CLI, Windsurf, Codex, Qwen Code)",
|
|
5
5
|
"main": "src/index.js",
|
|
6
6
|
"bin": {
|
|
7
7
|
"musubi-sdd": "bin/musubi.js",
|