musubi-sdd 0.1.2 → 0.1.4

package/README.ja.md

@@ -7,8 +7,11 @@ MUSUBIは、6つの主要フレームワークのベスト機能を統合した
 ## 特徴
 
 - 🤖 **マルチエージェント対応** - 7つのAIコーディングエージェントに対応（Claude Code、GitHub Copilot、Cursor、Gemini CLI、Codex CLI、Qwen Code、Windsurf）
-- 📄 **柔軟なコマンド形式** - MarkdownとTOML形式の両方に対応（Gemini CLIはTOMLを使用）
-- 🎯 **25の専門Claude Codeスキル** - オーケストレーター、ステアリング、要件、アーキテクチャ、開発、品質、セキュリティ、インフラ（Claude Code専用）
+- 📄 **柔軟なコマンド形式** - Markdown、TOML、AGENTS.md形式に対応
+- 🎯 **25の専門エージェント（全プラットフォーム対応）** - オーケストレーター、ステアリング、要件、アーキテクチャ、開発、品質、セキュリティ、インフラ
+  - Claude Code: Skills API（25スキル）
+  - GitHub Copilot & Cursor: AGENTS.md（公式サポート）
+  - その他4エージェント: AGENTS.md（互換形式）
 - 📋 **憲法ガバナンス** - 9つの不変条項 + フェーズ-1ゲートによる品質保証
 - 📝 **EARS要件形式** - 完全なトレーサビリティを持つ明確な要件
 - 🔄 **差分仕様** - ブラウンフィールドおよびグリーンフィールドプロジェクト対応
@@ -20,20 +23,22 @@ MUSUBIは、6つの主要フレームワークのベスト機能を統合した
 
 MUSUBIは7つのAIコーディングエージェントに対応し、それぞれに最適化された設定を提供します。
 
-| エージェント | スキルAPI | コマンド形式 | コマンドファイル形式 | インストールディレクトリ |
-|-------|-----------|----------------|---------------------|----------------------|
-| **Claude Code** | ✅ (25スキル) | `/sdd-*` | Markdown | `.claude/skills/`, `.claude/commands/` |
-| **GitHub Copilot** | ❌ | `#sdd-*` | Markdown | `.github/prompts/` |
-| **Cursor IDE** | ❌ | `/sdd-*` | Markdown | `.cursor/commands/` |
-| **Gemini CLI** | ❌ | `/sdd-*` | **TOML** | `.gemini/commands/` |
-| **Codex CLI** | ❌ | `/prompts:sdd-*` | Markdown | `.codex/prompts/` |
-| **Qwen Code** | ❌ | `/sdd-*` | Markdown | `.qwen/commands/` |
-| **Windsurf IDE** | ❌ | `/sdd-*` | Markdown | `.windsurf/workflows/` |
+| エージェント | スキルAPI | 25エージェント | コマンド形式 | コマンドファイル形式 | インストールディレクトリ |
+|-------|-----------|-----------|----------------|---------------------|----------------------|
+| **Claude Code** | ✅ (25スキル) | ✅ | `/sdd-*` | Markdown | `.claude/skills/`, `.claude/commands/` |
+| **GitHub Copilot** | ❌ | ✅ (AGENTS.md) | `#sdd-*` | Markdown + AGENTS.md | `.github/prompts/`, `.github/AGENTS.md` |
+| **Cursor IDE** | ❌ | ✅ (AGENTS.md) | `/sdd-*` | Markdown + AGENTS.md | `.cursor/commands/`, `.cursor/AGENTS.md` |
+| **Gemini CLI** | ❌ | ✅ (GEMINI.md) | `/sdd-*` | TOML + GEMINI.md | `.gemini/commands/`, `GEMINI.md` |
+| **Codex CLI** | ❌ | ✅ (AGENTS.md) | `/prompts:sdd-*` | Markdown + AGENTS.md | `.codex/prompts/`, `.codex/AGENTS.md` |
+| **Qwen Code** | ❌ | ✅ (AGENTS.md) | `/sdd-*` | Markdown + AGENTS.md | `.qwen/commands/`, `.qwen/AGENTS.md` |
+| **Windsurf IDE** | ❌ | ✅ (AGENTS.md) | `/sdd-*` | Markdown + AGENTS.md | `.windsurf/workflows/`, `.windsurf/AGENTS.md` |
 
 **注意事項**：
 - スキルAPIはClaude Code専用です
