@sk8metal/michi-cli 0.0.4 → 0.0.6

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

@@ -22,8 +22,8 @@ npm run create-project -- \
 
 # 具体例
 npm run create-project -- \
-  --name "customer-a-service-1" \
-  --project-name "A社 サービス1" \
+  --name "20240115-payment-api" \
+  --project-name "プロジェクトA" \
   --jira-key "PRJA"
 ```
 
@@ -91,24 +91,24 @@ cursor .
 
 ```bash
 # GitHub CLI で新規リポジトリ作成
-gh repo create your-org/customer-a-service-1 --private --description "A社 サービス1"
+gh repo create your-org/20240115-payment-api --private --description "プロジェクトA"
 
 # ローカルにクローン
 cd ~/work/projects
-jj git clone https://github.com/your-org/customer-a-service-1
-cd customer-a-service-1
+jj git clone https://github.com/your-org/20240115-payment-api
+cd 20240115-payment-api
 ```
 
 #### Git を使用する場合
 
 ```bash
 # GitHub CLI で新規リポジトリ作成
-gh repo create your-org/customer-a-service-1 --private --description "A社 サービス1"
+gh repo create your-org/20240115-payment-api --private --description "プロジェクトA"
 
 # ローカルにクローン
 cd ~/work/projects
-git clone https://github.com/your-org/customer-a-service-1
-cd customer-a-service-1
+git clone https://github.com/your-org/20240115-payment-api
+cd 20240115-payment-api
 ```
 
 ### Step 2: cc-sdd 導入
@@ -128,15 +128,15 @@ npx cc-sdd@latest --cursor --lang ja --yes
 
 ```json
 {
-  "projectId": "customer-a-service-1",
-  "projectName": "A社 サービス1",
+  "projectId": "20240115-payment-api",
+  "projectName": "プロジェクトA",
   "jiraProjectKey": "PRJA",
-  "confluenceLabels": ["project:customer-a-service-1", "service:s1"],
+  "confluenceLabels": ["project:20240115-payment-api", "service:payment"],
   "status": "active",
   "team": ["@dev1", "@dev2"],
   "stakeholders": ["@企画", "@部長"],
-  "repository": "https://github.com/your-org/customer-a-service-1",
-  "description": "A社向けサービス1の開発"
+  "repository": "https://github.com/your-org/20240115-payment-api",
+  "description": "プロジェクトA向け決済APIの開発"
 }
 ```
 
@@ -152,12 +152,12 @@ npx cc-sdd@latest --cursor --lang ja --yes
 - **プロジェクトラベル**: `project:{projectId}` を常に生成
 - **サービスラベル**: ハイフン（`-`）が含まれる場合のみ生成
   - ハイフンがない場合: `project:michi` のみ（サービスラベルなし）
-  - ハイフンがある場合: `project:customer-a-service-1, service:s1`
+  - ハイフンがある場合: `project:20240115-payment-api, service:payment`
   - 重複防止: サービスラベルがプロジェクトラベルと同一の場合は追加しない
 
 **動作例**:
 - `projectId: 'michi'` → `['project:michi']`（サービスラベルなし）
-- `projectId: 'customer-a-service-1'` → `['project:customer-a-service-1', 'service:s1']`
+- `projectId: '20240115-payment-api'` → `['project:20240115-payment-api', 'service:payment']`
 - `projectId: 'michi-service'` → `['project:michi-service']`（サービスラベルがプロジェクトラベルと同一のため追加しない）
 ### Step 4: Michiから共通設定をコピー
 
@@ -198,7 +198,7 @@ ATLASSIAN_API_TOKEN=your-token-here
 # GitHub設定
 GITHUB_ORG=your-org
 GITHUB_TOKEN=ghp_xxx
-GITHUB_REPO=your-org/customer-a-service-1
+GITHUB_REPO=your-org/20240115-payment-api
 
 # Confluence共有スペース
 CONFLUENCE_PRD_SPACE=PRD
@@ -248,7 +248,7 @@ npm run type-check
 # Git初期化（まだの場合）
 git init
 git branch -M main
-git remote add origin https://github.com/your-org/customer-a-service-1.git
+git remote add origin https://github.com/your-org/20240115-payment-api.git
 ```
 
 ### Step 8: 初期コミット
