@sk8metal/michi-cli 0.0.3 → 0.0.5

package/docs/config-reference.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/customization-guide.md

@@ -4,7 +4,50 @@
 
 ## 概要
 
-Michiでは、チームごとに異なる開発フローに対応するため、Confluence/JIRAの作成粒度やワークフロー設定をカスタマイズ可能にしています。
+Michiでは、チームやPJごとに異なる開発フローに対応するため、Confluence/JIRAの作成粒度やワークフロー設定をカスタマイズ可能にしています。
+
+## cc-sddのカスタマイズとの関係
+
+Michiは[cc-sdd](https://github.com/gotalab/cc-sdd)をベースとしており、カスタマイズには2つの種類があります：
+
+### 1. cc-sddのカスタマイズ（テンプレート・ルール）
+
+**対象**: AIが生成するドキュメントの構造や判断基準
+- **templates/**: `requirements.md`, `design.md`, `tasks.md`の構造・フォーマット
+- **rules/**: AIの判断基準・生成原則
+- **steering/**: プロジェクトメモリ（`/kiro:steering-custom`で作成）
+
+**詳細**: [cc-sdd カスタマイズガイド](https://github.com/gotalab/cc-sdd/blob/main/docs/guides/ja/customization-guide.md)
+
+**主なカスタマイズ内容**:
+- 要件定義書の見出し形式（日本語/英語/カスタム）
+- 設計ドキュメントのセクション構造
+- タスク分解の粒度と形式
+- EARS形式の要件記述ルール
+- カスタムSteeringドキュメント（API標準、セキュリティポリシーなど）
+
+### 2. Michiのカスタマイズ（設定ファイル）
+
+**対象**: Confluence/JIRAの作成方法やワークフロー設定
+- **`.michi/config.json`**: Confluence階層構造、JIRA Story作成粒度、承認ゲート設定
+
+**詳細**: 本ドキュメント（以下を参照）
+
+**主なカスタマイズ内容**:
+- Confluenceページの階層構造（フラット/階層/セクション分割）
+- JIRA Story作成粒度（全作成/フェーズごと/選択フェーズのみ）
+- ワークフロー承認ゲート設定
+
+### 使い分け
+
+| カスタマイズ種類 | 対象 | 設定場所 | コマンド |
+|----------------|------|---------|---------|
+| **cc-sdd** | ドキュメント構造・AI判断基準 | `.kiro/settings/templates/`, `.kiro/settings/rules/`, `.kiro/steering/` | `/kiro:steering-custom` |
+| **Michi** | Confluence/JIRA作成方法 | `.michi/config.json` | `michi config:interactive` |
+
+**例**: 
+- 要件定義書の見出しを「要件 N:」から「REQ-N:」に変更 → **cc-sddのカスタマイズ**（`templates/requirements.md`を編集）
+- Confluenceページを階層構造にする → **Michiのカスタマイズ**（`.michi/config.json`で設定）
 
 ## 設定ファイルの構造
 
@@ -14,9 +57,11 @@ Michiでは、チームごとに異なる開発フローに対応するため、
 
 ### プロジェクト固有設定
 
-`.kiro/config.json` - プロジェクトルートに配置（オプション）
+`.michi/config.json` - プロジェクトルートに配置（オプション）
+
+**重要**: `.michi/config.json`は`.gitignore`に追加することを推奨します（チーム固有設定のため）
 
-**重要**: `.kiro/config.json`は`.gitignore`に追加することを推奨します（チーム固有設定のため）
+**注意**: 以前は `.kiro/config.json` を使用していましたが、Michi専用の設定ファイルとして `.michi/config.json` に変更されました。
 
 ### 設定のマージ順序
 
@@ -297,14 +342,14 @@ Confluenceスペース
 }
 ```
 
-### 承認ゲートの設定
+### 承認者の設定
 
 **設定例: 日本語ロール名を使用**
 ```json
 {
   "workflow": {
     "approvalGates": {
-      "requirements": ["企画", "部長"],
+      "requirements": ["PL", "部長"],
       "design": ["アーキテクト", "部長"],
       "release": ["SM", "部長"]
     }
@@ -314,7 +359,7 @@ Confluenceスペース
 
 ## 対話式設定ツール
 
-`.kiro/config.json`を対話的に作成・更新できます：
+`.michi/config.json`を対話的に作成・更新できます：
 
 ```bash
 # 対話式設定ツールを実行
@@ -333,7 +378,7 @@ npm run config:interactive
    - ワークフロー設定のカスタマイズ
 3. **各設定を対話的に入力**: プロンプトに従って選択・入力
 4. **設定を確認**: 最終的な設定内容を確認
-5. **保存**: 設定ファイルを`.kiro/config.json`に保存
+5. **保存**: 設定ファイルを`.michi/config.json`に保存
 
 ### 設定項目
 
@@ -341,7 +386,7 @@ npm run config:interactive
 - **ページタイトル形式**: カスタマイズ可能
 - **JIRA Story作成粒度**: 全作成/フェーズごと/選択フェーズのみ
 - **ワークフロー有効化フェーズ**: 要件定義/設計/タスク分割から選択
-- **承認ゲート**: 各フェーズの承認者を設定
+- **承認者**: 各フェーズの承認者を設定
 
 ## 設定ファイルのバリデーション
 
@@ -408,7 +453,7 @@ npm run config:validate
 
 ### 設定ファイルが読み込まれない
 
-1. `.kiro/config.json`がプロジェクトルートに存在するか確認
+1. `.michi/config.json`がプロジェクトルートに存在するか確認
 2. JSONの構文エラーがないか確認
 3. 設定ファイルのパスが正しいか確認
 
@@ -426,7 +471,14 @@ npm run config:validate
 
 ## 参考リンク
 
+### Michi関連
 - [セットアップガイド](./setup.md)
 - [ワークフローガイド](./workflow.md)
 - [新規プロジェクトセットアップ](./new-project-setup.md)
+- [設定値リファレンス](./config-reference.md)
+
+### cc-sdd関連
+- [cc-sdd カスタマイズガイド](https://github.com/gotalab/cc-sdd/blob/main/docs/guides/ja/customization-guide.md) - テンプレート・ルール・Steeringのカスタマイズ方法
+- [cc-sdd コマンドリファレンス](https://github.com/gotalab/cc-sdd/blob/main/docs/guides/ja/command-reference.md) - `/kiro:steering-custom`などのコマンド詳細
+- [cc-sdd Spec-Driven Guide](https://github.com/gotalab/cc-sdd/blob/main/docs/guides/ja/spec-driven.md) - 仕様駆動開発のワークフロー