-- Gemini CLIはMarkdownではなくTOML形式を使用します
-- その他のエージェントはすべてMarkdown形式のコマンド/プロンプトを使用します
+- **全7プラットフォームが25エージェントに対応**（Skills APIまたはAGENTS.md経由）
+- AGENTS.md: OpenAI仕様、GitHub Copilot & Cursorが公式サポート
+- Gemini CLIはTOML形式 + GEMINI.md統合を使用
+- その他のエージェントはMarkdown形式 + AGENTS.mdを使用
 
 ## クイックスタート
 
@@ -42,26 +47,26 @@ MUSUBIは7つのAIコーディングエージェントに対応し、それぞ
 ```bash
 # 好みのエージェント向けにMUSUBIを初期化
 
-# Claude Code（デフォルト） - 25スキル付き
+# Claude Code（デフォルト） - 25 Skills API
 npx musubi-sdd init
 npx musubi-sdd init --claude
 
-# GitHub Copilot
+# GitHub Copilot - 25エージェント（AGENTS.md、公式サポート）
 npx musubi-sdd init --copilot
 
-# Cursor IDE
+# Cursor IDE - 25エージェント（AGENTS.md、公式サポート）
 npx musubi-sdd init --cursor
 
-# Gemini CLI
+# Gemini CLI - 25エージェント（GEMINI.md統合）
 npx musubi-sdd init --gemini
 
-# Codex CLI
+# Codex CLI - 25エージェント（AGENTS.md）
 npx musubi-sdd init --codex
 
-# Qwen Code
+# Qwen Code - 25エージェント（AGENTS.md）
 npx musubi-sdd init --qwen
 
-# Windsurf IDE
+# Windsurf IDE - 25エージェント（AGENTS.md）
 npx musubi-sdd init --windsurf
 
 # またはグローバルインストール
@@ -69,14 +74,78 @@ npm install -g musubi-sdd
 musubi init --claude    # または --copilot、--cursorなど
 ```
 
+### プロジェクトタイプ
+
+初期化時、MUSUBIは**プロジェクトタイプ**の選択を求めます。これにより、利用可能なワークフローと機能が決定されます。
+
+#### Greenfield（0→1）
+- **概要**: ゼロから新しいプロジェクトを開始
+- **使用例**: 
+  - 新規アプリケーション開発
+  - 概念実証プロジェクト
+  - グリーンフィールドマイクロサービス
+- **有効化される機能**:
+  - 完全な8段階SDDワークフロー（調査 → モニタリング）
+  - `/sdd-steering` - 初期プロジェクトメモリの生成
+  - `/sdd-requirements` - ゼロから新規要件を作成
+  - `/sdd-design` - アーキテクチャ設計（C4モデル + ADR）
+  - `/sdd-tasks` - 要件をタスクに分解
+  - `/sdd-implement` - 機能実装（テストファースト）
+  - `/sdd-validate` - 憲法準拠チェック
+- **メリット**:
+  - ベストプラクティスが最初から適用されたクリーンなスタート
+  - 初日から憲法ガバナンス
+  - 要件からコードまで完全なトレーサビリティ
+
+#### Brownfield（1→n）
+- **概要**: 既存のコードベースでの作業
+- **使用例**:
+  - 既存アプリケーションへの機能追加
+  - レガシーコードのリファクタリング
+  - システムの移行/モダナイゼーション
+- **有効化される機能**:
+  - 差分仕様（ADDED/MODIFIED/REMOVED）
+  - `/sdd-change-init` - 変更提案の作成
+  - `/sdd-change-apply` - 影響分析付き変更適用
+  - `/sdd-change-archive` - 完了した変更のアーカイブ
+  - `change-impact-analyzer`スキル（Claude Code） - 自動影響検出
+  - リバースエンジニアリング: `/sdd-steering`が既存コードを分析
+- **メリット**:
+  - 影響分析による安全な段階的変更
+  - 段階的改善を行いながら既存アーキテクチャを保持
+  - 変更内容と理由の完全な監査証跡
+
+#### Both（両方）
+- **概要**: 複雑なシナリオ向けハイブリッドアプローチ
+- **使用例**:
+  - モノリス → マイクロサービス移行（ブラウンフィールド + グリーンフィールドサービス）
+  - プラットフォームモダナイゼーション（一部保持、一部再構築）
+  - 成熟度が異なるマルチコンポーネントシステム
+- **有効化される機能**:
+  - すべてのGreenfield + Brownfield機能
+  - コンポーネントごとにワークフローを選択する柔軟性
+  - 同一プロジェクト内で差分仕様とグリーンフィールド仕様を混在
+- **メリット**:
+  - 複雑な変革プロジェクトのための最大限の柔軟性
+  - すべてのコンポーネント全体で統一されたステアリング/ガバナンス
+  - モダナイゼーション全体を単一ツールで実施
+
+**選択例**:
+```
+? Project type:
+❯ Greenfield (0→1)    ← 新規プロジェクト
+  Brownfield (1→n)    ← 既存コードベース
+  Both                ← 複雑/ハイブリッドシナリオ
+```
+
 ### インストールされる内容
 