@@ -344,9 +344,9 @@ gh pr create --head <project-id>/feature/<feature> --base main
 # 具体例
 /kiro:spec-impl user-auth FE-1,BE-1
 jj commit -m "feat: 実装 [PRJA-123]"
-jj bookmark create customer-a-service-1/feature/user-auth -r '@-'
-jj git push --bookmark customer-a-service-1/feature/user-auth --allow-new
-gh pr create --head customer-a-service-1/feature/user-auth --base main
+jj bookmark create 20240115-payment-api/feature/user-auth -r '@-'
+jj git push --bookmark 20240115-payment-api/feature/user-auth --allow-new
+gh pr create --head 20240115-payment-api/feature/user-auth --base main
 ```
 
 #### Git を使用する場合
@@ -410,11 +410,11 @@ gh pr create --head <project-id>/feature/<feature> --base main
 
 # 具体例
 /kiro:spec-impl user-auth FE-1,BE-1
-git checkout -b customer-a-service-1/feature/user-auth
+git checkout -b 20240115-payment-api/feature/user-auth
 git add .
 git commit -m "feat: 実装 [PRJA-123]"
-git push -u origin customer-a-service-1/feature/user-auth
-gh pr create --head customer-a-service-1/feature/user-auth --base main
+git push -u origin 20240115-payment-api/feature/user-auth
+gh pr create --head 20240115-payment-api/feature/user-auth --base main
 ```
 
 ## プロジェクト間の切り替え
@@ -422,17 +422,17 @@ gh pr create --head customer-a-service-1/feature/user-auth --base main
 ### Cursor で切り替え
 
 ```text
-/kiro:project-switch customer-a-service-1
+/kiro:project-switch 20240115-payment-api
 ```
 
 ### ターミナルで切り替え
 
 ```bash
 # プロジェクトAに切り替え
-cd ~/work/projects/customer-a-service-1
+cd ~/work/projects/20240115-payment-api
 
 # プロジェクトBに切り替え
-cd ~/work/projects/customer-b-api
+cd ~/work/projects/20240201-user-management
 
 # Michiハブに戻る
 cd ~/work/projects/michi
@@ -455,8 +455,8 @@ npm run project:list
 | プロジェクト | ID | ステータス | JIRA | チーム |
 |------------|-------|----------|------|--------|
 | Michi | michi | active | MICHI | @developer1 |
-| A社 サービス1 | customer-a-service-1 | active | PRJA | @dev1, @dev2 |
-| B社 API | customer-b-api | active | PRJB | @dev3 |
+| プロジェクトA | 20240115-payment-api | active | PRJA | @dev1, @dev2 |
+| プロジェクトC | 20240310-analytics-api | active | PRJB | @dev3 |
 ```
 
 ## トラブルシューティング
@@ -483,17 +483,17 @@ npx cc-sdd@latest --cursor --lang ja --yes
 
 ### プロジェクト命名規則
 
-**リポジトリ名**: `customer-{id}-{service}`
-- 例: `customer-a-service-1`, `customer-b-api`, `customer-c-poc`
+**リポジトリ名**: `{YYYYMMDD}-{PJ名}`
+- 例: `20240115-payment-api`, `20240201-user-management`, `20240310-analytics-api`
 
 **プロジェクトID**: リポジトリ名と同じ
-- 例: `customer-a-service-1`
+- 例: `20240115-payment-api`
 
 **JIRA プロジェクトキー**: 3-4文字、一意
 - 例: `PRJA`, `PRJB`, `PRJC`
 
 **Confluenceラベル**: `project:{projectId}, service:{service}`
-- 例: `["project:customer-a-service-1", "service:s1"]`
+- 例: `["project:20240115-payment-api", "service:payment"]`
 
 ### チーム構成
 
