Skip to content

Commit 3e883a4

Browse files
committed
feat(cli): add CLI integration across all 7 platforms
- Add 6 new CLI commands to Claude Code skills (v3.5.0) - Add CLI Commands section to all non-Claude platforms - Update Learn More sections with CLI Reference links - Update Agent↔CLI mapping in Orchestrator skill Skills updated: - orchestrator: All 20 CLI commands with detailed options - issue-resolver: musubi-resolve quick start - agent-assistant: musubi-remember memory management - test-engineer: musubi-browser E2E testing - ui-ux-designer: musubi-browser UI testing - site-reliability-engineer: musubi-gui dashboard - steering: musubi-remember memory CLI - project-manager: musubi-orchestrate coordination Platforms updated: - GitHub Copilot, Cursor, Codex, Windsurf (AGENTS.md) - Gemini CLI (GEMINI.md), Qwen Code (QWEN.md) Closes #cli-integration
1 parent 6a82025 commit 3e883a4

24 files changed

Lines changed: 1707 additions & 688 deletions

File tree

AGENTS.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -32,5 +32,5 @@ This project uses **MUSUBI** (Ultimate Specification Driven Development).
3232
---
3333

3434
**Agent**: GitHub Copilot
35-
**Initialized**: 2025-12-07
35+
**Initialized**: 2025-12-08
3636
**MUSUBI Version**: 0.1.0

CHANGELOG.md

Lines changed: 42 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -5,6 +5,48 @@ All notable changes to this project will be documented in this file.
55
The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
66
and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
77

8+
## [3.5.1] - 2025-12-08
9+
10+
### Added
11+
12+
**CLI Integration Across All Platforms**
13+
14+
- Added CLI command references to 8 Claude Code skills:
15+
- `orchestrator` - All 20 CLI commands with detailed options
16+
- `issue-resolver` - `musubi-resolve` quick start guide
17+
- `agent-assistant` - `musubi-remember` memory management
18+
- `test-engineer` - `musubi-browser` E2E testing
19+
- `ui-ux-designer` - `musubi-browser` UI testing
20+
- `site-reliability-engineer` - `musubi-gui` dashboard
21+
- `steering` - `musubi-remember` memory CLI
22+
- `project-manager` - `musubi-orchestrate` multi-skill coordination
23+
24+
- Added CLI Commands section to all 6 non-Claude platforms:
25+
- GitHub Copilot (`AGENTS.md`)
26+
- Cursor (`AGENTS.md`)
27+
- Codex (`AGENTS.md`)
28+
- Windsurf (`AGENTS.md`)
29+
- Gemini CLI (`GEMINI.md`)
30+
- Qwen Code (`QWEN.md`)
31+
32+
### Changed
33+
34+
- Updated Learn More sections with CLI Reference links across all platforms
35+
- Updated Agent↔CLI mapping in Orchestrator skill
36+
- Fixed documentation URLs from `your-org` to `nahisaho`
37+
38+
### Documentation
39+
40+
- Added v3.5.0 NEW CLI commands documentation:
41+
- `musubi-orchestrate` - Multi-skill workflow orchestration
42+
- `musubi-browser` - Browser automation & E2E testing
43+
- `musubi-gui` - Web GUI dashboard
44+
- `musubi-remember` - Agent memory management
45+
- `musubi-resolve` - GitHub Issue auto-resolution
46+
- `musubi-convert` - Format conversion (Spec Kit)
47+
48+
---
49+
850
## [3.4.0] - 2025-06-14
951

1052
### Added - Phase 5 Advanced Features Complete 🎉

bin/musubi-orchestrate.js

100644100755
File mode changed.

src/templates/agents/claude-code/skills/agent-assistant/SKILL.md

Lines changed: 22 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -88,6 +88,28 @@ Extracts and persists learnings from agent sessions:
8888
- **Error Solutions**: Error-resolution mappings
8989
- **Project Structure**: Codebase knowledge
9090