-#### Claude Code（デフォルト）
+#### Claude Code（Skills API）
 
 ```
 your-project/
 ├── .claude/
-│   ├── skills/              # 25の専門スキル（Claude Code専用）
+│   ├── skills/              # 25 Skills API（Claude Code専用機能）
 │   │   ├── orchestrator/
 │   │   ├── steering/
 │   │   ├── requirements-analyst/
@@ -100,8 +169,10 @@ your-project/
 ```
 your-project/
 ├── .github/prompts/         # GitHub Copilot用（#sdd-*、Markdown）
+│   ├── AGENTS.md             # 25エージェント定義（公式サポート）
 │   または
 ├── .cursor/commands/        # Cursor用（/sdd-*、Markdown）
+│   ├── AGENTS.md             # 25エージェント定義（公式サポート）
 │   または
 ├── .gemini/commands/        # Gemini CLI用（/sdd-*、TOML）
 │   │   ├── sdd-steering.toml
@@ -109,21 +180,26 @@ your-project/
 │   │   └── ... (6つのTOMLファイル)
 │   または
 ├── .codex/prompts/          # Codex CLI用（/prompts:sdd-*、Markdown）
+│   ├── AGENTS.md             # 25エージェント定義
 │   または
 ├── .qwen/commands/          # Qwen Code用（/sdd-*、Markdown）
+│   ├── AGENTS.md             # 25エージェント定義
 │   または
 ├── .windsurf/workflows/     # Windsurf用（/sdd-*、Markdown）
+│   ├── AGENTS.md             # 25エージェント定義
 │
-├── AGENTS.md（またはGEMINI.md/QWEN.md）  # エージェント固有のガイド
+├── GEMINI.md（ルート、Gemini用）  # 25エージェントを既存ファイルに統合
 ├── steering/                # プロジェクトメモリ（全て共通）
 ├── templates/               # ドキュメントテンプレート（全て共通）
 └── storage/                 # 仕様、変更、機能（全て共通）
 ```
 
 **主な違い**：
-- Claude Codeは25スキル + コマンドを取得（Markdown）
-- Gemini CLIはコマンドにTOML形式を使用（ユニーク）
-- その他のエージェントはコマンド/プロンプトにMarkdownを使用
+- **Claude Code**: 25 Skills API（専用） + コマンド（Markdown）
+- **GitHub Copilot & Cursor**: AGENTS.md（公式サポート） + コマンド（Markdown）
+- **Gemini CLI**: GEMINI.md統合（25エージェント） + TOMLコマンド（ユニーク）
+- **その他**: AGENTS.md（互換） + Markdownコマンド
+- **全プラットフォーム**: 同じ25エージェント、異なる実装形式
 
 ## 使用方法
 
@@ -275,7 +351,12 @@ MUSUBIプロジェクトの現在の状態を表示します。
 /prompts:sdd-validate authentication
 ```
 
