🚀 Project Setup and Miyabi Integration

Version: 2.0.0 Last Updated: 2025-11-22 Priority: ⭐⭐⭐ (P2 Level) Purpose: プロジェクト初期化、Cargo Workspace設定、Miyabi統合

---

📋 概要

新規プロジェクト作成からMiyabiフレームワーク統合まで、 完全なプロジェクトセットアップを提供します。

---

🎯 P0: 呼び出しトリガー

トリガー	例
新規プロジェクト	"create a new project"
Miyabi統合	"integrate Miyabi into this project"
Rust Workspace	"set up a new Rust workspace"
マイクロサービス	"starting new microservices"

---

🔧 P1: セットアップモード

3つのモード

モード	用途	所要時間
New Project	ゼロから新規	10-15分
Add Miyabi	既存に追加	5-10分
Microservice	新規crate追加	3-5分

---

🚀 P2: セットアップパターン

Pattern 1: 新規プロジェクト

# Step 1: ディレクトリ作成
mkdir my-project && cd my-project

# Step 2: Cargo Workspace初期化
cat > Cargo.toml << 'EOF'
[workspace]
members = ["crates/*"]
resolver = "2"

[workspace.package]
version = "0.1.0"
edition = "2021"
authors = ["Your Name <email@example.com>"]
license = "MIT"

[workspace.dependencies]
tokio = { version = "1", features = ["full"] }
serde = { version = "1", features = ["derive"] }
serde_json = "1"
thiserror = "1"
anyhow = "1"
tracing = "0.1"
EOF

# Step 3: 基本crate作成
mkdir -p crates/my-core
cargo init crates/my-core --lib

# Step 4: Git初期化
git init

Pattern 2: Miyabi統合

# Step 1: .claudeディレクトリ作成
mkdir -p .claude/{agents,context,commands,Skills}

# Step 2: CLAUDE.md作成
cat > CLAUDE.md << 'EOF'
# Project Name

## MCP First Approach
...
EOF

# Step 3: GitHub統合
# - Labels設定
# - Workflow追加
# - Issue templates

# Step 4: 環境変数設定
cat > .env.example << 'EOF'
GITHUB_TOKEN=
ANTHROPIC_API_KEY=
EOF

Pattern 3: 新規Microservice

# Step 1: crate作成
cargo init crates/my-service --lib

# Step 2: Cargo.toml設定
cat > crates/my-service/Cargo.toml << 'EOF'
[package]
name = "my-service"
version.workspace = true
edition.workspace = true

[dependencies]
tokio = { workspace = true }
serde = { workspace = true }
EOF

# Step 3: 基本構造
mkdir -p crates/my-service/src

---

⚡ P3: ディレクトリ構造

推奨構造

my-project/
├── Cargo.toml           # Workspace root
├── CLAUDE.md            # AI指示書
├── README.md            # プロジェクト説明
├── .env.example         # 環境変数例
├── .gitignore
├── crates/
│   ├── my-core/         # コアライブラリ
│   ├── my-cli/          # CLIバイナリ
│   └── my-api/          # APIサーバー
├── .claude/
│   ├── agents/          # Agent定義
│   ├── context/         # コンテキスト
│   ├── commands/        # カスタムコマンド
│   └── Skills/          # スキル定義
├── .github/
│   ├── workflows/       # CI/CD
│   ├── ISSUE_TEMPLATE/  # Issueテンプレート
│   └── labels.yml       # ラベル定義
└── docs/
    └── README.md        # ドキュメント

---

📊 チェックリスト

新規プロジェクト

• Cargo.toml (workspace)
• 基本crate作成
• Git初期化
• .gitignore
• README.md
• CLAUDE.md

Miyabi統合

• .claudeディレクトリ
• Agent定義
• コンテキスト
• カスタムコマンド
• GitHub Labels
• CI/CD Workflow

環境設定

• .env.example
• 環境変数ドキュメント
• 開発環境手順

---

✅ 成功基準

チェック項目	基準
cargo build	成功
cargo test	成功
Git	初期コミット完了
ドキュメント	README存在

---

🔗 関連Skills

• Rust Development: ビルド確認
• Git Workflow: 初期コミット
• Documentation: README作成