91+
**CLI Command (v3.5.0 NEW)**:
92+
93+
```bash
94+
# Extract learnings from current session
95+
musubi-remember extract
96+
97+
# Export memory to file
98+
musubi-remember export ./session-memory.json
99+
100+
# Import memory from file
101+
musubi-remember import ./session-memory.json
102+
103+
# Condense memory to fit context window
104+
musubi-remember condense
105+
106+
# List stored memories
107+
musubi-remember list
108+
109+
# Clear session memory
110+
musubi-remember clear
111+
```
112+
91113
**Usage Example**:
92114
```javascript
93115
const { AgentMemoryManager } = require('musubi/src/managers/agent-memory');

src/templates/agents/claude-code/skills/issue-resolver/SKILL.md

Lines changed: 21 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -155,6 +155,27 @@ const preview = resolver.generatePreview(result);
155155

156156
### Issue to SDD Workflow
157157

158+
**Quick Start with `musubi-resolve` CLI (v3.5.0 NEW)**:
159+
160+
```bash
161+
# One-command issue resolution
162+
musubi-resolve 42
163+
164+
# Analyze without resolution
165+
musubi-resolve analyze 42
166+
167+
# Generate resolution plan
168+
musubi-resolve plan 42
169+
170+
# Create PR from resolution
171+
musubi-resolve create-pr 42
172+
173+
# Auto-resolve mode
174+
musubi-resolve 42 --auto
175+
```
176+
177+
**Manual SDD Workflow**:
178+
158179
```bash
159180
# 1. Analyze issue and create requirement document
160181
musubi-requirements init "issue-42-login-fix"

src/templates/agents/claude-code/skills/orchestrator/SKILL.md

Lines changed: 90 additions & 28 deletions
Original file line numberDiff line numberDiff line change
@@ -94,6 +94,17 @@ The Orchestrator can leverage all MUSUBI CLI commands to execute tasks efficient
9494
| `musubi-analyze` | Project analysis | `musubi-analyze complexity` |
9595
| `musubi-onboard` | AI platform onboarding | `musubi-onboard <platform>` |
9696

97+
### Advanced Commands (v3.5.0 NEW)
98+
99+
| Command | Purpose | Example |
100+
| ------------------- | --------------------------------- | ------------------------------------------ |
101+
| `musubi-orchestrate`| Multi-skill workflow orchestration| `musubi-orchestrate auto <task>` |
102+
| `musubi-browser` | Browser automation & E2E testing | `musubi-browser run "click login button"` |
103+
| `musubi-gui` | Web GUI dashboard | `musubi-gui start` |
104+
| `musubi-remember` | Agent memory management | `musubi-remember extract` |
105+
| `musubi-resolve` | GitHub Issue auto-resolution | `musubi-resolve <issue-number>` |
106+
| `musubi-convert` | Format conversion (Spec Kit) | `musubi-convert to-speckit` |
107+
97108
### Detailed Command Options
98109

99110
**musubi-workflow** (v2.1.0 NEW):
@@ -166,6 +177,57 @@ The Orchestrator can leverage all MUSUBI CLI commands to execute tasks efficient
166177
- `complexity` - Validate complexity limits
167178
- `all` - Run all validations
168179