-## 25スキル概要
+## 25エージェント概要（全プラットフォーム対応）
+
+**全7プラットフォームで利用可能**：
+- **Claude Code**: Skills API（自動起動）
+- **GitHub Copilot & Cursor**: AGENTS.md（公式サポート、`@エージェント名`で参照）
+- **Gemini、Windsurf、Codex、Qwen**: AGENTS.md（互換形式、自然言語で参照）
 
 ### オーケストレーションと管理（3）
 - **orchestrator** - マルチスキルワークフローのマスターコーディネーター

package/README.md

@@ -7,8 +7,11 @@ MUSUBI is a comprehensive SDD (Specification Driven Development) framework that
 ## Features
 
 - 🤖 **Multi-Agent Support** - Works with 7 AI coding agents (Claude Code, GitHub Copilot, Cursor, Gemini CLI, Codex CLI, Qwen Code, Windsurf)
-- 📄 **Flexible Command Formats** - Supports both Markdown and TOML formats (Gemini CLI uses TOML)
-- 🎯 **25 Specialized Claude Code Skills** - Orchestrator, Steering, Requirements, Architecture, Development, Quality, Security, Infrastructure (Claude Code exclusive)
+- 📄 **Flexible Command Formats** - Supports Markdown, TOML, and AGENTS.md formats
+- 🎯 **25 Specialized Agents (All Platforms)** - Orchestrator, Steering, Requirements, Architecture, Development, Quality, Security, Infrastructure
+  - Claude Code: Skills API (25 skills)
+  - GitHub Copilot & Cursor: AGENTS.md (official support)
+  - Other 4 agents: AGENTS.md (compatible format)
 - 📋 **Constitutional Governance** - 9 immutable articles + Phase -1 Gates for quality enforcement
 - 📝 **EARS Requirements Format** - Unambiguous requirements with complete traceability
 - 🔄 **Delta Specifications** - Brownfield and greenfield project support
@@ -20,20 +23,22 @@ MUSUBI is a comprehensive SDD (Specification Driven Development) framework that
 
 MUSUBI supports 7 AI coding agents, each with tailored configurations:
 
-| Agent | Skills API | Command Format | Command File Format | Installation Directory |
-|-------|-----------|----------------|---------------------|----------------------|
-| **Claude Code** | ✅ (25 skills) | `/sdd-*` | Markdown | `.claude/skills/`, `.claude/commands/` |
-| **GitHub Copilot** | ❌ | `#sdd-*` | Markdown | `.github/prompts/` |
-| **Cursor IDE** | ❌ | `/sdd-*` | Markdown | `.cursor/commands/` |
-| **Gemini CLI** | ❌ | `/sdd-*` | **TOML** | `.gemini/commands/` |
-| **Codex CLI** | ❌ | `/prompts:sdd-*` | Markdown | `.codex/prompts/` |
-| **Qwen Code** | ❌ | `/sdd-*` | Markdown | `.qwen/commands/` |
-| **Windsurf IDE** | ❌ | `/sdd-*` | Markdown | `.windsurf/workflows/` |
+| Agent | Skills API | 25 Agents | Command Format | Command File Format | Installation Directory |
+|-------|-----------|-----------|----------------|---------------------|----------------------|
+| **Claude Code** | ✅ (25 skills) | ✅ | `/sdd-*` | Markdown | `.claude/skills/`, `.claude/commands/` |
+| **GitHub Copilot** | ❌ | ✅ (AGENTS.md) | `#sdd-*` | Markdown + AGENTS.md | `.github/prompts/`, `.github/AGENTS.md` |
+| **Cursor IDE** | ❌ | ✅ (AGENTS.md) | `/sdd-*` | Markdown + AGENTS.md | `.cursor/commands/`, `.cursor/AGENTS.md` |
+| **Gemini CLI** | ❌ | ✅ (GEMINI.md) | `/sdd-*` | TOML + GEMINI.md | `.gemini/commands/`, `GEMINI.md` |
+| **Codex CLI** | ❌ | ✅ (AGENTS.md) | `/prompts:sdd-*` | Markdown + AGENTS.md | `.codex/prompts/`, `.codex/AGENTS.md` |
+| **Qwen Code** | ❌ | ✅ (AGENTS.md) | `/sdd-*` | Markdown + AGENTS.md | `.qwen/commands/`, `.qwen/AGENTS.md` |
+| **Windsurf IDE** | ❌ | ✅ (AGENTS.md) | `/sdd-*` | Markdown + AGENTS.md | `.windsurf/workflows/`, `.windsurf/AGENTS.md` |
 
 **Notes**:
 - Skills API is exclusive to Claude Code