@@ -522,10 +522,10 @@ npx cc-sdd@latest --cursor --lang ja --yes
 
 ```bash
 # ターミナル1: プロジェクトA
-cd ~/work/projects/customer-a-service-1
+cd ~/work/projects/20240115-payment-api
 
 # ターミナル2: プロジェクトB
-cd ~/work/projects/customer-b-api
+cd ~/work/projects/20240201-user-management
 
 # ターミナル3: Michiハブ（横断操作用）
 cd ~/work/projects/michi
@@ -539,8 +539,8 @@ cd ~/work/projects/michi
 {
   "folders": [
     { "path": "../michi" },
-    { "path": "../customer-a-service-1" },
-    { "path": "../customer-b-api" }
+    { "path": "../20240115-payment-api" },
+    { "path": "../20240201-user-management" }
   ],
   "settings": {
     "files.associations": {
@@ -571,6 +571,6 @@ npm run multi-estimate
 ## 参考ドキュメント
 
 - [セットアップガイド](./setup.md)
-- [ワークフローガイド](./workflow.md)
-- [マルチプロジェクト管理](./multi-project.md)
+- [ワークフローガイド](../guides/workflow.md)
+- [マルチプロジェクト管理](../guides/multi-project.md)
 

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

@@ -0,0 +1,145 @@
+# Michi クイックスタート
+
+このガイドでは、Michiを5分で始める方法を説明します。
+
+## 前提条件
+
+- Node.js 20.x以上
+- Cursor IDE または VS Code
+
+## 1. Michiをインストール
+
+```bash
+# NPMパッケージからインストール（推奨）
+npm install -g @sk8metal/michi-cli
+
+# インストール確認
+michi --version
+michi --help
+```
+
+**注意**: 初回実行時は依存関係のダウンロードに時間がかかる場合があります。
+
+## 2. cc-sddをインストール
+
+```bash
+# Cursor IDE を使用する場合
+npx cc-sdd@latest --lang ja --cursor
+
+# Claude Code を使用する場合
+npx cc-sdd@latest --lang ja --claude
+```
+
+cc-sddは、Michiの仕様駆動開発ワークフローのコアフレームワークです。
+
+## 3. 環境変数を設定
+
+最小限の設定で始める場合:
+
+```bash
+# プロジェクトディレクトリに移動
+cd your-project
+
+# .envファイルを作成
+cat > .env <<EOF
+# GitHub設定（必須）
+GITHUB_TOKEN=your-github-token
+GITHUB_ORG=your-org
+GITHUB_REPO=your-org/your-repo
+
+# JIRA設定（オプション）
+ATLASSIAN_URL=https://your-domain.atlassian.net
+ATLASSIAN_EMAIL=your-email@company.com
+ATLASSIAN_API_TOKEN=your-token
+JIRA_PROJECT_KEYS=YOUR_PROJECT
+
+# JIRA Issue Type IDs（JIRAインスタンス固有 - 必須）
+JIRA_ISSUE_TYPE_STORY=10036
+JIRA_ISSUE_TYPE_SUBTASK=10037
+EOF
+```
+
+詳細な設定方法は、[セットアップガイド](./setup.md#3-環境変数の設定)を参照してください。
+
+## 4. 最初の機能を作成
+
+Cursor/VS CodeでAIコマンドを実行：
+
+```
+/kiro:spec-init ユーザー認証機能
+```
+
+これにより、`.kiro/specs/user-authentication/`ディレクトリが作成され、以下が自動生成されます：
+
+- `requirements.md`: 要件定義
+- `spec.json`: 機能メタデータ
+
+## 5. 設計を作成
+
+```
+/kiro:spec-design user-authentication
+```
+
+これにより、`design.md`が生成されます。
+
+## 6. タスクを作成
+
+```
+/kiro:spec-tasks user-authentication
+```
+
+これにより、以下が自動実行されます：
+
+- `tasks.md`の生成
+- Confluenceページの自動作成（要件・設計）
+- JIRA Epicとストーリーの自動作成
+
+## 7. 実装を開始
+
+```
+/kiro:spec-impl user-authentication task-1
+```
+
+TDD（テスト駆動開発）で実装が進められます。
+
+## 次のステップ
+
+### より詳しく学ぶ
+
+- [ワークフローガイド](../guides/workflow.md) - AI開発フローの詳細
+- [フェーズ自動化ガイド](../guides/phase-automation.md) - Confluence/JIRA自動化
+- [クイックリファレンス](../reference/quick-reference.md) - コマンド一覧
+
+### 高度な設定
+
+- [カスタマイズガイド](../guides/customization.md) - Confluence/JIRA階層のカスタマイズ
+- [設定値リファレンス](../reference/config.md) - `.michi/config.json`の全設定値
+
+### 複数プロジェクトの管理
+
+- [マルチプロジェクト管理](../guides/multi-project.md) - 3-5プロジェクトの同時管理
+
+## トラブルシューティング
+
+### GitHub Tokenが無効
+
+```bash
+gh auth login
+gh auth token
+```
+
+### JIRA Issue Type IDが不明
+
+```bash
+# REST APIで確認
+curl -u your-email@company.com:your-token \
+  https://your-domain.atlassian.net/rest/api/3/issuetype
+```
+
+### コマンドが見つからない
+
+Cursor/VS Codeを再起動してください。
+
+## ヘルプ
+
+質問がある場合は、[issue](https://github.com/sk8metalme/michi/issues)を作成してください。

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

@@ -9,18 +9,45 @@
 - GitHub CLI (gh) - PR作成時に使用
 - **cc-sdd**: AI駆動開発ワークフローのコアフレームワーク
 
-## 1. リポジトリのクローン
+## 1. Michiのインストール
+
+### 方法1: NPMパッケージとしてインストール（推奨）
 
 ```bash
