@sk8metal/michi-cli 0.0.8 → 0.1.0

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

@@ -35,31 +35,111 @@ npm run create-project -- \
 5. 共通ファイルコピー
 6. `projects/{project-id}/.env` テンプレート作成
 7. npm install（リポジトリルートで実行）
-8. 初期コミット・プッシュ
+8. 初期コミット（`main`ブランチ作成）
+
+**注意**: プッシュは手動で実行する必要があります。スクリプト完了後、以下のコマンドを実行してください：
+
+```bash
+# Jujutsu (jj) を使用する場合
+jj git push --bookmark main --allow-new
+
+# Git を使用する場合
+git push -u origin main
+```
 
 **重要**: すべてのプロジェクトは`projects/{project-id}/`配下に配置されます。
 
-### 方法2: 既存プロジェクトにMichiワークフローを追加（推奨 - 既存リポジトリ）
+### 方法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別実行例
 
-既存のリポジトリにAI開発フローを導入：
+**Cursor IDE（推奨）**:
 
 ```bash
 # 既存プロジェクトのディレクトリに移動
 cd /path/to/existing-repo
 
-# Michiのセットアップスクリプトを実行（対話式）
-bash /path/to/michi/scripts/setup-existing.sh
+# 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
 ```
 
-対話式でプロジェクト情報を入力すると、自動的に：
-1. ✅ リポジトリルートを検出
-2. ✅ `projects/{project-id}/`ディレクトリ作成
-3. ✅ cc-sdd 導入確認・インストール
-4. ✅ `projects/{project-id}/.kiro/project.json` 作成
-5. ✅ Michiから共通ファイルコピー（ルール、コマンド、テンプレート）
-6. ✅ `projects/{project-id}/.env` テンプレート作成
-7. ✅ README.md と .gitignore 更新（リポジトリルート）
-8. ✅ CLIツールのセットアップ案内
+**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
+
+# 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導入（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}/`配下に配置されます。
 
@@ -345,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. 実装
 # 凡例
@@ -406,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 ユーザー認証機能
@@ -414,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. 設計
 # 凡例
@@ -422,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. タスク分割
 # 凡例
@@ -437,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. 実装
 # 凡例
@@ -602,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 → user-guide/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. 実装を開始
 
@@ -102,6 +153,22 @@ Cursor/VS CodeでAIコマンドを実行：
 
 TDD（テスト駆動開発）で実装が進められます。
 
+## 8. テストを作成（オプション）
+
+Phase Bテスト（手動回帰、負荷、セキュリティ）を対話的に作成できます：
+
+```bash
+npm run test:interactive
+```
+
+対話的に以下の情報を入力すると、テストファイルが自動生成されます：
+- テストタイプ（手動回帰/負荷/セキュリティ）
+- 対象エンドポイント
+- 期待するレスポンス
+- テスト条件
+
+詳細は [テスト計画フロー](../testing/test-planning-flow.md) を参照してください。
+
 ## 次のステップ
 
 ### より詳しく学ぶ

package/docs/{getting-started → user-guide/getting-started}/setup.md

@@ -1,7 +1,7 @@
 # Michi セットアップガイド
 
 > **このガイドについて**: 既存のプロジェクトにMichiを導入する手順です。  
-> 新規プロジェクトを作成する場合は [新規リポジトリセットアップガイド](./new-project-setup.md) を参照してください。  
+> 新規プロジェクトを作成する場合は [新規リポジトリセットアップガイド](./new-repository-setup.md) を参照してください。  
 > Michiの開発に貢献する場合は [開発環境セットアップガイド](../contributing/development.md) を参照してください。
 
 ## 前提条件
@@ -62,8 +62,113 @@ npx cc-sdd@next --lang ja --windsurf
 - `.cursor/commands/kiro/` または `.claude/commands/kiro/` にコマンド作成
 - `AGENTS.md` または `CLAUDE.md` にプロジェクト設定追加
 