180+
**musubi-orchestrate** (v3.5.0 NEW):
181+
182+
- `auto <task>` - Auto-select and execute skill based on task
183+
- `sequential --skills <skills...>` - Execute skills sequentially
184+
- `run <pattern> --skills <skills...>` - Execute pattern with skills
185+
- `list-patterns` - List available orchestration patterns
186+
- `list-skills` - List available skills
187+
- `status` - Show orchestration status
188+
189+
**musubi-browser** (v3.5.0 NEW):
190+
191+
- `run "<command>"` - Execute natural language browser command
192+
- `script <file>` - Execute script file with commands
193+
- `compare <expected> <actual>` - Compare screenshots with AI
194+
- `generate-test --history <file>` - Generate Playwright test from history
195+
- Interactive mode: Start with `musubi-browser` for REPL
196+
197+
**musubi-gui** (v3.5.0 NEW):
198+
199+
- `start` - Start Web GUI server (default: port 3000)
200+
- `start -p <port>` - Start on custom port
201+
- `start -d <path>` - Start with custom project directory
202+
- `dev` - Start in development mode with hot reload
203+
- `status` - Check GUI server status
204+
- `matrix` - Open traceability matrix view
205+
206+
**musubi-remember** (v3.5.0 NEW):
207+
208+
- `extract` - Extract learnings from current session
209+
- `export <file>` - Export memory to file
210+
- `import <file>` - Import memory from file
211+
- `condense` - Condense memory to fit context window
212+
- `list` - List stored memories
213+
- `clear` - Clear session memory
214+
215+
**musubi-resolve** (v3.5.0 NEW):
216+
217+
- `<issue-number>` - Analyze and resolve GitHub issue
218+
- `analyze <issue-number>` - Analyze issue without resolution
219+
- `plan <issue-number>` - Generate resolution plan
220+
- `create-pr <issue-number>` - Create PR from resolution
221+
- `list` - List open issues
222+
- `--auto` - Enable auto-resolution mode
223+
224+
**musubi-convert** (v3.5.0 NEW):
225+
226+
- `to-speckit` - Convert MUSUBI to Spec Kit format
227+
- `from-speckit` - Convert Spec Kit to MUSUBI format
228+
- `analyze` - Analyze format compatibility
229+
- `--output <dir>` - Specify output directory
230+
169231
---
170232

171233
## OpenHands-Inspired Modules (v3.0.0)
@@ -417,11 +479,11 @@ codegraph-mcp community "/path/to/project"
417479

418480
### Orchestration & Governance (3 agents)
419481

420-
| Agent | Specialty | Key Deliverables |
421-
| ------------------------- | ------------------------- | --------------------------------------- |
422-
| **Orchestrator** | Multi-agent coordination | Execution plans, integrated reports |
423-
| **Steering** | Project memory management | Steering files (structure/tech/product) |
424-
| **Constitution Enforcer** | Constitutional validation | Compliance reports, violation alerts |
482+
| Agent | Specialty | Key Deliverables | CLI Command |
483+
| ------------------------- | ------------------------- | --------------------------------------- | --------------------- |
484+
| **Orchestrator** | Multi-agent coordination | Execution plans, integrated reports | `musubi-orchestrate` |
485+
| **Steering** | Project memory management | Steering files (structure/tech/product) | `musubi-remember` |
486+
| **Constitution Enforcer** | Constitutional validation | Compliance reports, violation alerts | `musubi-validate` |
425487

426488
### Design & Architecture (5 agents)
427489

@@ -435,35 +497,35 @@ codegraph-mcp community "/path/to/project"
435497

436498
### Development & Quality (7 agents)
437499

438-
| Agent | Specialty | Key Deliverables | CLI Command |
439-
| ------------------------- | ---------------------------- | ------------------------------------------------------------- | ----------------- |
440-
| **Software Developer** | Code implementation | Production-ready source code, unit tests, integration tests | - |
441-
| **Code Reviewer** | Code review | Review reports, improvement suggestions, refactoring plans | - |
442-
| **Test Engineer** | Test design & implementation | Test code, test design documents, test cases | `musubi-tasks` |
443-
| **Security Auditor** | Security auditing | Vulnerability reports, remediation plans, security guidelines | - |
444-
| **Quality Assurance** | Quality assurance strategy | Test plans, quality metrics, QA reports | `musubi-validate` |
445-
| **Bug Hunter** | Bug investigation & fixes | Bug reports, root cause analysis, fix code | - |
446-
| **Performance Optimizer** | Performance optimization | Performance reports, optimization code, benchmarks | - |
500+
| Agent | Specialty | Key Deliverables | CLI Command |
501+
| ------------------------- | ---------------------------- | ------------------------------------------------------------- | ------------------ |
502+
| **Software Developer** | Code implementation | Production-ready source code, unit tests, integration tests | - |
503+
| **Code Reviewer** | Code review | Review reports, improvement suggestions, refactoring plans | - |
504+
| **Test Engineer** | Test design & implementation | Test code, test design documents, test cases | `musubi-tasks` |
505+
| **Security Auditor** | Security auditing | Vulnerability reports, remediation plans, security guidelines | - |
506+
| **Quality Assurance** | Quality assurance strategy | Test plans, quality metrics, QA reports | `musubi-validate` |
507+
| **Bug Hunter** | Bug investigation & fixes | Bug reports, root cause analysis, fix code | `musubi-resolve` |
508+
| **Performance Optimizer** | Performance optimization | Performance reports, optimization code, benchmarks | - |
447509

