@sk8metal/michi-cli 0.0.7 → 0.0.9

package/docs/getting-started/{new-project-setup.md → new-repository-setup.md}

@@ -1,8 +1,8 @@
-# 新規プロジェクトセットアップガイド
+# 新規リポジトリセットアップガイド
 
 > **凡例について**: `<feature>` などの記号の意味は [README.md#凡例の記号説明](../README.md#凡例の記号説明) を参照してください。
 
-別のリポジトリで新しいプロジェクトを開始する手順です。
+新規リポジトリを作成してMichiを使い始める手順です。
 
 ## クイックスタート
 
@@ -29,32 +29,119 @@ npm run create-project -- \
 
 スクリプトが自動的に：
 1. GitHub リポジトリ作成
-2. cc-sdd 導入
-3. `.kiro/project.json` 作成
-4. 共通ファイルコピー
-5. `.env` テンプレート作成
-6. npm install
-7. 初期コミット・プッシュ
+2. `projects/{project-id}/`ディレクトリ作成
+3. cc-sdd 導入
+4. `projects/{project-id}/.kiro/project.json` 作成
+5. 共通ファイルコピー
+6. `projects/{project-id}/.env` テンプレート作成
+7. npm install（リポジトリルートで実行）
+8. 初期コミット（`main`ブランチ作成）
 
-### 方法2: 既存プロジェクトにMichiワークフローを追加（推奨 - 既存リポジトリ）
+**注意**: プッシュは手動で実行する必要があります。スクリプト完了後、以下のコマンドを実行してください：
 
-既存のリポジトリにAI開発フローを導入：
+```bash
+# Jujutsu (jj) を使用する場合
+jj git push --bookmark main --allow-new
+
+# Git を使用する場合
+git push -u origin main
+```
+
+**重要**: すべてのプロジェクトは`projects/{project-id}/`配下に配置されます。
+
+### 方法2: 既存プロジェクトにMichi共通ルール・コマンドを追加（推奨 - 既存リポジトリ）
+
+既存のリポジトリにMichiを導入する推奨ワークフロー：
+
+#### cc-sdd準拠の3ステップ
+
+```bash
+# Step 1: cc-sddで標準ファイル生成
+npx cc-sdd@latest --cursor --lang ja
+
+# Step 2: Michi固有ファイルを追加
+npx @sk8metal/michi-cli setup-existing --cursor --lang ja
+# または npm run michi:setup:cursor
+
+# Step 3: 環境設定
+npm run setup:interactive
+```
+
+#### IDE別実行例
+
+**Cursor IDE（推奨）**:
+
+```bash
+# 既存プロジェクトのディレクトリに移動
+cd /path/to/existing-repo
+
+# Step 1: cc-sdd導入
+npx cc-sdd@latest --cursor --lang ja
+
+# Step 2: Michi固有ファイル追加
+npx @sk8metal/michi-cli setup-existing --cursor --lang ja
+# または npm run michi:setup:cursor
+
+# Step 3: 環境設定
+npm run setup:interactive
+```
+
+**Claude Code**:
+
+```bash
+# 既存プロジェクトのディレクトリに移動
+cd /path/to/existing-repo
+
+# Step 1: cc-sdd導入
+npx cc-sdd@latest --claude --lang ja
+
+# Step 2: Michi固有ファイル追加
+npx @sk8metal/michi-cli setup-existing --claude --lang ja
+# または npm run michi:setup:claude
+
+# Step 3: 環境設定
+npm run setup:interactive
+```
+
+**その他のIDE（Gemini, Codex, Windsurf）**:
 
 ```bash
 # 既存プロジェクトのディレクトリに移動
 cd /path/to/existing-repo
 
-# Michiのセットアップスクリプトを実行（対話式）
-bash /path/to/michi/scripts/setup-existing.sh
+# Step 1: cc-sdd導入（IDE別）
+npx cc-sdd@latest --gemini --lang ja     # Gemini CLI
+npx cc-sdd@next --codex --lang ja        # Codex CLI
+npx cc-sdd@next --windsurf --lang ja     # Windsurf IDE
+
+# Step 2: Michi固有ファイル追加（Cursor互換モード）
+npx @sk8metal/michi-cli setup-existing --cursor --lang ja
+
+# Step 3: 環境設定
+npm run setup:interactive
 ```
 
-対話式でプロジェクト情報を入力すると、自動的に：
-1. ✅ cc-sdd 導入確認・インストール
-2. ✅ `.kiro/project.json` 作成
-3. ✅ Michiから共通ファイルコピー（ルール、コマンド、テンプレート）
-4. ✅ `.env` テンプレート作成
-5. ✅ README.md と .gitignore 更新
-6. ✅ CLIツールのセットアップ案内
+#### 自動的に追加されるもの
+
+このワークフローにより以下が自動的に追加されます：
+
+1. **cc-sdd導入（Step 1）**:
+   - `.kiro/settings/` - テンプレート設定
+   - `.cursor/commands/kiro/` または `.claude/commands/kiro/` - 11のスラッシュコマンド
+   - `AGENTS.md` または `CLAUDE.md` - プロジェクト設定
+
+2. **Michi固有ファイル追加（Step 2）**:
+   - 共通ルール（`.cursor/rules/` または `.claude/rules/`）
+   - Michi専用コマンド（`.cursor/commands/michi/` または `.claude/commands/michi/`）
+   - Steeringテンプレート（`.kiro/steering/`）
+   - Specテンプレート（`.kiro/settings/templates/`）
+   - プロジェクトメタデータ（`.kiro/project.json`）
+   - 環境変数テンプレート（`.env`）
+
+3. **環境設定（Step 3）**:
+   - 対話的に `project.json` と `.env` を設定
+
+**重要**: すべてのプロジェクトは`projects/{project-id}/`配下に配置されます。
 
 **完了後**:
 ```bash
@@ -159,7 +246,7 @@ npx cc-sdd@latest --cursor --lang ja --yes
 - `projectId: 'michi'` → `['project:michi']`（サービスラベルなし）
 - `projectId: '20240115-payment-api'` → `['project:20240115-payment-api', 'service:payment']`
 - `projectId: 'michi-service'` → `['project:michi-service']`（サービスラベルがプロジェクトラベルと同一のため追加しない）
-### Step 4: Michiから共通設定をコピー
+### Step 5: Michiから共通設定をコピー
 
 Michiリポジトリから必要なファイルをコピー：
 
@@ -185,9 +272,40 @@ cp $MICHI_PATH/.kiro/steering/*.md .kiro/steering/
 cp $MICHI_PATH/tsconfig.json .
 ```
 
-### Step 5: 環境変数設定
+### Step 6: 環境変数設定
+
+**重要**: `.env`ファイルは`projects/{project-id}/`配下に作成します。
+
+#### 方法A: 対話的設定ツールを使用（推奨）
+
+対話的設定ツールを使用すると、`project.json`と`.env`を一度に設定できます：
+
+```bash
+# リポジトリルートから実行
+cd /path/to/repository
+npm run setup:interactive
+
+# または直接実行
+npx tsx /path/to/michi/scripts/setup-interactive.ts
+```
+
+**機能**:
+- `project.json`と`.env`を対話的に設定
+- 既存の設定値を読み込んで編集可能
+- 複数プロジェクトが存在する場合、プロジェクトを選択可能
+- 必須項目のバリデーション
+- 新規プロジェクトの場合、`projects/{project-id}/`配下に自動作成
+
+詳細は [セットアップガイド](./setup.md#対話的設定ツール) を参照してください。
+
+#### 方法B: 手動で.envファイルを作成
+
+対話的設定ツールを使用しない場合は、手動で`.env`ファイルを作成します：
 
 ```bash
+# プロジェクトディレクトリに移動
+cd projects/20240115-payment-api
+
 # .env テンプレート作成
 cat > .env << 'EOF'
 # Atlassian設定（MCP + REST API共通）
@@ -213,17 +331,26 @@ EOF
 # .env ファイルを編集してください
 ```
 
-### Step 6: 依存関係インストール
+### Step 7: 依存関係インストール
+
+**重要**: `package.json`と`tsconfig.json`はリポジトリルートに配置します。`npm install`はリポジトリルートで実行してください。
 
 ```bash
+# リポジトリルートに移動
+cd /path/to/repository
+
+# 依存関係をインストール
 npm install
 ```
 
-### Step 7: 動作確認
+### Step 8: 動作確認
 
 #### Jujutsu (jj) を使用する場合
 
 ```bash
+# プロジェクトディレクトリに移動
+cd projects/20240115-payment-api
+
 # プロジェクト情報を表示
 cat .kiro/project.json
 
@@ -251,7 +378,7 @@ git branch -M main
 git remote add origin https://github.com/your-org/20240115-payment-api.git
 ```
 
-### Step 8: 初期コミット
+### Step 9: 初期コミット
 
 #### Jujutsu (jj) を使用する場合
 
@@ -298,40 +425,40 @@ git push -u origin main
 /kiro:spec-requirements <feature>
 jj commit -m "docs: 要件定義追加"
 jj git push
-npx @michi/cli phase:run <feature> requirements
+npx @sk8metal/michi-cli phase:run <feature> requirements
 
 # 具体例
 /kiro:spec-init ユーザー認証機能
 /kiro:spec-requirements user-auth
 jj commit -m "docs: 要件定義追加"
 jj git push
-npx @michi/cli phase:run user-auth requirements
+npx @sk8metal/michi-cli phase:run user-auth requirements
 
 # 2. 設計
 # 凡例
 /kiro:spec-design <feature>
 jj commit -m "docs: 設計追加"
 jj git push
-npx @michi/cli phase:run <feature> design
+npx @sk8metal/michi-cli phase:run <feature> design
 
 # 具体例
 /kiro:spec-design user-auth
 jj commit -m "docs: 設計追加"
 jj git push
-npx @michi/cli phase:run user-auth design
+npx @sk8metal/michi-cli phase:run user-auth design
 
 # 3. タスク分割
 # 凡例
 /kiro:spec-tasks <feature>
 jj commit -m "docs: タスク分割追加"
 jj git push
-npx @michi/cli phase:run <feature> tasks
+npx @sk8metal/michi-cli phase:run <feature> tasks
 
 # 具体例
 /kiro:spec-tasks user-auth
 jj commit -m "docs: タスク分割追加"
 jj git push
-npx @michi/cli phase:run user-auth tasks
+npx @sk8metal/michi-cli phase:run user-auth tasks
 
 # 4. 実装
 # 凡例
@@ -359,7 +486,7 @@ gh pr create --head 20240115-payment-api/feature/user-auth --base main
 git add .
 git commit -m "docs: 要件定義追加"
 git push
-npx @michi/cli phase:run <feature> requirements
+npx @sk8metal/michi-cli phase:run <feature> requirements
 
 # 具体例
 /kiro:spec-init ユーザー認証機能
@@ -367,7 +494,7 @@ npx @michi/cli phase:run <feature> requirements
 git add .
 git commit -m "docs: 要件定義追加"
 git push
-npx @michi/cli phase:run user-auth requirements
+npx @sk8metal/michi-cli phase:run user-auth requirements
 
 # 2. 設計
 # 凡例
@@ -375,14 +502,14 @@ npx @michi/cli phase:run user-auth requirements
 git add .
 git commit -m "docs: 設計追加"
 git push
-npx @michi/cli phase:run <feature> design
+npx @sk8metal/michi-cli phase:run <feature> design
 
 # 具体例
 /kiro:spec-design user-auth
 git add .
 git commit -m "docs: 設計追加"
 git push
-npx @michi/cli phase:run user-auth design
+npx @sk8metal/michi-cli phase:run user-auth design
 
 # 3. タスク分割
 # 凡例
@@ -390,14 +517,14 @@ npx @michi/cli phase:run user-auth design
 git add .
 git commit -m "docs: タスク分割追加"
 git push
-npx @michi/cli phase:run <feature> tasks
+npx @sk8metal/michi-cli phase:run <feature> tasks
 
 # 具体例
 /kiro:spec-tasks user-auth
 git add .
 git commit -m "docs: タスク分割追加"
 git push
-npx @michi/cli phase:run user-auth tasks
+npx @sk8metal/michi-cli phase:run user-auth tasks
 
 # 4. 実装
 # 凡例
@@ -555,8 +682,8 @@ cd ~/work/projects/michi
 ```bash
 # Michiから全プロジェクトの状況を確認
 cd /path/to/michi
-npx @michi/cli project:list
-npx @michi/cli project:dashboard
+npx @sk8metal/michi-cli project:list
+npx @sk8metal/michi-cli project:dashboard
 npm run multi-estimate
 ```
 

package/docs/getting-started/quick-start.md

@@ -22,15 +22,46 @@ michi --help
 
 ## 2. cc-sddをインストール
 
+cc-sddは、Michiの仕様駆動開発ワークフローのコアフレームワークです。
+
+### 推奨ワークフロー（cc-sdd準拠）
+
+既存リポジトリにMichiを導入する標準的な3ステップ：
+
 ```bash
-# Cursor IDE を使用する場合
+# Step 1: cc-sddで標準ファイル生成
+npx cc-sdd@latest --cursor --lang ja
+
+# Step 2: Michi固有ファイルを追加
+npx @sk8metal/michi-cli setup-existing --cursor --lang ja
+# または npm run michi:setup:cursor
+
+# Step 3: 環境設定（後述）
+npm run setup:interactive
+```
+
+### IDE別インストール例
+
+```bash
+# Cursor IDE（推奨）
 npx cc-sdd@latest --lang ja --cursor
 
-# Claude Code を使用する場合
+# Claude Code
 npx cc-sdd@latest --lang ja --claude
+
+# Gemini CLI
+npx cc-sdd@latest --lang ja --gemini
+
+# Codex CLI
+npx cc-sdd@next --lang ja --codex
+
+# Windsurf IDE
+npx cc-sdd@next --lang ja --windsurf
 ```
 
-cc-sddは、Michiの仕様駆動開発ワークフローのコアフレームワークです。
+**重要**: Step 2で `npx @sk8metal/michi-cli setup-existing` を実行すると、テンプレートがNPMパッケージから自動的にコピーされます。git clone不要です。
+
+詳細な手順は [セットアップガイド](./setup.md#step-25-推奨ワークフローcc-sdd--michi) を参照してください。
 
 ## 3. 環境変数を設定
 
@@ -88,11 +119,31 @@ Cursor/VS CodeでAIコマンドを実行：
 /kiro:spec-tasks user-authentication
 ```
 
-これにより、以下が自動実行されます：
+これにより、`tasks.md`が生成されます。
+
+**重要**: `/kiro:spec-tasks` はローカルで `tasks.md` を生成するだけです。Confluence/JIRAに同期するには、以下のCLIコマンドを実行する必要があります：
+
+```bash
+npx @sk8metal/michi-cli phase:run user-authentication tasks
+```
+
+このコマンドにより、以下が自動実行されます：
 
-- `tasks.md`の生成
 - Confluenceページの自動作成（要件・設計）
-- JIRA Epicとストーリーの自動作成
+- JIRA Epicとストーリーの自動作成（全6フェーズ）
+- バリデーション実行
+
+**注意**: 要件定義・設計フェーズでも同様に、`/kiro:spec-requirements` や `/kiro:spec-design` の後に `phase:run` を実行する必要があります：
+
+```bash
+# 要件定義フェーズ
+/kiro:spec-requirements user-authentication
+npx @sk8metal/michi-cli phase:run user-authentication requirements
+
+# 設計フェーズ
+/kiro:spec-design user-authentication
+npx @sk8metal/michi-cli phase:run user-authentication design
+```
 
 ## 7. 実装を開始