🚀 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作成