---
description: 新しいMiyabiプロジェクト作成
---

# Miyabiプロジェクト作成

新しいMiyabiプロジェクトを作成します。GitHub連携、Agent設定、Claude Code統合を含む完全なセットアップを実行します。

## MCPツール

### `miyabi__init`
新しいMiyabiプロジェクトを作成

**パラメータ**:
- `projectName`: プロジェクト名（英数字、ハイフン、アンダースコアのみ）
- `private`: プライベートリポジトリとして作成（デフォルト: false）
- `skipInstall`: npm installをスキップ（デフォルト: false）

**使用例**:
```
パブリックプロジェクト作成:
miyabi__init({ projectName: "my-awesome-app" })

プライベートプロジェクト作成:
miyabi__init({ projectName: "my-secret-project", private: true })

npm installスキップ:
miyabi__init({ projectName: "quick-setup", skipInstall: true })
```

## 自動セットアップ内容

`miyabi__init` を実行すると、以下が自動的に実行されます:

### 1. GitHub認証
- Device Flow OAuthで安全に認証
- 必要な権限: `repo`, `workflow`, `admin:org`

### 2. GitHubリポジトリ作成
- 指定した名前でリポジトリ作成
- README.md自動生成
- .gitignore (Node.js用) 追加
- LICENSE (MIT) 追加

### 3. 組織設計原則53ラベル体系
以下のラベルカテゴリを自動作成:

| カテゴリ | ラベル数 | 例 |
|---------|---------|---|
| 🔴 緊急度 | 4 | 緊急度-高, 緊急度-中, 緊急度-低, 緊急度-即時 |
| 🔵 規模 | 4 | 規模-小, 規模-中, 規模-大, 規模-特大 |
| 🟢 種別 | 8 | type:feature, type:bug, type:refactor, type:docs |
| 🟡 状態 | 6 | status:backlog, status:in-progress, status:review |
| 🟣 責任 | 7 | owner:tech-lead, owner:po, owner:ciso |
| 🟠 エスカレーション | 5 | escalation:tech-lead, escalation:ciso |
| その他 | 19 | good first issue, help wanted, dependencies |

### 4. GitHub Actions (26ワークフロー)
以下のCI/CDワークフローを自動展開:

**基本ワークフロー**:
- `ci.yml` - CI（TypeScript, ESLint, Vitest）
- `cd.yml` - CD（Firebase自動デプロイ）
- `test.yml` - テスト実行
- `typecheck.yml` - 型チェック

**Agent自動実行**:
- `coordinator-agent.yml` - CoordinatorAgent起動
- `codegen-agent.yml` - CodeGenAgent起動
- `review-agent.yml` - ReviewAgent起動
- `pr-agent.yml` - PRAgent起動

**セキュリティ**:
- `security-scan.yml` - Dependabot, CodeQL
- `dependency-review.yml` - 依存関係レビュー

### 5. Projects V2カンバンボード
自動的に以下のカラムを持つボードを作成:

```
📋 Backlog → 🚧 In Progress → 👀 Review → ✅ Done
```

### 6. Claude Code統合
`.claude/` ディレクトリを自動生成:

```
.claude/
├── mcp.json                # MCPサーバー設定
├── commands/
│   ├── miyabi-agent.md     # /miyabi-agent
│   ├── miyabi-status.md    # /miyabi-status
│   └── miyabi-init.md      # /miyabi-init
├── hooks/
│   └── format.sh           # 自動フォーマット
└── settings.json           # Claude設定
```

### 7. ローカルクローン
作成したリポジトリをローカルに自動クローン:

```bash
git clone https://github.com/user/my-awesome-app.git
cd my-awesome-app
```

### 8. 依存関係インストール
`npm install` を自動実行（`--skip-install` を指定しない限り）

### 9. Welcome Issue作成
プロジェクト開始ガイド付きIssue #1を自動作成

## コマンドライン実行

```bash
# パブリックプロジェクト作成
npx miyabi init my-awesome-app

# プライベートプロジェクト作成
npx miyabi init my-secret-project --private

# npm installスキップ
npx miyabi init quick-setup --skip-install
```

## 実行例

```bash
$ npx miyabi init my-awesome-app

✨ Miyabi - 一つのコマンドで全てが完結

🔐 GitHub認証中...
   Device Code: XXXX-XXXX
   https://github.com/login/device でコードを入力してください

✅ GitHub認証成功

🚀 リポジトリ作成中...
   Repository: github.com/user/my-awesome-app

✅ リポジトリ作成完了

🏷️  組織設計ラベル体系セットアップ中...
   作成: 53ラベル

✅ ラベルセットアップ完了

⚙️  GitHub Actionsワークフロー展開中...
   展開: 26ワークフロー

✅ ワークフロー展開完了

📊 Projects V2ボード作成中...

✅ プロジェクトボード作成完了

📁 ローカルクローン中...
   Location: ./my-awesome-app

✅ クローン完了

📦 依存関係インストール中...

✅ インストール完了

🎉 プロジェクト作成成功！

次のステップ:
  cd my-awesome-app
  code .               # VS Code / Claude Code で開く
  npx miyabi status    # ステータス確認
  npx miyabi auto      # 全自動モード起動
```

## トラブルシューティング

### GitHub認証エラー
```bash
❌ Error: GitHub authentication failed

解決策:
1. https://github.com/login/device でコードを正しく入力
2. 必要な権限（repo, workflow）を付与
3. 認証画面が表示されない場合は、ブラウザのキャッシュをクリア
```

### リポジトリ名重複エラー
```bash
❌ Error: Repository already exists

解決策:
1. 異なるプロジェクト名を使用
2. GitHub上で既存リポジトリを削除してから再実行
```

### npm installエラー
```bash
❌ Error: npm install failed

解決策:
1. Node.js v18+ がインストールされているか確認
2. インターネット接続を確認
3. --skip-install オプションを使用して後で手動インストール
```

---

💡 **ヒント**: MCPツールを使うと、Claude Codeが対話的にパラメータを聞いて実行します。