@sk8metal/michi-cli 0.0.4 → 0.0.6

package/docs/{config-reference.md → reference/config.md}

@@ -1,10 +1,12 @@
 # 設定値リファレンス
 
-このドキュメントでは、`.kiro/config.json`で設定可能なすべての設定値について説明します。
+このドキュメントでは、`.michi/config.json`で設定可能なすべての設定値について説明します。
 
 ## 設定ファイルの場所
 
-プロジェクトルートの `.kiro/config.json` に設定を記述します。
+プロジェクトルートの `.michi/config.json` に設定を記述します。
+
+**注意**: 以前は `.kiro/config.json` を使用していましたが、Michi専用の設定ファイルとして `.michi/config.json` に変更されました。`.kiro/config.json` が存在する場合は警告が表示されます。
 
 ```json
 {
@@ -16,50 +18,15 @@
 
 ## Confluence設定
 
-### `confluence.pageCreationGranularity`
-
-**型**: `'single' | 'by-section' | 'by-hierarchy' | 'manual'`  
-**デフォルト**: `'single'`  
-**必須**: いいえ
-
-ページ作成の粒度を指定します。
-
-- `'single'`: 1つのMarkdownファイルを1つのConfluenceページとして作成
-- `'by-section'`: Markdownのセクションごとにページを作成
-- `'by-hierarchy'`: 階層構造に基づいてページを作成（`hierarchy`設定が必要）
-- `'manual'`: 手動で定義した構造に基づいてページを作成（`hierarchy.structure`設定が必要）
-
-### `confluence.pageTitleFormat`
-
-**型**: `string`  
-**デフォルト**: `'[{projectName}] {featureName} {docTypeLabel}'`  
-**必須**: いいえ
-
-ページタイトルのフォーマットを指定します。以下のプレースホルダーが使用できます：
-
-- `{projectName}`: プロジェクト名（`.kiro/project.json`から取得）
-- `{featureName}`: 機能名
-- `{docTypeLabel}`: ドキュメントタイプのラベル（要件定義、設計書、タスク）
+| 設定項目 | 型 | デフォルト | 必須 | 説明 | 値の説明 |
+|---------|-----|-----------|------|------|---------|
+| `confluence.pageCreationGranularity` | `'single' \| 'by-section' \| 'by-hierarchy' \| 'manual'` | `'single'` | いいえ | ページ作成の粒度を指定 | `'single'`: 1つのMarkdownファイルを1つのConfluenceページとして作成<br>`'by-section'`: Markdownのセクションごとにページを作成<br>`'by-hierarchy'`: 階層構造に基づいてページを作成（`hierarchy`設定が必要）<br>`'manual'`: 手動で定義した構造に基づいてページを作成（`hierarchy.structure`設定が必要） |
+| `confluence.pageTitleFormat` | `string` | `'[{projectName}] {featureName} {docTypeLabel}'` | いいえ | ページタイトルのフォーマットを指定 | プレースホルダー: `{projectName}`（プロジェクト名）、`{featureName}`（機能名）、`{docTypeLabel}`（ドキュメントタイプのラベル） |
+| `confluence.autoLabels` | `string[]` | `['{projectLabel}', '{docType}', '{featureName}', 'github-sync']` | いいえ | Confluenceページに自動的に付与するラベルのリスト | プレースホルダー: `{projectLabel}`（プロジェクトラベル）、`{docType}`（ドキュメントタイプ）、`{featureName}`（機能名） |
+| `confluence.spaces` | `{ requirements?: string, design?: string, tasks?: string }` | 環境変数`CONFLUENCE_PRD_SPACE`、または`'PRD'` | いいえ（推奨） | 各ドキュメントタイプをどのConfluenceスペースに作成するかを指定 | `requirements`: 要件定義用スペース<br>`design`: 設計用スペース<br>`tasks`: タスク用スペース |
+| `confluence.hierarchy` | `{ mode?: 'simple' \| 'nested', parentPageTitle?: string, createDocTypeParents?: boolean, structure?: object }` | なし | `pageCreationGranularity`が`'by-hierarchy'`または`'manual'`の場合 | 階層構造の設定 | 詳細は下記の子項目を参照 |
 
-### `confluence.autoLabels`
-
-**型**: `string[]`  
-**デフォルト**: `['{projectLabel}', '{docType}', '{featureName}', 'github-sync']`  
-**必須**: いいえ
-
-Confluenceページに自動的に付与するラベルのリスト。以下のプレースホルダーが使用できます：
-
-- `{projectLabel}`: プロジェクトラベル（`project:michi`など）
-- `{docType}`: ドキュメントタイプ（`requirements`, `design`, `tasks`）
-- `{featureName}`: 機能名
-
-### `confluence.spaces`
-
-**型**: `{ requirements?: string, design?: string, tasks?: string }`  
-**デフォルト**: 環境変数`CONFLUENCE_PRD_SPACE`、または`'PRD'`  
-**必須**: いいえ（推奨）
-
-各ドキュメントタイプをどのConfluenceスペースに作成するかを指定します。
+### `confluence.spaces` の設定例
 
 ```json
 {
@@ -75,110 +42,27 @@ Confluenceページに自動的に付与するラベルのリスト。以下の
 
 **注意**: 設定されていない場合、環境変数`CONFLUENCE_PRD_SPACE`が使用されます。それもない場合は`'PRD'`がデフォルト値として使用されます。
 
-### `confluence.hierarchy`
-
-**型**: `{ mode?: 'simple' | 'nested', parentPageTitle?: string, createDocTypeParents?: boolean, structure?: object }`  
-**デフォルト**: なし  
-**必須**: `pageCreationGranularity`が`'by-hierarchy'`または`'manual'`の場合
-
-階層構造の設定です。
+### `confluence.hierarchy` の子項目
 
-#### `confluence.hierarchy.mode`
-
-**型**: `'simple' | 'nested'`  
-**デフォルト**: `'simple'`  
-**必須**: いいえ
-
-階層構造のモードを指定します。
-
-- `'simple'`: シンプルな親子構造
-- `'nested'`: ネストされた階層構造
-
-#### `confluence.hierarchy.parentPageTitle`
-
-**型**: `string`  
-**デフォルト**: なし  
-**必須**: `pageCreationGranularity`が`'by-hierarchy'`の場合（推奨）
-
-親ページのタイトルフォーマットを指定します。プレースホルダーが使用できます：
-
-- `{projectName}`: プロジェクト名
-- `{featureName}`: 機能名
-
-例: `"[{projectName}] {featureName}"`
-
-#### `confluence.hierarchy.createDocTypeParents`
-
-**型**: `boolean`  
-**デフォルト**: `false`  
-**必須**: いいえ
-
-ドキュメントタイプごとの親ページを作成するかどうかを指定します。
-
-#### `confluence.hierarchy.structure`
-
-**型**: `object`  
-**デフォルト**: なし  
-**必須**: `pageCreationGranularity`が`'manual'`の場合
-
-手動で定義した階層構造。詳細は実装を参照してください。
+| 設定項目 | 型 | デフォルト | 必須 | 説明 | 値の説明 |
+|---------|-----|-----------|------|------|---------|
+| `confluence.hierarchy.mode` | `'simple' \| 'nested'` | `'simple'` | いいえ | 階層構造のモードを指定 | `'simple'`: シンプルな親子構造<br>`'nested'`: ネストされた階層構造 |
+| `confluence.hierarchy.parentPageTitle` | `string` | なし | `pageCreationGranularity`が`'by-hierarchy'`の場合（推奨） | 親ページのタイトルフォーマットを指定 | プレースホルダー: `{projectName}`（プロジェクト名）、`{featureName}`（機能名）<br>例: `"[{projectName}] {featureName}"` |
+| `confluence.hierarchy.createDocTypeParents` | `boolean` | `false` | いいえ | ドキュメントタイプごとの親ページを作成するかどうかを指定 | `true`: 作成する<br>`false`: 作成しない |
+| `confluence.hierarchy.structure` | `object` | なし | `pageCreationGranularity`が`'manual'`の場合 | 手動で定義した階層構造 | 詳細は実装を参照してください |
 
 ## JIRA設定
 
-### `jira.storyCreationGranularity`
-
-**型**: `'all' | 'by-phase' | 'selected-phases'`  
-**デフォルト**: `'all'`  
-**必須**: いいえ
-
-ストーリー作成の粒度を指定します。
+| 設定項目 | 型 | デフォルト | 必須 | 説明 | 値の説明 |
+|---------|-----|-----------|------|------|---------|
+| `jira.storyCreationGranularity` | `'all' \| 'by-phase' \| 'selected-phases'` | `'all'` | いいえ | ストーリー作成の粒度を指定 | `'all'`: すべてのフェーズのストーリーを作成<br>`'by-phase'`: フェーズごとにストーリーを作成<br>`'selected-phases'`: `selectedPhases`で指定したフェーズのみストーリーを作成 |
+| `jira.createEpic` | `boolean` | `true` | いいえ | Epicを作成するかどうかを指定 | `true`: Epicを作成<br>`false`: Epicを作成しない |
+| `jira.storyPoints` | `'auto' \| 'manual' \| 'disabled'` | `'auto'` | いいえ | ストーリーポイントの設定方法を指定 | `'auto'`: 自動計算<br>`'manual'`: 手動設定（tasks.mdから取得）<br>`'disabled'`: ストーリーポイントを設定しない |
+| `jira.autoLabels` | `string[]` | `['{projectLabel}', '{featureName}', '{phaseLabel}']` | いいえ | JIRAチケットに自動的に付与するラベルのリスト | プレースホルダー: `{projectLabel}`（プロジェクトラベル）、`{featureName}`（機能名）、`{phaseLabel}`（フェーズラベル） |
+| `jira.issueTypes` | `{ epic?: string, story?: string, subtask?: string }` | `{ epic: 'Epic', story: null, subtask: null }` | いいえ（`story`は推奨） | JIRAのIssue Type IDを指定 | `epic`: EpicのIssue Type ID<br>`story`: StoryのIssue Type ID（環境変数`JIRA_ISSUE_TYPE_STORY`でも設定可能）<br>`subtask`: SubtaskのIssue Type ID（環境変数`JIRA_ISSUE_TYPE_SUBTASK`でも設定可能） |
+| `jira.selectedPhases` | `string[]` | なし | `storyCreationGranularity`が`'selected-phases'`の場合 | ストーリーを作成するフェーズのリスト | 例: `['Requirements', 'Design', 'Implementation']` |
 
-- `'all'`: すべてのフェーズのストーリーを作成
-- `'by-phase'`: フェーズごとにストーリーを作成
-- `'selected-phases'`: `selectedPhases`で指定したフェーズのみストーリーを作成
-
-### `jira.createEpic`
-
-**型**: `boolean`  
-**デフォルト**: `true`  
-**必須**: いいえ
-
-Epicを作成するかどうかを指定します。
-
-### `jira.storyPoints`
-
-**型**: `'auto' | 'manual' | 'disabled'`  
-**デフォルト**: `'auto'`  
-**必須**: いいえ
-
-ストーリーポイントの設定方法を指定します。
-
-- `'auto'`: 自動計算
-- `'manual'`: 手動設定（tasks.mdから取得）
-- `'disabled'`: ストーリーポイントを設定しない
-
-### `jira.autoLabels`
-
-**型**: `string[]`  
-**デフォルト**: `['{projectLabel}', '{featureName}', '{phaseLabel}']`  
-**必須**: いいえ
-
-JIRAチケットに自動的に付与するラベルのリスト。以下のプレースホルダーが使用できます：
-
-- `{projectLabel}`: プロジェクトラベル（`project:michi`など）
-- `{featureName}`: 機能名
-- `{phaseLabel}`: フェーズラベル（`Requirements`, `Design`など）
-
-### `jira.issueTypes`
-
-**型**: `{ epic?: string, story?: string, subtask?: string }`  
-**デフォルト**: `{ epic: 'Epic', story: null, subtask: null }`  
-**必須**: いいえ（`story`は推奨）
-
-JIRAのIssue Type IDを指定します。`story`と`subtask`は環境変数でも設定可能です：
-
-- `JIRA_ISSUE_TYPE_STORY`: StoryのIssue Type ID
-- `JIRA_ISSUE_TYPE_SUBTASK`: SubtaskのIssue Type ID
+### `jira.issueTypes` の詳細
 
 **注意**: `story`が設定されていない場合、環境変数`JIRA_ISSUE_TYPE_STORY`が使用されます。それもない場合はエラーになります。
 
@@ -186,33 +70,15 @@ JIRAのIssue Type IDを指定します。`story`と`subtask`は環境変数で
 - JIRA管理画面: Settings > Issues > Issue types
 - REST API: `GET https://your-domain.atlassian.net/rest/api/3/issuetype`
 
-### `jira.selectedPhases`
-
-**型**: `string[]`  
-**デフォルト**: なし  
-**必須**: `storyCreationGranularity`が`'selected-phases'`の場合
-
-ストーリーを作成するフェーズのリスト。例: `['Requirements', 'Design', 'Implementation']`
-
 ## ワークフロー設定
 
-### `workflow.enabledPhases`
-
-**型**: `string[]`  
-**デフォルト**: `['requirements', 'design', 'tasks']`  
-**必須**: いいえ
-
-有効化するフェーズのリスト。有効な値: `'requirements'`, `'design'`, `'tasks'`
+| 設定項目 | 型 | デフォルト | 必須 | 説明 | 値の説明 |
+|---------|-----|-----------|------|------|---------|
+| `workflow.enabledPhases` | `string[]` | `['requirements', 'design', 'tasks']` | いいえ | 有効化するフェーズのリスト | 有効な値: `'requirements'`, `'design'`, `'tasks'` |
+| `workflow.approvalGates` | `{ requirements?: string[], design?: string[], release?: string[] }` | なし | いいえ | 各フェーズの承認ゲートを指定 | 承認者のロール名のリストを指定<br>`requirements`: 要件定義フェーズの承認者<br>`design`: 設計フェーズの承認者<br>`release`: リリースフェーズの承認者 |
 
-### `workflow.approvalGates`
+### `workflow.approvalGates` の設定例
 
-**型**: `{ requirements?: string[], design?: string[], release?: string[] }`  
-**デフォルト**: なし  
-**必須**: いいえ
-
-各フェーズの承認ゲートを指定します。承認者のロール名のリストを指定します。
-
-例:
 ```json
 {
   "workflow": {
@@ -229,30 +95,39 @@ JIRAのIssue Type IDを指定します。`story`と`subtask`は環境変数で
 
 一部の設定値は環境変数でも設定可能です。環境変数の設定は`.env`ファイルに記述します。
 
+### Atlassian共通設定
+
+| 環境変数名 | 対応する設定項目 | 説明 | デフォルト |
+|-----------|----------------|------|-----------|
+| `ATLASSIAN_REQUEST_DELAY` | - | Confluence/JIRA APIリクエスト間の遅延時間（ミリ秒） | `500` |
+
 ### Confluence関連
 
-- `CONFLUENCE_PRD_SPACE`: Confluenceスペースキー（`confluence.spaces`のデフォルト値）
-- `CONFLUENCE_BASE_URL`: ConfluenceのベースURL
-- `CONFLUENCE_USERNAME`: Confluenceのユーザー名
-- `CONFLUENCE_API_TOKEN`: ConfluenceのAPIトークン
-- `ATLASSIAN_REQUEST_DELAY`: リクエスト間の遅延時間（ミリ秒）
+| 環境変数名 | 対応する設定項目 | 説明 | デフォルト |
+|-----------|----------------|------|-----------|
+| `CONFLUENCE_PRD_SPACE` | `confluence.spaces` | Confluenceスペースキー（`confluence.spaces`のデフォルト値） | `'PRD'` |
+| `CONFLUENCE_BASE_URL` | - | ConfluenceのベースURL | なし |
+| `CONFLUENCE_USERNAME` | - | Confluenceのユーザー名 | なし |
+| `CONFLUENCE_API_TOKEN` | - | ConfluenceのAPIトークン | なし |
 
 ### JIRA関連
 
-- `JIRA_BASE_URL`: JIRAのベースURL
-- `JIRA_USERNAME`: JIRAのユーザー名
-- `JIRA_API_TOKEN`: JIRAのAPIトークン
-- `JIRA_PROJECT_KEY`: JIRAプロジェクトキー（`.kiro/project.json`からも取得可能）
-- `JIRA_ISSUE_TYPE_STORY`: StoryのIssue Type ID
-- `JIRA_ISSUE_TYPE_SUBTASK`: SubtaskのIssue Type ID
-- `JIRA_EPIC_LINK_FIELD`: Epic LinkカスタムフィールドID（例: `customfield_10014`）
+| 環境変数名 | 対応する設定項目 | 説明 | デフォルト |
+|-----------|----------------|------|-----------|
+| `JIRA_BASE_URL` | - | JIRAのベースURL | なし |
+| `JIRA_USERNAME` | - | JIRAのユーザー名 | なし |
+| `JIRA_API_TOKEN` | - | JIRAのAPIトークン | なし |
+| `JIRA_PROJECT_KEY` | - | JIRAプロジェクトキー（`.kiro/project.json`からも取得可能） | なし |
+| `JIRA_ISSUE_TYPE_STORY` | `jira.issueTypes.story` | StoryのIssue Type ID | なし |
+| `JIRA_ISSUE_TYPE_SUBTASK` | `jira.issueTypes.subtask` | SubtaskのIssue Type ID | なし |
+| `JIRA_EPIC_LINK_FIELD` | - | Epic LinkカスタムフィールドID（例: `customfield_10014`） | なし |
 
 ## 設定の優先順位
 
 設定値は以下の優先順位で決定されます：
 
 1. **`spec.json`**: 機能固有の設定（最優先）
-2. **`.kiro/config.json`**: プロジェクト固有の設定
+2. **`.michi/config.json`**: プロジェクト固有の設定
 3. **環境変数**: システム環境変数または`.env`ファイル
 4. **デフォルト値**: スキーマで定義されたデフォルト値
 
@@ -312,8 +187,8 @@ JIRAのIssue Type IDを指定します。`story`と`subtask`は環境変数で
     "storyCreationGranularity": "all",
     "storyPoints": "auto",
     "issueTypes": {
-      "story": "10036",
-      "subtask": "10037"
+      "story": "1",
+      "subtask": "2"
     }
   },
   "workflow": {
@@ -365,8 +240,8 @@ JIRAのIssue Type IDを指定します。`story`と`subtask`は環境変数で
     "autoLabels": ["{projectLabel}", "{featureName}", "{phaseLabel}"],
     "issueTypes": {
       "epic": "Epic",
-      "story": "10036",
-      "subtask": "10037"
+      "story": "1",
+      "subtask": "2"
     }
   },
   "workflow": {
@@ -413,8 +288,8 @@ JIRAのIssue Type IDを指定します。`story`と`subtask`は環境変数で
     "storyCreationGranularity": "all",
     "storyPoints": "auto",
     "issueTypes": {
-      "story": "10036",
-      "subtask": "10037"
+      "story": "1",
+      "subtask": "2"
     }
   },
   "workflow": {
@@ -455,7 +330,11 @@ JIRAのIssue Type IDを指定します。`story`と`subtask`は環境変数で
 バリデーションを手動で実行する場合：
 
 ```bash
-tsx scripts/utils/config-validator.ts
+# 推奨: npmスクリプト経由
+npm run config:validate
+
+# または、npx経由
+npx tsx scripts/utils/config-validator.ts
 ```
 
 ## トラブルシューティング
@@ -467,14 +346,14 @@ tsx scripts/utils/config-validator.ts
 **原因と解決方法**:
 
 1. **JSON構文エラー**
-   - `.kiro/config.json`のJSON構文が正しいか確認
+   - `.michi/config.json`のJSON構文が正しいか確認
    - JSONバリデーターを使用: `npx tsx scripts/utils/config-validator.ts`
    - よくあるエラー: 末尾のカンマ、引用符の不一致
 
 2. **設定ファイルのパスが間違っている**
-   - 設定ファイルのパスが正しいか確認（プロジェクトルートの`.kiro/config.json`）
+   - 設定ファイルのパスが正しいか確認（プロジェクトルートの`.michi/config.json`）
    - 現在のディレクトリを確認: `pwd`
-   - 設定ファイルの存在確認: `ls -la .kiro/config.json`
+   - 設定ファイルの存在確認: `ls -la .michi/config.json`
 
 3. **優先順位の問題**
    - 環境変数が設定されている場合、環境変数の優先順位を確認
@@ -482,7 +361,7 @@ tsx scripts/utils/config-validator.ts
    - 設定の優先順位: `spec.json` > `config.json` > 環境変数 > デフォルト値
 
 4. **設定ファイルの読み込みエラー**
-   - 設定ファイルの権限を確認: `chmod 644 .kiro/config.json`
+   - 設定ファイルの権限を確認: `chmod 644 .michi/config.json`
    - ファイルエンコーディングを確認（UTF-8推奨）
 
 ### 必須設定値エラー
@@ -500,7 +379,7 @@ tsx scripts/utils/config-validator.ts
 ```
 
 **解決方法**:
-1. `.kiro/config.json`に以下を追加:
+1. `.michi/config.json`に以下を追加:
 ```json
 {
   "jira": {
@@ -529,7 +408,7 @@ export JIRA_ISSUE_TYPE_STORY=10036
 ```
 
 **解決方法**:
-`.kiro/config.json`に以下を追加:
+`.michi/config.json`に以下を追加:
 ```json
 {
   "confluence": {
@@ -560,7 +439,7 @@ export JIRA_ISSUE_TYPE_STORY=10036
 ```
 
 **解決方法**:
-1. `.kiro/config.json`に以下を追加:
+1. `.michi/config.json`に以下を追加:
 ```json
 {
   "confluence": {
@@ -621,7 +500,7 @@ export CONFLUENCE_PRD_SPACE=Michi
    - JIRA同期時: 設定値のソースが表示される
 
 2. **設定ファイルの優先順位を理解**
-   - `spec.json` > `.kiro/config.json` > 環境変数 > デフォルト値
+   - `spec.json` > `.michi/config.json` > 環境変数 > デフォルト値
    - 同じ設定値が複数箇所にある場合、優先順位の高いものが使用される
 
 3. **デバッグ方法**
@@ -655,12 +534,12 @@ A: プロジェクト固有の設定は`config.json`に、個人固有の設定
 
 A: 
 - `spec.json`: 機能固有の設定（`.kiro/specs/<feature>/spec.json`）
-- `config.json`: プロジェクト全体の設定（`.kiro/config.json`）
+- `config.json`: プロジェクト全体の設定（`.michi/config.json`）
 - `spec.json`が最優先で、機能ごとに異なる設定が可能
 
 **Q: 設定ファイルをGitで管理すべきか**
 
 A: 
-- `.kiro/config.json`: チーム固有設定のため、`.gitignore`に追加することを推奨
+- `.michi/config.json`: チーム固有設定のため、`.gitignore`に追加することを推奨
 - `spec.json`: 機能仕様の一部のため、Gitで管理することを推奨
 

package/docs/{quick-reference.md → reference/quick-reference.md}

@@ -30,15 +30,15 @@ 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"
 ```
 
 **リポジトリ名**: `--name`で指定した値がそのままGitHubリポジトリ名として使用されます。
 
 **例**:
-- `--name "customer-a-service-1"` → GitHubリポジトリ: `org/customer-a-service-1`
+- `--name "20240115-payment-api"` → GitHubリポジトリ: `org/20240115-payment-api`
 - `--name "payment-api"` → GitHubリポジトリ: `org/payment-api`
 
 **注意**: リポジトリ名はkebab-case（小文字、ハイフン区切り）を推奨します。
@@ -113,19 +113,22 @@ jj git push --bookmark <project-id>/feature/<feature> --allow-new
 gh pr create --head <project-id>/feature/<feature> --base init
 ```
 
-## Cursorコマンド一覧
-
-| コマンド | 説明 |
-|---------|------|
-| `/kiro:spec-init <description>` | 仕様初期化 |
-| `/kiro:spec-requirements <feature>` | 要件定義生成 |
-| `/kiro:spec-design <feature>` | 設計生成 |
-| `/kiro:spec-tasks <feature>` | タスク分割 |
-| `/kiro:spec-impl <feature> <tasks>` | TDD実装 |
-| `/kiro:spec-status <feature>` | 進捗確認 |
-| `/kiro:steering` | Steering作成/更新 |
-| `/kiro:confluence-sync <feature> [type]` | Confluence同期 |
-| `/kiro:project-switch <project_id>` | プロジェクト切り替え |
+## コマンド一覧
+
+| コマンド | 説明 | 分類 |
+|---------|------|------|
+| `/kiro:spec-init <description>` | 仕様初期化 | cc-sdd |
+| `/kiro:spec-requirements <feature>` | 要件定義生成 | cc-sdd |
+| `/kiro:spec-design <feature>` | 設計生成 | cc-sdd |
+| `/kiro:spec-tasks <feature>` | タスク分割 | cc-sdd |
+| `/kiro:spec-impl <feature> <tasks>` | TDD実装 | cc-sdd |
+| `/kiro:spec-status <feature>` | 進捗確認 | cc-sdd |
+| `/kiro:steering` | Steering作成/更新 | cc-sdd |
+| `/kiro:steering-custom` | カスタムSteering作成 | cc-sdd |
+| `/kiro:validate-gap <feature>` | 既存コードと要件の差異分析 | cc-sdd |
+| `/kiro:validate-design <feature>` | 設計の品質レビューと検証 | cc-sdd |
+| `/kiro:confluence-sync <feature> [type]` | Confluence同期 | Michi only |
+| `/kiro:project-switch <project_id>` | プロジェクト切り替え | Michi only |
 
 ## Michi CLIコマンド一覧
 
@@ -141,7 +144,7 @@ gh pr create --head <project-id>/feature/<feature> --base init
 | `michi project:list` | プロジェクト一覧 |
 | `michi project:dashboard` | リソースダッシュボード生成 |
 | `michi workflow:run --feature <name>` | 統合ワークフロー実行 |
-| `michi config:interactive` | 対話式設定ツール（.kiro/config.json作成） |
+| `michi config:interactive` | 対話式設定ツール（.michi/config.json作成） |
 | `michi config:validate` | 設定ファイルのバリデーション |
 | `michi --help` | ヘルプ表示 |
 | `michi --version` | バージョン表示 |
@@ -149,7 +152,7 @@ gh pr create --head <project-id>/feature/<feature> --base init
 **インストール方法**:
 - **npx実行（推奨）**: `npx @michi/cli <command>` - 常に最新版を使用
 - **グローバルインストール**: `npm install -g @michi/cli` 後、`michi <command>`
-- **ローカル開発**: `npm run michi <command>` または `tsx src/cli.ts <command>`
+- **ローカル開発**: `npm run michi <command>` または `npx tsx src/cli.ts <command>`
 
 ## npmスクリプト一覧（michiリポジトリ内）
 
@@ -227,8 +230,8 @@ gh pr create --head <bookmark> --base main
 
 例:
 - `michi/feature/user-auth`
-- `customer-a-service-1/feature/payment`
-- `customer-b-api/feature/user-endpoint`
+- `20240115-payment-api/feature/payment`
+- `20240310-analytics-api/feature/user-endpoint`
 
 ## トラブルシューティング
 

package/env.example

@@ -19,6 +19,8 @@ JIRA_PROJECT_KEYS=PROJECT
 # JIRA Issue Type IDs（JIRAインスタンス固有の値 - 必須）
 # JIRA管理画面（Settings > Issues > Issue types）またはREST APIで確認してください
 # REST API: GET /rest/api/3/issuetype で取得可能
+# 注意: 以下の値（10036, 10037）は例です。実際のJIRAインスタンスのIssue Type IDに置き換えてください
+# 一般的にJIRAのIssue Type IDは5桁の数値（例: 10036, 10037）です
 JIRA_ISSUE_TYPE_STORY=10036
 JIRA_ISSUE_TYPE_SUBTASK=10037
 
@@ -27,7 +29,7 @@ ATLASSIAN_REQUEST_DELAY=500
 
 # Story Pointsカスタムフィールド（JIRAプロジェクト固有）
 # 環境変数 JIRA_STORY_POINTS_FIELD で設定可能（例: customfield_10016）
-JIRA_STORY_POINTS_FIELD=customfield_10016
+JIRA_STORY_POINTS_FIELD=customfield_100
 
 # Epic Linkカスタムフィールド（JIRAプロジェクト固有）
 # 環境変数 JIRA_EPIC_LINK_FIELD で設定可能（例: customfield_10014）

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sk8metal/michi-cli",
-  "version": "0.0.4",
+  "version": "0.0.6",
   "description": "Managed Intelligent Comprehensive Hub for Integration - AI-driven development workflow automation",
   "license": "MIT",
   "type": "module",
@@ -43,6 +43,7 @@
   ],
   "scripts": {
     "build": "tsc",
+    "postbuild": "node scripts/set-permissions.js",
     "prepare": "npm run build",
     "setup:env": "bash scripts/setup-env.sh",
     "create-project": "tsx scripts/create-project.ts",
@@ -67,6 +68,7 @@
     "test:coverage": "vitest --run --coverage",
     "lint": "eslint .",
     "lint:fix": "eslint . --fix",
+    "format": "prettier --write .",
     "type-check": "tsc --noEmit"
   },
   "dependencies": {

package/scripts/config-interactive.ts

@@ -1,6 +1,6 @@
 /**
  * 対話式設定ツール
- * .kiro/config.json を対話的に作成・更新
+ * .michi/config.json を対話的に作成・更新
  */
 
 import { readFileSync, writeFileSync, existsSync } from 'fs';
@@ -373,7 +373,7 @@ async function main(): Promise<void> {
   try {
     console.log('🎨 Michi カスタマイズ設定ツール');
     console.log('='.repeat(60));
-    console.log('このツールで .kiro/config.json を作成・更新できます。\n');
+    console.log('このツールで .michi/config.json を作成・更新できます。\n');
     
     // プロジェクトメタデータを読み込み
     let projectMeta;
@@ -387,7 +387,8 @@ async function main(): Promise<void> {
     }
     
     // 既存の設定ファイルを確認
-    const configPath = resolve(process.cwd(), '.kiro/config.json');
+    const { getConfigPath } = await import('./utils/config-loader.js');
+    const configPath = getConfigPath();
     let existingConfig: any = null;
     
     if (existsSync(configPath)) {

package/scripts/confluence-sync.ts

@@ -10,7 +10,7 @@ import { config } from 'dotenv';
 import { loadProjectMeta, type ProjectMetadata } from './utils/project-meta.js';
 import { convertMarkdownToConfluence, createConfluencePage } from './markdown-to-confluence.js';
 import { validateFeatureNameOrThrow } from './utils/feature-name-validator.js';
-import { getConfig } from './utils/config-loader.js';
+import { getConfig, getConfigPath } from './utils/config-loader.js';
 import { createPagesByGranularity } from './utils/confluence-hierarchy.js';
 import { validateForConfluenceSync } from './utils/config-validator.js';
 
@@ -361,7 +361,7 @@ async function syncToConfluence(
   if (validation.errors.length > 0) {
     console.error('❌ Configuration errors:');
     validation.errors.forEach(error => console.error(`   ${error}`));
-    const configPath = resolve('.kiro/config.json');
+    const configPath = getConfigPath();
     console.error(`\n設定ファイル: ${configPath}`);
     throw new Error('Confluence同期に必要な設定値が不足しています。上記のエラーを確認して設定を修正してください。');
   }

package/scripts/create-project.ts

@@ -4,8 +4,8 @@
  * 
  * 使い方:
  * npm run create-project -- \
- *   --name "customer-a-service-1" \
- *   --project-name "A社 サービス1" \
+ *   --name "20240115-payment-api" \
+ *   --project-name "プロジェクトA" \
  *   --jira-key "PRJA"
  */
 
@@ -22,8 +22,8 @@ const __dirname = dirname(__filename);
 loadDotenv();
 
 interface ProjectConfig {
-  name: string;           // リポジトリ名: customer-a-service-1
-  projectName: string;    // 表示名: A社 サービス1
+  name: string;           // リポジトリ名: 20240115-payment-api
+  projectName: string;    // 表示名: プロジェクトA
   jiraKey: string;        // JIRAキー: PRJA
   org?: string;           // GitHub組織名（デフォルト: .envから）
   labels?: string[];      // Confluenceラベル（デフォルト: 自動生成）

package/scripts/jira-sync.ts

@@ -23,7 +23,7 @@ import axios from 'axios';
 import { config } from 'dotenv';
 import { loadProjectMeta } from './utils/project-meta.js';
 import { validateFeatureNameOrThrow } from './utils/feature-name-validator.js';
-import { getConfig } from './utils/config-loader.js';
+import { getConfig, getConfigPath } from './utils/config-loader.js';
 import { validateForJiraSync } from './utils/config-validator.js';
 
 config();
@@ -355,7 +355,7 @@ async function syncTasksToJIRA(featureName: string): Promise<void> {
   if (validation.errors.length > 0) {
     console.error('❌ Configuration errors:');
     validation.errors.forEach(error => console.error(`   ${error}`));
-    const configPath = resolve('.kiro/config.json');
+    const configPath = getConfigPath();
     console.error(`\n設定ファイル: ${configPath}`);
     throw new Error('JIRA同期に必要な設定値が不足しています。上記のエラーを確認して設定を修正してください。');
   }
@@ -370,7 +370,7 @@ async function syncTasksToJIRA(featureName: string): Promise<void> {
   if (!storyIssueTypeId) {
     throw new Error(
       'JIRA Story issue type ID is not configured. ' +
-      'Please set JIRA_ISSUE_TYPE_STORY environment variable or configure it in .kiro/config.json. ' +
+      'Please set JIRA_ISSUE_TYPE_STORY environment variable or configure it in .michi/config.json. ' +
       'You can find the issue type ID in JIRA UI (Settings > Issues > Issue types) or via REST API: ' +
       'GET https://your-domain.atlassian.net/rest/api/3/issuetype'
     );