-- Gemini CLI uses TOML format instead of Markdown
-- All other agents use Markdown format for commands/prompts
+- **All 7 platforms now support 25 agents** via Skills API (Claude Code) or AGENTS.md (others)
+- AGENTS.md: OpenAI specification, officially supported by GitHub Copilot & Cursor
+- Gemini CLI uses TOML format + GEMINI.md integration
+- All other agents use Markdown format + AGENTS.md
 
 ## Quick Start
 
@@ -42,26 +47,26 @@ MUSUBI supports 7 AI coding agents, each with tailored configurations:
 ```bash
 # Initialize MUSUBI for your preferred agent
 
-# Claude Code (default) - with 25 skills
+# Claude Code (default) - 25 Skills API
 npx musubi-sdd init
 npx musubi-sdd init --claude
 
-# GitHub Copilot
+# GitHub Copilot - 25 agents (AGENTS.md, official support)
 npx musubi-sdd init --copilot
 
-# Cursor IDE
+# Cursor IDE - 25 agents (AGENTS.md, official support)
 npx musubi-sdd init --cursor
 
-# Gemini CLI
+# Gemini CLI - 25 agents (GEMINI.md integration)
 npx musubi-sdd init --gemini
 
-# Codex CLI
+# Codex CLI - 25 agents (AGENTS.md)
 npx musubi-sdd init --codex
 
-# Qwen Code
+# Qwen Code - 25 agents (AGENTS.md)
 npx musubi-sdd init --qwen
 
-# Windsurf IDE
+# Windsurf IDE - 25 agents (AGENTS.md)
 npx musubi-sdd init --windsurf
 
 # Or install globally
@@ -69,14 +74,78 @@ npm install -g musubi-sdd
 musubi init --claude    # or --copilot, --cursor, etc.
 ```
 
+### Project Types
+
+During initialization, MUSUBI asks you to select a **Project Type**. This determines the workflow and features available:
+
+#### Greenfield (0→1)
+- **What it is**: Starting a new project from scratch
+- **Use cases**: 
+  - New application development
+  - Proof-of-concept projects
+  - Greenfield microservices
+- **Features enabled**:
+  - Full 8-stage SDD workflow (Research → Monitoring)
+  - `/sdd-steering` - Generate initial project memory
+  - `/sdd-requirements` - Create new requirements from scratch
+  - `/sdd-design` - Design architecture (C4 model + ADR)
+  - `/sdd-tasks` - Break requirements into tasks
+  - `/sdd-implement` - Implement features (test-first)
+  - `/sdd-validate` - Constitutional compliance checks
+- **Benefits**:
+  - Clean start with best practices enforced
+  - Constitutional governance from day one
+  - Complete traceability from requirements to code
+
+#### Brownfield (1→n)
+- **What it is**: Working with existing codebases
+- **Use cases**:
+  - Adding features to existing applications
+  - Refactoring legacy code
+  - Migrating/modernizing systems
+- **Features enabled**:
+  - Delta Specifications (ADDED/MODIFIED/REMOVED)
+  - `/sdd-change-init` - Create change proposal
+  - `/sdd-change-apply` - Apply changes with impact analysis
+  - `/sdd-change-archive` - Archive completed changes
+  - `change-impact-analyzer` skill (Claude Code) - Automatic impact detection
+  - Reverse engineering: `/sdd-steering` analyzes existing code
+- **Benefits**:
+  - Safe incremental changes with impact analysis
+  - Preserves existing architecture while improving incrementally
+  - Full audit trail of what changed and why
+
+#### Both
+- **What it is**: Hybrid approach for complex scenarios
+- **Use cases**:
+  - Monolith → Microservices migration (brownfield + greenfield services)
+  - Platform modernization (keep some, rebuild others)
+  - Multi-component systems with mixed maturity
+- **Features enabled**:
+  - All Greenfield + Brownfield features
+  - Flexibility to choose workflow per component
+  - Mixed delta specs and greenfield specs in same project
+- **Benefits**:
+  - Maximum flexibility for complex transformation projects
+  - Unified steering/governance across all components
+  - Single tool for entire modernization journey
+
+**Example Selection**:
+```
+? Project type:
+❯ Greenfield (0→1)    ← New projects
+  Brownfield (1→n)    ← Existing codebases
+  Both                ← Complex/hybrid scenarios
+```
+
 ### What Gets Installed
 