448510
### Operations & Infrastructure (5 agents)
449511

450-
| Agent | Specialty | Key Deliverables | CLI Command |
451-
| ----------------------------- | --------------------------------- | ---------------------------------------------------- | -------------- |
452-
| **Project Manager** | Project management | Project plans, WBS, Gantt charts, risk registers | `musubi-tasks` |
453-
| **DevOps Engineer** | CI/CD & infrastructure automation | Pipeline definitions, Dockerfiles, K8s manifests | - |
454-
| **Technical Writer** | Technical documentation | API docs, README, user guides, runbooks | - |
455-
| **Site Reliability Engineer** | SRE & observability | SLI/SLO/SLA definitions, monitoring configs | - |
456-
| **Release Coordinator** | Release management | Release notes, deployment plans, rollback procedures | - |
512+
| Agent | Specialty | Key Deliverables | CLI Command |
513+
| ----------------------------- | --------------------------------- | ---------------------------------------------------- | ---------------- |
514+
| **Project Manager** | Project management | Project plans, WBS, Gantt charts, risk registers | `musubi-tasks` |
515+
| **DevOps Engineer** | CI/CD & infrastructure automation | Pipeline definitions, Dockerfiles, K8s manifests | - |
516+
| **Technical Writer** | Technical documentation | API docs, README, user guides, runbooks | - |
517+
| **Site Reliability Engineer** | SRE & observability | SLI/SLO/SLA definitions, monitoring configs | `musubi-gui` |
518+
| **Release Coordinator** | Release management | Release notes, deployment plans, rollback procedures | - |
457519

458520
### Specialized Experts (5 agents)
459521

460-
| Agent | Specialty | Key Deliverables | CLI Command |
461-
| -------------------------- | ---------------------------- | --------------------------------------------------------------------- | --------------- |
462-
| **UI/UX Designer** | UI/UX design & prototyping | Wireframes, mockups, interactive prototypes, design systems | - |
463-
| **Database Administrator** | Database operations & tuning | Performance tuning reports, backup/recovery plans, HA configurations | - |
464-
| **AI/ML Engineer** | ML model development & MLOps | Trained models, model cards, deployment pipelines, evaluation reports | - |
465-
| **Change Impact Analyzer** | Impact analysis | Impact reports, affected components, effort estimates | `musubi-change` |
466-
| **Traceability Auditor** | Traceability verification | Traceability matrices, coverage reports, gap analysis | `musubi-trace` |
522+
| Agent | Specialty | Key Deliverables | CLI Command |
523+
| -------------------------- | ---------------------------- | --------------------------------------------------------------------- | ---------------- |
524+
| **UI/UX Designer** | UI/UX design & prototyping | Wireframes, mockups, interactive prototypes, design systems | `musubi-browser` |
525+
| **Database Administrator** | Database operations & tuning | Performance tuning reports, backup/recovery plans, HA configurations | - |
526+
| **AI/ML Engineer** | ML model development & MLOps | Trained models, model cards, deployment pipelines, evaluation reports | - |
527+
| **Change Impact Analyzer** | Impact analysis | Impact reports, affected components, effort estimates | `musubi-change` |
528+
| **Traceability Auditor** | Traceability verification | Traceability matrices, coverage reports, gap analysis | `musubi-trace` |
467529

468530
**Total: 25 Specialized Agents**
469531

src/templates/agents/claude-code/skills/project-manager/SKILL.md

Lines changed: 32 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -28,6 +28,38 @@ You are a project manager for software development projects who handles project
2828

2929
---
3030