-# Gitを使う場合（一般的）
+# グローバルインストール
+npm install -g @sk8metal/michi-cli
+
+# インストール確認
+michi --version
+michi --help
+```
+
+**注意**: 初回実行時は依存関係のダウンロードに時間がかかる場合があります。
+
+### 方法2: リポジトリから使用（開発者向け）
+
+Michiの開発に貢献したい場合や、最新の開発版を使用したい場合:
+
+```bash
+# リポジトリをクローン
 git clone https://github.com/sk8metalme/michi
 cd michi
 
-# Jujutsu (jj) を使う場合
-# jj git clone https://github.com/sk8metalme/michi
-# cd michi
+# 依存関係をインストール
+npm install
+
+# ビルド
+npm run build
+
+# グローバルコマンドとしてリンク
+npm link
+
+# 使用
+michi --help
 ```
 
+詳細は [開発環境セットアップガイド](../contributing/development.md)を参照してください。
+
 ## 2. cc-sddのインストール
 
 cc-sddは、Michiの仕様駆動開発ワークフローのコアフレームワークです。
@@ -52,22 +79,16 @@ npx cc-sdd@next --lang ja --windsurf
 
 詳細: [cc-sdd公式ドキュメント](https://github.com/gotalab/cc-sdd/blob/main/tools/cc-sdd/README_ja.md)
 
-## 3. 依存関係のインストール
+## 3. 環境変数の設定
 
-```bash
-npm install
-```
-
-## 4. 環境変数の設定
-
-### 4-1. .env ファイルの作成
+### 3-1. .env ファイルの作成
 
 ```bash
 # テンプレートファイルをコピー
 cp env.example .env
 ```
 
-### 4-2. 認証情報の設定
+### 3-2. 認証情報の設定
 
 `.env` ファイルを編集して、実際の認証情報を設定します：
 
@@ -111,7 +132,7 @@ APPROVAL_GATES_DESIGN=architect,director
 APPROVAL_GATES_RELEASE=sm,director
 ```
 
-### 4-3. ワークフロー承認ゲートの設定（オプション）
+### 3-3. ワークフロー承認ゲートの設定（オプション）
 
 ワークフロー実行時（`michi workflow:run`）の承認ゲートで使用するロール名を設定できます。
 
@@ -168,7 +189,7 @@ APPROVAL_GATES_RELEASE=リリースマネージャー,QAリード,部長
 - 空のロール名は無視されます
 - 環境変数が未設定の場合は、デフォルト値が使用されます
 
-### 4-4. 認証トークンの取得方法
+### 3-4. 認証トークンの取得方法
 
 #### Atlassian API Token
 1. https://id.atlassian.com/manage-profile/security/api-tokens にアクセス
@@ -190,9 +211,9 @@ gh auth token
 3. Incoming Webhooks を有効化
 4. Webhook URL を生成して `.env` に設定
 
-## 5. Atlassian MCP サーバーの設定
+## 4. Atlassian MCP サーバーの設定
 
-### 5-1. MCP設定ファイルの作成
+### 4-1. MCP設定ファイルの作成
 
 プロジェクトルートの `mcp.json.example` を参考に、ホームディレクトリに `~/.cursor/mcp.json` を作成：
 
@@ -202,7 +223,7 @@ mkdir -p ~/.cursor
 cp mcp.json.example ~/.cursor/mcp.json
 ```
 
-### 5-2. 実際の認証情報に置き換え
+### 4-2. 実際の認証情報に置き換え
 
 `~/.cursor/mcp.json` を編集して、`.env` と同じ認証情報を設定：
 
@@ -222,7 +243,7 @@ cp mcp.json.example ~/.cursor/mcp.json
 }
 ```
 