-#### Claude Code (default)
+#### Claude Code (Skills API)
 
 ```
 your-project/
 ├── .claude/
-│   ├── skills/              # 25 specialized skills (Claude Code exclusive)
+│   ├── skills/              # 25 Skills API (Claude Code exclusive feature)
 │   │   ├── orchestrator/
 │   │   ├── steering/
 │   │   ├── requirements-analyst/
@@ -100,8 +169,10 @@ your-project/
 ```
 your-project/
 ├── .github/prompts/         # For GitHub Copilot (#sdd-*, Markdown)
+│   ├── AGENTS.md             # 25 agents definition (official support)
 │   OR
 ├── .cursor/commands/        # For Cursor (/sdd-*, Markdown)
+│   ├── AGENTS.md             # 25 agents definition (official support)
 │   OR
 ├── .gemini/commands/        # For Gemini CLI (/sdd-*, TOML)
 │   │   ├── sdd-steering.toml
@@ -109,21 +180,26 @@ your-project/
 │   │   └── ... (6 TOML files)
 │   OR
 ├── .codex/prompts/          # For Codex CLI (/prompts:sdd-*, Markdown)
+│   ├── AGENTS.md             # 25 agents definition
 │   OR
 ├── .qwen/commands/          # For Qwen Code (/sdd-*, Markdown)
+│   ├── AGENTS.md             # 25 agents definition
 │   OR
 ├── .windsurf/workflows/     # For Windsurf (/sdd-*, Markdown)
+│   ├── AGENTS.md             # 25 agents definition
 │
-├── AGENTS.md (or GEMINI.md/QWEN.md)  # Agent-specific guide
+├── GEMINI.md (root, for Gemini)  # 25 agents integrated into existing file
 ├── steering/                # Project memory (same for all)
 ├── templates/               # Document templates (same for all)
 └── storage/                 # Specs, changes, features (same for all)
 ```
 
 **Key Differences**:
-- Claude Code gets 25 skills + commands (Markdown)
-- Gemini CLI uses TOML format for commands (unique)
-- Other agents use Markdown for commands/prompts
+- **Claude Code**: 25 Skills API (exclusive) + commands (Markdown)
+- **GitHub Copilot & Cursor**: AGENTS.md (official support) + commands (Markdown)
+- **Gemini CLI**: GEMINI.md integration (25 agents) + TOML commands (unique)
+- **Others**: AGENTS.md (compatible) + Markdown commands
+- **All platforms**: Same 25 agents, different implementation formats
 
 ## Usage
 
@@ -275,7 +351,12 @@ For comprehensive validation, use your agent's `/sdd-validate` (or equivalent) c
 /prompts:sdd-validate authentication
 ```
 
-## 25 Skills Overview
+## 25 Agents Overview (All Platforms)
+
+**Available on all 7 platforms** via:
+- **Claude Code**: Skills API (automatic invocation)
+- **GitHub Copilot & Cursor**: AGENTS.md (official support, reference via `@agent-name`)
+- **Gemini, Windsurf, Codex, Qwen**: AGENTS.md (compatible format, natural language reference)
 
 ### Orchestration & Management (3)
 - **orchestrator** - Master coordinator for multi-skill workflows

package/bin/musubi-init.js

@@ -86,7 +86,7 @@ async function main(agent, agentKey) {
   ];
 
   // Skills selection is only for Claude Code (Skills API exclusive)
