@sk8metal/michi-cli 0.10.1 → 0.12.0

package/docs/user-guide/hands-on/claude-setup.md

@@ -1,452 +0,0 @@
-# Claude Codeセットアップガイド
-
-このガイドでは、Claude CodeでMichiを使用するためのセットアップ手順を説明します。
-
-## 📋 前提条件
-
-以下がインストール済みであることを確認してください：
-
-- **Node.js**: 20.x以上
-- **npm**: 10.x以上
-- **Git**: 最新版（または Jujutsu (jj)）
-- **GitHub CLI (gh)**: 最新版
-- **Claude Code CLI**: 最新版
-
-### インストール確認
-
-```bash
-# バージョン確認
-node --version    # v20.0.0以上
-npm --version     # 10.0.0以上
-git --version     # または jj --version
-gh --version
-claude --version  # Claude Code CLIのバージョン
-```
-
-## 🚀 セットアップ手順
-
-### Step 1: Michiのインストール
-
-#### 方法A: NPMパッケージからインストール（推奨）
-
-```bash
-# グローバルインストール
-npm install -g @sk8metal/michi-cli
-
-# インストール確認
-michi --version
-michi --help
-```
-
-#### 方法B: リポジトリからクローン（開発者向け）
-
-```bash
-# リポジトリをクローン
-git clone https://github.com/sk8metalme/michi
-cd michi
-
-# 依存関係のインストール
-npm install
-
-# ビルド
-npm run build
-
-# グローバルコマンドとしてリンク
-npm link
-```
-
-### Step 2: 既存プロジェクトへのMichi導入
-
-既存のプロジェクトディレクトリに移動します：
-
-```bash
-# プロジェクトディレクトリに移動
-cd /path/to/your-project
-```
-
-### Step 3: cc-sddのインストール
-
-MichiはAI駆動開発ワークフローのコアフレームワークとして[cc-sdd](https://github.com/gotalab/cc-sdd)を使用します。
-
-```bash
-# cc-sddをインストール（Claude Code向け、日本語）
-npx cc-sdd@latest --claude --lang ja
-```
-
-**実行結果の確認**:
-
-```
-✅ .kiro/settings/rules/ - Spec-Driven Development用のルールファイル
-✅ .kiro/settings/templates/ - Spec用テンプレート（requirements.md, design.md等）
-✅ CLAUDE.md - プロジェクトルートへのメインルールファイル
-```
-
-### Step 4: Michi固有ファイルの追加
-
-#### 基本セットアップ
-
-```bash
-# Michi専用のファイルを追加
-npx @sk8metal/michi-cli setup-existing --claude --lang ja
-```
-
-このコマンドは、デフォルトで以下を実行します：
-1. Michiワークフロー用のファイル・ディレクトリを作成
-2. **スキル/サブエージェントを `~/.claude/` にインストール**（自動）
-3. スラッシュコマンドを `.claude/commands/michi/` に配置
-
-#### オプション設定
-
-**スキル/サブエージェントのインストールをスキップする場合**:
-
-```bash
-# --no-agent-skills オプションを使用
-npx @sk8metal/michi-cli setup-existing \
-  --claude \
-  --lang ja \
-  --no-agent-skills
-```
-
-**対話的プロンプト**:
-
-セットアップコマンドを実行すると、以下の情報を対話的に入力するよう求められます：
-
-```
-環境を選択してください:
-  1) Cursor IDE (推奨)
-  2) Claude Code
-  3) Claude Code Subagents
-
-選択 [1-3] (デフォルト: 1): 2
-
-プロジェクト名（例: プロジェクトA）: サンプルプロジェクト
-
-JIRAプロジェクトキー（例: PRJA）: DEMO
-
-✅ 設定:
-   プロジェクト名: サンプルプロジェクト
-   JIRA: DEMO
-   環境: claude
-   言語: ja
-
-この設定で続行しますか？ [Y/n]: Y
-```
-
-**実行結果の確認**:
-
-```
-✅ .kiro/settings/templates/ - Specテンプレート
-✅ .kiro/steering/ - Steeringテンプレート
-✅ .kiro/project.json - プロジェクトメタデータ
-✅ .claude/commands/michi/ - Michi専用コマンド
-✅ ~/.claude/skills/ - AI開発支援スキル（自動インストール）
-✅ ~/.claude/agents/ - 汎用サブエージェント（自動インストール）
-✅ .env - 環境変数テンプレート（権限: 600）
-```
-
-#### 💡 `--claude` vs `--claude-agent` の違い
-
-Michiは2つのClaude Code環境をサポートしています：
-
-| 項目 | `--claude` | `--claude-agent` |
-|------|-----------|-----------------|
-| **用途** | ルールベースのClaude Code環境 | サブエージェント活用環境 |
-| **プロジェクト内ディレクトリ** | `.claude/rules/` | `.claude/agents/` |
-| **テンプレート** | `templates/claude/` | `templates/claude-agent/` |
-| **推奨ユーザー** | Claude Codeの標準利用者 | カスタムサブエージェントを開発したいユーザー |
-| **スキル/サブエージェント** | `~/.claude/`に汎用スキルをインストール（共通） | `~/.claude/`に汎用スキルをインストール（共通） |
-
-**重要**: どちらの環境でも、デフォルトで汎用スキル/サブエージェント（design-review、oss-license等）が`~/.claude/`にインストールされます。これらはプロジェクト固有のカスタムサブエージェント（`--claude-agent`で配置される）とは別のものです。
-
-### Step 5: 環境変数の設定
-
-`.env`ファイルが自動生成されているので、認証情報を設定します：
-
-```bash
-# .envファイルを編集
-vim .env
-```
-
-**最小限の設定（GitHub連携のみ）**:
-
-```bash
-# GitHub設定（必須）
-GITHUB_TOKEN=ghp_your_token_here
-GITHUB_ORG=your-org
-```
-
-> **Note (v0.5.0以降)**: `GITHUB_REPO` 環境変数は廃止されました。リポジトリ情報は `.kiro/project.json` の `repository` フィールドから自動的に取得されます。
-
-**完全な設定（Confluence/JIRA連携も使用）**:
-
-```bash
-# Atlassian設定
-ATLASSIAN_URL=https://your-domain.atlassian.net
-ATLASSIAN_EMAIL=your-email@company.com
-ATLASSIAN_API_TOKEN=your-token-here
-
-# GitHub設定
-GITHUB_ORG=your-org
-GITHUB_TOKEN=ghp_xxx
-
-# Confluence共有スペース
-CONFLUENCE_PRD_SPACE=PRD
-CONFLUENCE_QA_SPACE=QA
-CONFLUENCE_RELEASE_SPACE=RELEASE
-
-# JIRAプロジェクトキー
-JIRA_PROJECT_KEYS=DEMO
-
-# JIRA Issue Type IDs（JIRAインスタンス固有 - 必須）
-JIRA_ISSUE_TYPE_STORY=10036
-JIRA_ISSUE_TYPE_SUBTASK=10037
-```
-
-#### JIRA Issue Type IDの取得方法
-
-JIRA Issue Type IDは、JIRAインスタンスごとに異なるため、以下の方法で確認してください：
-
-**方法1: JIRA管理画面で確認**
-
-1. JIRA管理画面にログイン
-2. Settings > Issues > Issue types
-3. 「Story」と「Subtask」のIDを確認
-
-**方法2: REST APIで確認**
-
-```bash
-curl -u your-email@company.com:your-token \
-  https://your-domain.atlassian.net/rest/api/3/issuetype
-```
-
-レスポンスから「Story」と「Subtask」の`id`フィールドを取得します。
-
-### Step 6: 依存関係のインストール
-
-プロジェクトルートで依存関係をインストールします：
-
-```bash
-npm install
-```
-
-### Step 7: GitHub認証の確認
-
-GitHub CLIが正しく認証されているか確認します：
-
-```bash
-# 認証状態を確認
-gh auth status
-
-# 認証が必要な場合
-gh auth login
-gh auth setup-git
-```
-
-### Step 8: セットアップの確認
-
-すべてのファイルが正しく生成されているか確認します：
-
-```bash
-# ディレクトリ構造を確認
-tree -L 3 .kiro .claude
-
-# 期待される構造:
-# .kiro/
-# ├── project.json              # Michiで管理（Gitにコミット）
-# ├── settings/                 # cc-sddで生成（Git管理外）
-# │   ├── rules/               # Spec-Driven Development用ルール
-# │   └── templates/           # Spec用テンプレート
-# │       ├── design.md
-# │       ├── requirements.md
-# │       └── tasks.md
-# ├── steering/                # /kiro:steeringコマンドで作成（Git管理）
-# │   ├── product.md
-# │   ├── structure.md
-# │   └── tech.md
-# └── specs/                   # /kiro:spec-initで作成（Git管理）
-#
-# .claude/
-# ├── commands/
-# │   └── michi/
-# │       ├── confluence-sync.md
-# │       └── project-switch.md
-# └── rules/
-#     ├── atlassian-integration.md
-#     └── michi-core.md
-```
-
-### Step 9: Claude Code設定の確認
-
-Claude Codeが`.claude/`ディレクトリを認識しているか確認します：
-
-```bash
-# Claude Codeでプロジェクトをスキャン
-claude config scan
-
-# ルールファイルが読み込まれているか確認
-claude rules list
-```
-
-## ✅ セットアップ完了の確認
-
-以下のチェックリストを確認してください：
-
-- [ ] `michi --version` が正常に動作する
-- [ ] `.kiro/project.json` が存在し、正しい内容が含まれている
-- [ ] `.env` ファイルが存在し、認証情報が設定されている
-- [ ] `.claude/rules/` ディレクトリにルールファイルが存在する
-- [ ] `.claude/commands/michi/` ディレクトリにコマンドファイルが存在する
-- [ ] `~/.claude/skills/` ディレクトリにスキルが存在する（`--no-agent-skills`を使用しなかった場合）
-- [ ] `~/.claude/agents/` ディレクトリにサブエージェントが存在する（`--no-agent-skills`を使用しなかった場合）
-- [ ] `gh auth status` が成功する
-- [ ] `claude rules list` でMichiのルールが表示される
-
-## 🎯 次のステップ
-
-セットアップが完了したら、[ワークフロー体験ガイド](./workflow-walkthrough.md)に進んでください。
-
-実際にサンプル機能（`health-check-endpoint`）を使って、Michiの全ワークフローを体験できます。
-
-## 💡 Claude Code特有の使い方
-
-### コマンドの実行方法
-
-Claude Codeでは、以下の方法でMichiコマンドを実行します：
-
-#### 方法1: 直接指示（推奨）
-
-```
-ユーザー: health-check-endpointの要件定義を生成してください
-
-Claude: [/kiro:spec-requirements コマンドを実行]
-```
-
-#### 方法2: コマンドを明示的に指定
-
-```
-ユーザー: /kiro:spec-requirements health-check-endpoint
-```
-
-#### 方法3: CLIツールを直接実行
-
-```bash
-# ターミナルで直接実行
-npx @sk8metal/michi-cli phase:run health-check-endpoint requirements
-```
-
-### コンテキストの管理
-
-Claude Codeでは、会話のコンテキストが重要です：
-
-```
-# プロジェクト情報を明示的に提供
-ユーザー: このプロジェクトは.kiro/project.jsonで管理されています。
-         health-check-endpoint機能の要件定義を生成してください。
-
-Claude: [.kiro/project.jsonを読み込み、要件定義を生成]
-```
-
-### ファイル参照
-
-Claude Codeは、ファイルを自動的に参照します：
-
-```
-ユーザー: .kiro/specs/health-check-endpoint/requirements.mdを
-         Confluenceに同期してください
-
-Claude: [requirements.mdを読み込み、confluence:syncを実行]
-```
-
-## 🆘 トラブルシューティング
-
-セットアップ中に問題が発生した場合は、[トラブルシューティングガイド](./troubleshooting.md)を参照してください。
-
-### Claude Code特有の問題
-
-#### ルールファイルが読み込まれない
-
-```bash
-# Claude Code設定を再読み込み
-claude config reload
-
-# ルールディレクトリを確認
-ls -la .claude/rules/
-```
-
-#### コマンドが認識されない
-
-```bash
-# コマンドディレクトリを確認
-ls -la .claude/commands/michi/
-
-# ファイルが存在するか確認
-cat .claude/commands/michi/confluence-sync.md
-```
-
-#### スキル/サブエージェントが見つからない
-
-**症状**: コマンド実行時に「スキルが見つかりません」エラー
-
-**原因**:
-- セットアップ時に`--no-agent-skills`オプションを使用した
-- `~/.claude/skills/`または`~/.claude/agents/`が削除された
-
-**解決策**:
-```bash
-# スキル/サブエージェントを再インストール
-npx @sk8metal/michi-cli setup-existing --claude --lang ja
-```
-
-**Note**: デフォルトでスキル/サブエージェントがインストールされます。`--no-agent-skills`オプションを使用しないでください。
-
-#### 環境変数が読み込まれない
-
-```bash
-# .envファイルが存在するか確認
-ls -la .env
-
-# 権限を確認（600であるべき）
-stat -c "%a %n" .env  # Linux
-stat -f "%Lp %N" .env # macOS
-
-# 権限を修正
-chmod 600 .env
-```
-
-### よくある問題
-
-#### npm installがエラーになる
-
-```bash
-# キャッシュをクリア
-npm cache clean --force
-rm -rf node_modules package-lock.json
-npm install
-```
-
-#### GitHub認証エラー
-
-```bash
-# 認証を再実行
-gh auth logout
-gh auth login
-gh auth setup-git
-```
-
-## 📚 関連ドキュメント
-
-- [ワークフロー体験ガイド](./workflow-walkthrough.md) - 次のステップ
-- [検証チェックリスト](./verification-checklist.md) - 動作確認
-- [セットアップガイド](../getting-started/setup.md) - 詳細な設定
-- [クイックリファレンス](../reference/quick-reference.md) - コマンド一覧
-
-## 🔗 外部リンク
-
-- [Claude Code公式ドキュメント](https://docs.anthropic.com/en/docs/claude-code)
-- [cc-sdd公式ドキュメント](https://github.com/gotalab/cc-sdd)
-- [Michi GitHubリポジトリ](https://github.com/sk8metalme/michi)
-
-
-
-
-