-## 6. プロジェクトメタデータの確認
+## 5. プロジェクトメタデータの確認
 
 `.kiro/project.json` を確認・編集：
 
@@ -238,13 +259,15 @@ cp mcp.json.example ~/.cursor/mcp.json
 }
 ```
 
-## 6-2. プロジェクト固有設定ファイル（オプション）
+## 5-2. プロジェクト固有設定ファイル（オプション）
 
-`.kiro/config.json` を作成することで、Confluence/JIRAの動作をカスタマイズできます。
+`.michi/config.json` を作成することで、Confluence/JIRAの動作をカスタマイズできます。
 
 ### 設定ファイルの作成
 
-プロジェクトルートに `.kiro/config.json` を作成：
+プロジェクトルートに `.michi/config.json` を作成：
+
+**注意**: 以前は `.kiro/config.json` を使用していましたが、Michi専用の設定ファイルとして `.michi/config.json` に変更されました。
 
 ```json
 {
@@ -282,14 +305,14 @@ cp mcp.json.example ~/.cursor/mcp.json
 
 ### 設定値の詳細
 
-すべての設定値の詳細は [設定値リファレンス](./config-reference.md) を参照してください。
+すべての設定値の詳細は [設定値リファレンス](../reference/config.md) を参照してください。
 
 ### 設定の優先順位
 
 設定値は以下の優先順位で決定されます：
 
 1. **`spec.json`**: 機能固有の設定（最優先）
-2. **`.kiro/config.json`**: プロジェクト固有の設定
+2. **`.michi/config.json`**: プロジェクト固有の設定
 3. **環境変数**: システム環境変数または`.env`ファイル
 4. **デフォルト値**: スキーマで定義されたデフォルト値
 
@@ -307,17 +330,17 @@ npx tsx /path/to/michi/scripts/utils/config-validator.ts /path/to/project
 
 ### よくある設定パターン
 
-詳細は [カスタマイズガイド](./customization-guide.md) を参照してください。
+詳細は [カスタマイズガイド](../guides/customization.md) を参照してください。
 
-## 7. Cursor IDE の設定
+## 6. Cursor IDE の設定
 
-### 7-1. Cursor でプロジェクトを開く
+### 6-1. Cursor でプロジェクトを開く
 
 ```bash
 cursor .
 ```
 
-### 7-2. 利用可能なコマンドの確認
+### 6-2. 利用可能なコマンドの確認
 
 Cursor のコマンドパネル（Cmd+Shift+P）で `/kiro:` と入力すると、以下のコマンドが表示されます：
 
@@ -330,32 +353,23 @@ Cursor のコマンドパネル（Cmd+Shift+P）で `/kiro:` と入力すると
 
 凡例の詳細は [README.md#凡例の記号説明](../README.md#凡例の記号説明) を参照してください。
 
-## 8. 動作確認
+## 7. 動作確認
 
-### 8-1. TypeScript コンパイル確認
+### 7-1. 基本的な動作確認
 
 ```bash
-npm run type-check
-```
+# Michiコマンドが利用可能か確認
+michi --version
 
-### 8-2. スクリプトの動作確認
+# ヘルプを表示
+michi --help
 
-```bash
-# プロジェクト一覧の表示（準備中）
-npm run project:list
+# 利用可能なコマンド一覧
+michi help
 ```
 
 ## トラブルシューティング
 
-### npm install でエラーが出る
-
-キャッシュをクリア：
-```bash
-npm cache clean --force
-rm -rf node_modules package-lock.json
-npm install
-```
-
 ### MCP サーバーが動作しない
 
 1. Cursor を再起動
@@ -374,9 +388,9 @@ gh auth setup-git
 
 セットアップが完了したら、以下のドキュメントを参照：
 
-- [ワークフローガイド](./workflow.md) - AI開発フロー
-- [マルチプロジェクト管理](./multi-project.md) - 複数プロジェクト管理
-- [API仕様](./api.md) - スクリプトAPI仕様
+- [クイックスタート](./quick-start.md) - 5分で始める
+- [ワークフローガイド](../guides/workflow.md) - AI開発フロー
+- [マルチプロジェクト管理](../guides/multi-project.md) - 複数プロジェクト管理
 
 ## 参考リンク