-  if (agent.features.hasSkills) {
+  if (agentKey === 'claude-code' && agent.layout.skillsDir) {
     prompts.push({
       type: 'checkbox',
       name: 'skills',
@@ -149,8 +149,8 @@ async function main(agent, agentKey) {
     console.log(chalk.gray(`  Created ${dir}/`));
   }
 
-  // Install skills (Claude Code only)
-  if (agent.features.hasSkills && answers.skills) {
+  // Install skills (Claude Code only - Skills API)
+  if (agentKey === 'claude-code' && agent.layout.skillsDir && answers.skills) {
     const skillGroups = {
       core: ['orchestrator', 'steering', 'constitution-enforcer'],
       requirements: ['requirements-analyst', 'project-manager', 'change-impact-analyzer'],
@@ -181,6 +181,12 @@ async function main(agent, agentKey) {
     console.log(chalk.green(`  Installed ${commandType}`));
   }
 
+  // Install AGENTS.md (all platforms get 25 agent definitions)
+  if (agent.layout.agentsFile) {
+    await copyAgentsFile(agent);
+    console.log(chalk.green('  Installed 25 agent definitions (AGENTS.md)'));
+  }
+
   // Generate steering context
   if (answers.createSteering) {
     await generateSteering(answers);
@@ -215,6 +221,11 @@ async function main(agent, agentKey) {
 }
 
 async function copySkill(skillName, agent) {
+  // Only Claude Code has skillsDir (Skills API)
+  if (!agent.layout.skillsDir) {
+    return; // Skip for agents without Skills API support
+  }
+  
   const srcDir = path.join(AGENTS_TEMPLATE_DIR, 'claude-code', 'skills', skillName);
   const destDir = path.join(agent.layout.skillsDir, skillName);
   await fs.copy(srcDir, destDir);
@@ -233,6 +244,35 @@ async function copyCommands(agent, agentKey) {
   }
 }
 
+async function copyAgentsFile(agent) {
+  const sharedAgentsFile = path.join(AGENTS_TEMPLATE_DIR, 'shared', 'AGENTS.md');
+  const destFile = agent.layout.agentsFile;
+
+  // For Gemini CLI, AGENTS.md is embedded in GEMINI.md
+  if (destFile === 'GEMINI.md') {
+    // Read shared AGENTS.md
+    const agentsContent = await fs.readFile(sharedAgentsFile, 'utf8');
+    
+    // Read existing GEMINI.md template if exists
+    const geminiTemplate = path.join(AGENTS_TEMPLATE_DIR, 'gemini-cli', 'GEMINI.md');
+    let geminiContent = '';
+    if (fs.existsSync(geminiTemplate)) {
+      geminiContent = await fs.readFile(geminiTemplate, 'utf8');
+    } else {
+      geminiContent = `# Gemini CLI - MUSUBI Configuration\n\n` +
+                      `This file configures Gemini CLI for MUSUBI SDD.\n\n` +
+                      `---\n\n`;
+    }
+    
+    // Append AGENTS.md content
+    geminiContent += agentsContent;
+    await fs.writeFile(destFile, geminiContent);
+  } else {
+    // For other platforms, copy AGENTS.md as-is
+    await fs.copy(sharedAgentsFile, destFile);
+  }
+}
+
 async function generateSteering(answers) {
   const steeringTemplates = path.join(SHARED_TEMPLATE_DIR, 'steering');
 

package/bin/musubi.js

@@ -39,7 +39,7 @@ aliasFlags.forEach(flag => {
   initCommand.option(`--${flag}`, `Select agent: ${flag}`);
 });
 
-initCommand.action((options) => {
+initCommand.action(async (options) => {
   const agentKey = detectAgentFromFlags(options);
   const agent = getAgentDefinition(agentKey);
 
@@ -47,7 +47,8 @@ initCommand.action((options) => {
   console.log(chalk.gray(`Description: ${agent.description}\n`));
 
   // Delegate to musubi-init.js with agent info
-  require('./musubi-init.js')(agent, agentKey);
+  const initMain = require('./musubi-init.js');
+  await initMain(agent, agentKey);
 });
 
 // ============================================================================

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "musubi-sdd",
-  "version": "0.1.2",
-  "description": "Ultimate Specification Driven Development Tool with 25 Claude Code Skills",
+  "version": "0.1.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)",
   "main": "src/index.js",
   "bin": {
     "musubi-sdd": "bin/musubi.js",