31+
## Multi-Skill Orchestration (v3.5.0 NEW)
32+
33+
`musubi-orchestrate` CLI で複数のスキルを協調させてタスクを実行できます:
34+
35+
```bash
36+
# タスクに最適なスキルを自動選択して実行
37+
musubi-orchestrate auto "ユーザー認証機能を設計して実装"
38+
39+
# 指定したスキルを順番に実行
40+
musubi-orchestrate sequential --skills requirements-analyst system-architect software-developer
41+
42+
# オーケストレーションパターンを指定して実行
43+
musubi-orchestrate run group-chat --skills security-auditor code-reviewer performance-optimizer
44+
45+
# 利用可能なパターンを一覧表示
46+
musubi-orchestrate list-patterns
47+
48+
# 利用可能なスキルを一覧表示
49+
musubi-orchestrate list-skills
50+
51+
# オーケストレーション状態を確認
52+
musubi-orchestrate status
53+
```
54+
55+
**オーケストレーションパターン**:
56+
- **auto**: タスク内容から最適なスキルを自動選択
57+
- **sequential**: スキルを順番に実行(依存関係を考慮)
58+
- **group-chat**: 複数スキルが協議して結論を出す
59+
- **nested**: 階層的にスキルを委譲
60+
- **swarm**: 並列実行(P-label戦略)
61+
- **human-in-loop**: 人間の承認ゲートを含むワークフロー
62+
3163
---
3264

3365
## Project Memory (Steering System)

src/templates/agents/claude-code/skills/site-reliability-engineer/SKILL.md

Lines changed: 27 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -27,6 +27,33 @@ allowed-tools: [Read, Write, Bash, Glob]
2727

2828
You are a Site Reliability Engineer specializing in production monitoring, observability, and incident response.
2929

30+
## MUSUBI GUI Dashboard (v3.5.0 NEW)
31+
32+
`musubi-gui` で SDD ワークフローとトレーサビリティを視覚化できます:
33+
34+
```bash
35+
# Web GUIダッシュボード起動
36+
musubi-gui start
37+
38+
# カスタムポートで起動
39+
musubi-gui start -p 8080
40+
41+
# 開発モード(ホットリロード)
42+
musubi-gui dev
43+
44+
# トレーサビリティマトリックスを表示
45+
musubi-gui matrix
46+
47+
# サーバーステータス確認
48+
musubi-gui status
49+
```
50+
51+
**ダッシュボード機能**:
52+
- ワークフローステータスのリアルタイム可視化
53+
- 要件 → 設計 → タスク → コード トレーサビリティマトリックス
54+
- SDD Stage 進捗トラッキング
55+
- 憲法(9条)コンプライアンスチェック
56+
3057
## Responsibilities
3158

3259
1. **SLI/SLO Definition**: Define Service Level Indicators and Objectives

src/templates/agents/claude-code/skills/steering/SKILL.md

Lines changed: 30 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -38,6 +38,36 @@ allowed-tools: [Read, Write, Bash, Glob, Grep]
3838

3939
**Purpose**: Persistent knowledge across conversations, continuous learning, agent collaboration
4040

41+
### Agent Memory CLI (v3.5.0 NEW)
42+
43+
`musubi-remember` CLI でセッション間のメモリ管理ができます:
44+
45+
```bash
46+
# セッションから学習を抽出
47+
musubi-remember extract
48+
49+
# メモリをファイルにエクスポート
50+
musubi-remember export ./project-memory.json
51+
52+
# 別プロジェクトからメモリをインポート
53+
musubi-remember import ./other-project-memory.json
54+
55+
# コンテキストウィンドウに収めるためメモリを圧縮
56+
musubi-remember condense
57+
58+
# 保存されたメモリを一覧表示
59+
musubi-remember list
60+
61+
# セッションメモリをクリア
62+
musubi-remember clear
63+
```
64+
65+
**ユースケース**:
66+
- セッション終了時の学習抽出・保存
67+
- チームメンバー間のナレッジ共有
68+
- プロジェクト間のベストプラクティス移植
69+
- 長時間セッションでのメモリ最適化
70+
4171
### 乖離検出と推奨事項
4272

4373
- コードとsteeringドキュメントの不一致検出

0 commit comments

Comments
 (0)