+**cc-sdd準拠アーキテクチャ（Issue #35）:**
+- Michiは**単一の英語テンプレート + プレースホルダー**でcc-sdd準拠を実現
+- `templates/` ディレクトリからCursor/Claude両環境に対応
+- プレースホルダー（`{{LANG_CODE}}`, `{{DEV_GUIDELINES}}` 等）をAIが実行時に解釈
+
+
 詳細: [cc-sdd公式ドキュメント](https://github.com/gotalab/cc-sdd/blob/main/tools/cc-sdd/README_ja.md)
 
+
+## Step 2.5: 推奨ワークフロー（cc-sdd + Michi）
+
+既存リポジトリにMichiを導入する標準的な手順は以下の通りです：
+
+### 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
+```
+
+### 各ステップの詳細
+
+#### Step 1: cc-sdd導入
+
+cc-sddは、AI駆動開発ワークフローのコアフレームワークです。以下を自動生成します:
+
+- `.kiro/settings/` - テンプレート設定
+- `.cursor/commands/kiro/` - 11のスラッシュコマンド
+- `AGENTS.md` - プロジェクト設定
+
+**実行例（IDE別）**:
+
+```bash
+# Cursor IDE
+npx cc-sdd@latest --cursor --lang ja
+
+# Claude Code
+npx cc-sdd@latest --claude --lang ja
+
+# Gemini CLI
+npx cc-sdd@latest --gemini --lang ja
+
+# Codex CLI
+npx cc-sdd@next --codex --lang ja
+
+# Windsurf IDE
+npx cc-sdd@next --windsurf --lang ja
+```
+
+#### Step 2: Michi固有ファイル追加
+
+Michiの専用機能（Confluence/JIRA連携、マルチプロジェクト管理）を追加します:
+
+**実行例**:
+
+```bash
+# Cursor IDE
+npx @sk8metal/michi-cli setup-existing --cursor --lang ja
+# または npm run michi:setup:cursor
+
+# Claude Code
+npx @sk8metal/michi-cli setup-existing --claude --lang ja
+# または npm run michi:setup:claude
+
+# Claude Code Subagents
+npx @sk8metal/michi-cli setup-existing --claude-agent --lang ja
+# または npm run michi:setup:claude-agent
+```
+
+**追加されるもの**:
+
+- 共通ルール（`.cursor/rules/`または`.claude/rules/`）
+- Michi専用コマンド（`.cursor/commands/michi/`または`.claude/commands/michi/`）
+- Steeringテンプレート（`.kiro/steering/`）
+- Specテンプレート（`.kiro/settings/templates/`）
+- プロジェクトメタデータ（`.kiro/project.json`）
+- 環境変数テンプレート（`.env`）
+
+#### Step 3: 環境設定
+
+対話的設定ツールで認証情報とプロジェクトメタデータを設定します：
+
+```bash
+npm run setup:interactive
+```
+
+このツールが以下を設定します：
+
+- プロジェクト情報（`project.json`）
+- 認証情報（`.env`）
+
+詳細は [Step 3: 環境変数の設定](#step-3-環境変数の設定) を参照してください。
+
+### なぜこの順序なのか？
+
+1. **cc-sdd → Michi**: cc-sddが基盤を作り、Michiが拡張機能を追加
+2. **ファイル追加 → 環境設定**: 設定ファイルが先に存在する必要がある
+3. **標準化**: すべてのプロジェクトで一貫した手順
+
+
 ## Step 3: 環境変数の設定
 
 ### 3-1. .env ファイルの作成
@@ -220,12 +325,39 @@ SLACK_WEBHOOK_URL=<SlackWebhook URL>
 4. 生成されたトークンをコピーして `.env` に貼り付け
 
 #### GitHub Token
+
+**重要**: GitHubトークンをまだ作成していない場合は、以下の詳細ガイドを参照してください：
+
+📖 **[GitHubトークン作成ガイド](./github-token-setup.md)**
+
+トークン作成ガイドでは以下を解説しています：
+- Fine-grained tokens と Tokens (classic) の違い
+- 必要な権限の詳細説明
+- トークンの作成手順（ステップバイステップ）
+- セキュリティベストプラクティス
+- トラブルシューティング
+
+**クイックガイド**（既にトークンを持っている場合）:
+
 ```bash
+# GitHub CLIを使用する場合
 gh auth login
 gh auth token
+
+# 生成されたトークンを .env に設定
+```
+
+トークン作成後、`.env` の `GITHUB_TOKEN` に設定:
+
+```bash
+GITHUB_TOKEN=ghp_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
 ```
 
-生成されたトークンを `.env` の `GITHUB_TOKEN` に設定
+**必要な権限**:
+- `repo` (Full control of private repositories)
+- `workflow` (Update GitHub Action workflows)
+
+詳細は [GitHubトークン作成ガイド](./github-token-setup.md) を参照してください。
 
 #### Slack Webhook URL（オプション）
 1. https://api.slack.com/apps にアクセス
@@ -276,7 +408,7 @@ wget -O ~/.cursor/mcp.json https://raw.githubusercontent.com/sk8metalme/michi/ma
 
 **重要**: すべてのプロジェクト（単一プロジェクトも含む）は`projects/{project-id}/`配下に配置されます。
 
-> **補足**: 新規プロジェクトを作成する場合や、既存プロジェクトにMichiを自動導入する場合は [新規プロジェクトセットアップガイド](./new-project-setup.md) を参照してください。
+> **補足**: 新規プロジェクトを作成する場合や、既存プロジェクトにMichiを自動導入する場合は [新規リポジトリセットアップガイド](./new-repository-setup.md) を参照してください。
 
 ### 5-1. `.kiro/project.json` の作成
 
@@ -371,12 +503,155 @@ michi help
 
 ## トラブルシューティング
 
+### cc-sddのインストールに失敗する
+
+**症状**: `npx cc-sdd@latest` が失敗する
+
+**原因**:
+- npmキャッシュの問題
+- ネットワーク接続の問題
+- Node.jsのバージョンが古い
+
+**解決方法**:
+
+```bash
+# キャッシュをクリア
+npm cache clean --force
+
+# 再度実行
+npx cc-sdd@latest --cursor --lang ja
+
+# それでも失敗する場合は、Node.jsバージョンを確認
+node --version
+# 20.0.0以上が必要
+```
+
+### setup-existing の実行エラー
+
+**症状**: `npx @sk8metal/michi-cli setup-existing` が失敗する
+
+**原因**:
+- ネットワーク接続の問題
+- 必要な依存関係がインストールされていない
+- 権限の問題
+
+**解決方法**:
+
+```bash
+# NPMキャッシュをクリア
+npm cache clean --force
+
+# 再度実行
+npx @sk8metal/michi-cli setup-existing --cursor --lang ja
+
+# または、開発リポジトリから実行する場合
+cd /path/to/michi
+npm run michi:setup:cursor
+```
+
+### 環境変数設定のミス
+
+**症状**: Confluence/JIRA連携が動作しない
+
+**原因**:
+- `.env`ファイルの認証情報が間違っている
+- 環境変数が正しく読み込まれていない
+
+**解決方法**:
+
+```bash
+# .envファイルの内容を確認
+cat .env
+
+# 認証情報が正しいか確認
+# - ATLASSIAN_URL: https://your-domain.atlassian.net 形式
+# - ATLASSIAN_EMAIL: メールアドレス形式
+# - ATLASSIAN_API_TOKEN: 有効なトークン
+# - GITHUB_TOKEN: ghp_ で始まるトークン
+
+# トークンの有効性を確認
+curl -u your-email@company.com:your-api-token \
+  https://your-domain.atlassian.net/rest/api/3/myself
+```
+
 ### MCP サーバーが動作しない
 
+**症状**: Cursor IDEでAtlassian MCPが接続できない
+
+**原因**:
+- `~/.cursor/mcp.json`の設定が間違っている
+- Atlassian API Tokenが無効
+- Cursorが設定を読み込んでいない
+
+**解決方法**:
+
 1. Cursor を再起動
 2. `~/.cursor/mcp.json` の認証情報を確認
+
+```bash
+# mcp.jsonの内容を確認
+cat ~/.cursor/mcp.json
+
+# 認証情報が.envと一致しているか確認
+```
+
 3. Atlassian API Token が有効か確認
 
+```bash
+# トークンの有効性をテスト
+curl -u your-email@company.com:your-token \
+  https://your-domain.atlassian.net/rest/api/3/myself
+```
+
+4. Cursor のログを確認
+
+- Cursor > View > Toggle Developer Tools
+- Console タブでエラーを確認
+
+### JIRA Issue Type ID の取得方法
+
+**症状**: `JIRA_ISSUE_TYPE_STORY`や`JIRA_ISSUE_TYPE_SUBTASK`の値がわからない
+
+**解決方法**:
+
+**方法1: JIRA管理画面から確認（管理者権限が必要）**
+
+1. JIRAに管理者権限でログイン
+2. Settings（設定）> Issues（課題）> Issue types（課題タイプ）
+3. 「Story」と「Subtask」のIDを確認
+
+**方法2: REST APIで確認（推奨）**
+
+```bash
+# すべてのIssue Typeを取得
+curl -u your-email@company.com:your-api-token \
+  https://your-domain.atlassian.net/rest/api/3/issuetype | jq
+
+# 出力例:
+# [
+#   {
+#     "id": "10036",
+#     "name": "Story",
+#     ...
+#   },
+#   {
+#     "id": "10037",
+#     "name": "Subtask",
+#     ...
+#   }
+# ]
+```
+
+**方法3: jqがない場合**
+
+```bash
+# jqなしで確認
+curl -u your-email@company.com:your-api-token \
+  https://your-domain.atlassian.net/rest/api/3/issuetype
+
+# 出力から "Story" と "Subtask" の "id" フィールドを探す
+```
+
 ### GitHub認証エラー
 
 ```bash

package/docs/{guides → user-guide/guides}/customization.md

@@ -363,7 +363,7 @@ Confluenceスペース
 
 ```bash
 # 対話式設定ツールを実行
-npx @michi/cli config:interactive
+npx @sk8metal/michi-cli config:interactive
 
 # または
 npm run config:interactive
@@ -371,7 +371,7 @@ npm run config:interactive
 
 ### 使い方
 
-1. **コマンド実行**: `npx @michi/cli config:interactive`
+1. **コマンド実行**: `npx @sk8metal/michi-cli config:interactive`
 2. **設定項目を選択**: 
    - Confluence設定のカスタマイズ
    - JIRA設定のカスタマイズ
@@ -394,7 +394,7 @@ npm run config:interactive
 
 ```bash
 # 設定ファイルのバリデーション
-npx @michi/cli config:validate
+npx @sk8metal/michi-cli config:validate
 
 # または
 npm run config:validate