@sk8metal/michi-cli 0.2.1 → 0.3.0

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

@@ -78,18 +78,46 @@ npx cc-sdd@latest --claude --lang ja
 **実行結果の確認**:
 
 ```
-✅ .claude/rules/ ディレクトリが作成される
-✅ 共通ルールファイルが生成される
-✅ AGENTS.md が生成される
+✅ .kiro/settings/rules/ - Spec-Driven Development用のルールファイル
+✅ .kiro/settings/templates/ - Spec用テンプレート（requirements.md, design.md等）
+✅ CLAUDE.md - プロジェクトルートへのメインルールファイル
 ```
 
+**重要な注意事項**:
+
+> `.kiro/settings/`配下のファイルは**cc-sddツールによって自動生成される汎用テンプレート**です。
+> - これらのファイルは`.gitignore`に含まれており、**Git管理されません**
+> - 各開発者が`npx cc-sdd@latest --claude --lang ja`を実行して生成します
+> - cc-sddのバージョンアップにより、最新のベストプラクティスが自動的に反映されます
+> - プロジェクト固有の設定は`.kiro/steering/`と`.kiro/specs/`に記載します
+
 ### Step 4: Michi固有ファイルの追加
 
+#### 基本セットアップ
+
 ```bash
 # Michi専用のファイルを追加（Claude Subagents向け）
 npx @sk8metal/michi-cli setup-existing --claude-agent --lang ja
 ```
 
+このコマンドは、デフォルトで以下を実行します：
+1. Michiワークフロー用のファイル・ディレクトリを作成
+2. プロジェクト固有のSubagent設定を`.claude/agents/`に配置
+3. **汎用スキル/サブエージェントを `~/.claude/` にインストール**（自動）
+4. スラッシュコマンドを `.claude/commands/michi/` に配置
+
+#### オプション設定
+
+**スキル/サブエージェントのインストールをスキップする場合**:
+
+```bash
+# --no-agent-skills オプションを使用
+npx @sk8metal/michi-cli setup-existing \
+  --claude-agent \
+  --lang ja \
+  --no-agent-skills
+```
+
 **対話的プロンプト**:
 
 セットアップコマンドを実行すると、以下の情報を対話的に入力するよう求められます：
@@ -118,14 +146,32 @@ JIRAプロジェクトキー（例: PRJA）: DEMO
 **実行結果の確認**:
 
 ```
-✅ .kiro/settings/templates/ - Specテンプレート
 ✅ .kiro/steering/ - Steeringテンプレート
 ✅ .kiro/project.json - プロジェクトメタデータ
-✅ .claude/agents/ - Subagent設定ファイル
+✅ .claude/agents/ - Subagent設定ファイル（プロジェクト固有）
 ✅ .claude/commands/michi/ - Michi専用コマンド
+✅ ~/.claude/skills/ - AI開発支援スキル（汎用、自動インストール）
+✅ ~/.claude/agents/ - 汎用サブエージェント（自動インストール）
 ✅ .env - 環境変数テンプレート（権限: 600）
 ```
 
+**注記**:
+- `.kiro/settings/`はStep 3で実行した`cc-sdd`によって生成済みです
+- `.claude/agents/`（プロジェクト内）と`~/.claude/agents/`（ホームディレクトリ）は異なります（詳細は下記参照）
+
+#### 💡 プロジェクト固有 vs 汎用のサブエージェント
+
+**重要**: `--claude-agent`環境では、2種類のサブエージェントが使用されます：
+
+| 種類 | 場所 | 用途 | 管理 |
+|------|------|------|------|
+| **プロジェクト固有** | `.claude/agents/` | プロジェクト独自の開発フロー・ルール | プロジェクトごとにカスタマイズ |
+| **汎用** | `~/.claude/agents/` | design-review、oss-license等の一般的な開発支援 | 全プロジェクトで共通利用 |
+
+両方のサブエージェントが同時に利用可能で、名前の衝突はありません。
+
+`--claude` vs `--claude-agent`の詳細な違いについては、[Claude Codeセットアップガイド](./claude-setup.md#-claude-vs-claude-agent-の違い)を参照してください。
+
 ### Step 5: 環境変数の設定
 
 `.env`ファイルが自動生成されているので、認証情報を設定します：
@@ -204,6 +250,32 @@ ls -la .claude/agents/
 # - tester.md          # テストエージェント
 ```
 
+**エージェントファイルの形式:**
+
+各エージェントファイルはYAML frontmatter形式で定義されています：
+
+```markdown
+---
+name: developer
+description: When implementing code, running tests, or creating pull requests
+tools: Read, Write, Edit, Bash, Glob, Grep
+model: sonnet
+---
+
+# Developer Agent
+
+エージェントのシステムプロンプト...
+```
+
+**フィールド説明:**
+
+| フィールド | 必須 | 説明 |
+|-----------|-----|------|
+| `name` | 必須 | エージェントの識別名 |
+| `description` | 必須 | エージェントが選択される条件の説明 |
+| `tools` | 必須 | エージェントが使用可能なツール |
+| `model` | 任意 | 使用するモデル（inherit, sonnet, opusなど） |
+
 ### Step 7: 依存関係のインストール
 
 プロジェクトルートで依存関係をインストールします：
@@ -235,17 +307,18 @@ tree -L 3 .kiro .claude
 
 # 期待される構造:
 # .kiro/
-# ├── project.json
-# ├── settings/
-# │   └── templates/
+# ├── project.json              # Michiで管理（Gitにコミット）
+# ├── settings/                 # cc-sddで生成（Git管理外）
+# │   ├── rules/               # Spec-Driven Development用ルール
+# │   └── templates/           # Spec用テンプレート
 # │       ├── design.md
 # │       ├── requirements.md
 # │       └── tasks.md
-# ├── steering/
+# ├── steering/                # /kiro:steeringコマンドで作成（Git管理）
 # │   ├── product.md
 # │   ├── structure.md
 # │   └── tech.md
-# └── specs/
+# └── specs/                   # /kiro:spec-initで作成（Git管理）
 #
 # .claude/
 # ├── commands/
@@ -260,16 +333,32 @@ tree -L 3 .kiro .claude
 # └── README.md
 ```
 
-### Step 10: Subagentsの初期化
+### Step 10: Subagentsの動作確認
 
-Claude Code Subagentsを初期化します：
+Claude Code内でSubagentsが正しく認識されているか確認します：
 
 ```bash
-# Subagentsを初期化
-claude agent init
+# Claude Codeを起動
+claude
+
+# Claude Code内で/agentsコマンドを実行してエージェント一覧を確認
+/agents
+```
+
+**確認ポイント:**
+- `.claude/agents/` 配下のエージェントファイルが認識されていること
+- 各エージェント（manager-agent, developer, designer, tester）が表示されること
+
+**エージェントの呼び出し方:**
 
-# Subagent一覧を確認
-claude agent list
+Claude Code内で自然言語を使ってエージェントを呼び出します：
+
+```
+# Manager Agentを使用
+Use the manager-agent to start requirements definition for health-check-endpoint
+
+# Developer Agentを使用
+Use the developer agent to implement the health-check-endpoint feature
 ```
 
 ## ✅ セットアップ完了の確認
@@ -279,10 +368,12 @@ claude agent list
 - [ ] `michi --version` が正常に動作する
 - [ ] `.kiro/project.json` が存在し、正しい内容が含まれている
 - [ ] `.env` ファイルが存在し、認証情報が設定されている
-- [ ] `.claude/agents/` ディレクトリにSubagent設定ファイルが存在する
+- [ ] `.claude/agents/` ディレクトリにSubagent設定ファイル（プロジェクト固有）が存在する
 - [ ] `.claude/commands/michi/` ディレクトリにコマンドファイルが存在する
+- [ ] `~/.claude/skills/` ディレクトリに汎用スキルが存在する（`--no-agent-skills`を使用しなかった場合）
+- [ ] `~/.claude/agents/` ディレクトリに汎用サブエージェントが存在する（`--no-agent-skills`を使用しなかった場合）
 - [ ] `gh auth status` が成功する
-- [ ] `claude agent list` でSubagentが表示される
+- [ ] Claude Code内で `/agents` でSubagentが表示される
 
 ## 🎯 次のステップ
 
@@ -320,36 +411,47 @@ Claude Subagentsでは、複数のエージェントが協調してタスクを
 
 ### エージェントの呼び出し方
 
+Claude Codeでは、自然言語でエージェントに依頼します。`@agent`記法ではなく、エージェント名を含む文で依頼します：
+
 ```
-# Managerエージェントを呼び出し
-ユーザー: @manager-agent health-check-endpointの要件定義を開始してください
+# Manager Agentに依頼
+Use the manager-agent to start requirements definition for health-check-endpoint
 
-# Designerエージェントを呼び出し
-ユーザー: @designer health-check-endpointの設計を作成してください
+# Designer Agentに依頼
+Use the designer agent to create the design for health-check-endpoint
+
+# Developer Agentに依頼
+Use the developer agent to implement health-check-endpoint
+
+# Tester Agentに依頼
+Use the tester agent to create tests for health-check-endpoint
+```
 
-# Developerエージェントを呼び出し
-ユーザー: @developer health-check-endpointを実装してください
+**利用可能なエージェントの確認:**
 
-# Testerエージェントを呼び出し
-ユーザー: @tester health-check-endpointのテストを作成してください
+```
+# Claude Code内でエージェント一覧を確認
+/agents
 ```
 
 ### ワークフロー例
 
 ```
-# Step 1: Managerが要件定義を開始
-@manager-agent /kiro:spec-init health-check-endpoint
+# Step 1: Manager Agentで要件定義を開始
+Use the manager-agent to initialize spec for health-check-endpoint with /kiro:spec-init
 
-# Step 2: Designerが設計書を作成
-@designer /kiro:spec-design health-check-endpoint
+# Step 2: Designer Agentで設計書を作成
+Use the designer agent to create design with /kiro:spec-design health-check-endpoint
 
-# Step 3: Developerが実装
-@developer /kiro:spec-impl health-check-endpoint
+# Step 3: Developer Agentで実装
+Use the developer agent to implement with /kiro:spec-impl health-check-endpoint
 
-# Step 4: Testerがテスト
-@tester テストコードをレビューして、カバレッジを確認してください
+# Step 4: Tester Agentでテスト確認
+Use the tester agent to review test code and check coverage
 ```
 
+**補足：** 各ステップでClaude Codeが適切なエージェントに処理を委譲し、そのエージェントの権限（toolsで定義）の範囲で作業を実行します。
+
 ### エージェント間の連携
 
 エージェントは自動的に必要な情報を共有します：
@@ -370,36 +472,76 @@ Tester → Manager: テスト結果を報告
 #### Subagentが認識されない
 
 ```bash
-# Subagent設定を再読み込み
-claude agent reload
-
-# Subagentディレクトリを確認
+# Subagentディレクトリが存在するか確認
 ls -la .claude/agents/
 
+# 期待されるファイル:
+# - manager-agent.md
+# - developer.md
+# - designer.md
+# - tester.md
+
 # Subagent設定ファイルの内容を確認
 cat .claude/agents/manager-agent.md
 ```
 
-#### エージェント呼び出しエラー
+**確認ポイント:**
 
-```bash
-# エージェント一覧を確認
-claude agent list
+1. ファイルがYAML frontmatter形式で始まっているか:
+   ```yaml
+   ---
+   name: manager-agent
+   description: When managing project workflow...
+   tools: Read, Grep, Glob, Bash
+   model: sonnet
+   ---
+   ```
 
-# 特定のエージェントの状態を確認
-claude agent status manager-agent
+2. Claude Codeを再起動して、`/agents`コマンドでエージェントが表示されるか確認
+
+#### スキル/サブエージェント（汎用）が見つからない
+
+**症状**: コマンド実行時に「スキルが見つかりません」エラー
+
+**原因**:
+- セットアップ時に`--no-agent-skills`オプションを使用した
+- `~/.claude/skills/`または`~/.claude/agents/`が削除された
+
+**解決策**:
+```bash
+# スキル/サブエージェントを再インストール
+npx @sk8metal/michi-cli setup-existing --claude-agent --lang ja
 ```
 
-#### エージェント間の通信エラー
+**Note**: デフォルトでスキル/サブエージェントがインストールされます。`--no-agent-skills`オプションを使用しないでください。
+
+**重要**: `.claude/agents/`（プロジェクト固有）と`~/.claude/agents/`（汎用）は異なります。汎用スキル/サブエージェントは`~/.claude/`配下にインストールされます。
+
+#### エージェント呼び出しが機能しない
 
 ```bash
-# ログを確認
-claude agent logs
+# Claude Code内でエージェント一覧を確認
+/agents
 
-# デバッグモードで実行
-claude agent debug
+# エージェントファイルの構文を確認
+# frontmatterが正しいYAML形式であることを確認してください
 ```
 
+**よくある原因:**
+
+1. **frontmatter形式の誤り**: `---`で囲まれたYAMLブロックが必要
+2. **必須フィールドの欠落**: `name`, `description`, `tools`は必須
+3. **ファイル拡張子**: `.md`でなければならない
+4. **ディレクトリ位置**: `.claude/agents/`配下に配置されていること
+
+#### エージェントが期待通りに動作しない
+
+エージェントの動作はfrontmatterの`description`フィールドに基づいて決定されます。
+Claude Codeは依頼内容と`description`をマッチングして適切なエージェントを選択します。
+
+- `description`が曖昧な場合、意図しないエージェントが選択される可能性があります
+- より具体的な`description`を設定することで改善できます
+
 ### よくある問題
 
 #### npm installがエラーになる
@@ -436,7 +578,7 @@ chmod 600 .env
 
 ## 🔗 外部リンク
 
-- [Claude Code公式ドキュメント](https://claude.ai/code)
+- [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)
 

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

@@ -76,18 +76,37 @@ npx cc-sdd@latest --claude --lang ja
 **実行結果の確認**:
 
 ```
-✅ .claude/rules/ ディレクトリが作成される
-✅ 共通ルールファイルが生成される
-✅ AGENTS.md が生成される
+✅ .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
+```
+
 **対話的プロンプト**:
 
 セットアップコマンドを実行すると、以下の情報を対話的に入力するよう求められます：
@@ -120,9 +139,25 @@ JIRAプロジェクトキー（例: PRJA）: DEMO
 ✅ .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`ファイルが自動生成されているので、認証情報を設定します：
@@ -217,17 +252,18 @@ tree -L 3 .kiro .claude
 
 # 期待される構造:
 # .kiro/
-# ├── project.json
-# ├── settings/
-# │   └── templates/
+# ├── project.json              # Michiで管理（Gitにコミット）
+# ├── settings/                 # cc-sddで生成（Git管理外）
+# │   ├── rules/               # Spec-Driven Development用ルール
+# │   └── templates/           # Spec用テンプレート
 # │       ├── design.md
 # │       ├── requirements.md
 # │       └── tasks.md
-# ├── steering/
+# ├── steering/                # /kiro:steeringコマンドで作成（Git管理）
 # │   ├── product.md
 # │   ├── structure.md
 # │   └── tech.md
-# └── specs/
+# └── specs/                   # /kiro:spec-initで作成（Git管理）
 #
 # .claude/
 # ├── commands/
@@ -260,6 +296,8 @@ claude rules list
 - [ ] `.env` ファイルが存在し、認証情報が設定されている
 - [ ] `.claude/rules/` ディレクトリにルールファイルが存在する
 - [ ] `.claude/commands/michi/` ディレクトリにコマンドファイルが存在する
+- [ ] `~/.claude/skills/` ディレクトリにスキルが存在する（`--no-agent-skills`を使用しなかった場合）
+- [ ] `~/.claude/agents/` ディレクトリにサブエージェントが存在する（`--no-agent-skills`を使用しなかった場合）
 - [ ] `gh auth status` が成功する
 - [ ] `claude rules list` でMichiのルールが表示される
 
@@ -345,6 +383,22 @@ 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
@@ -388,7 +442,7 @@ gh auth setup-git
 
 ## 🔗 外部リンク
 
-- [Claude Code公式ドキュメント](https://claude.ai/code)
+- [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)
 

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

@@ -78,9 +78,9 @@ npx cc-sdd@latest --cursor --lang ja
 **実行結果の確認**:
 
 ```
-✅ .cursor/rules/ ディレクトリが作成される
-✅ 共通ルールファイルが生成される
-✅ AGENTS.md が生成される
+✅ .kiro/settings/rules/ - Spec-Driven Development用のルールファイル
+✅ .kiro/settings/templates/ - Spec用テンプレート（requirements.md, design.md等）
+✅ CLAUDE.md - プロジェクトルートへのメインルールファイル
 ```
 
 ### Step 4: Michi固有ファイルの追加
@@ -254,17 +254,18 @@ tree -L 3 .kiro .cursor
 
 # 期待される構造:
 # .kiro/
-# ├── project.json
-# ├── settings/
-# │   └── templates/
+# ├── project.json              # Michiで管理（Gitにコミット）
+# ├── settings/                 # cc-sddで生成（Git管理外）
+# │   ├── rules/               # Spec-Driven Development用ルール
+# │   └── templates/           # Spec用テンプレート
 # │       ├── design.md
 # │       ├── requirements.md
 # │       └── tasks.md
-# ├── steering/
+# ├── steering/                # /kiro:steeringコマンドで作成（Git管理）
 # │   ├── product.md
 # │   ├── structure.md
 # │   └── tech.md
-# └── specs/
+# └── specs/                   # /kiro:spec-initで作成（Git管理）
 #
 # .cursor/
 # ├── commands/

package/docs/user-guide/hands-on/verification-checklist.md

@@ -40,7 +40,7 @@
 
 - [ ] Michiがインストールされている
   ```bash
-  michi --version  # 0.0.9以上
+  michi --version  # 0.2.0以上
   ```
 
 - [ ] Michiコマンドが実行できる
@@ -62,10 +62,11 @@
   # requirements.md, design.md, tasks.md が存在
   ```
 
-- [ ] `.kiro/steering/` が存在する
+- [ ] `.kiro/steering/` が存在する（オプション: `/kiro:steering`コマンドで作成）
   ```bash
   ls -la .kiro/steering/
-  # product.md, tech.md, structure.md が存在
+  # セットアップ直後は存在しない。必要に応じて /kiro:steering コマンドで作成
+  # 作成後は product.md, tech.md, structure.md が存在
   ```
 
 - [ ] 環境別ルールファイルが存在する（Cursor IDEの場合）

package/docs/user-guide/hands-on/workflow-walkthrough.md

@@ -90,11 +90,10 @@ ls -la .kiro/
 以下のディレクトリ/ファイルが存在するはずです：
 
 ```
-drwxr-xr-x  5 user  staff  160 Jan 15 10:00 .
+drwxr-xr-x  4 user  staff  128 Jan 15 10:00 .
 drwxr-xr-x  10 user  staff  320 Jan 15 10:00 ..
 -rw-r--r--  1 user  staff  512 Jan 15 10:00 project.json
 drwxr-xr-x  3 user  staff   96 Jan 15 10:00 settings
-drwxr-xr-x  4 user  staff  128 Jan 15 10:00 steering
 drwxr-xr-x  2 user  staff   64 Jan 15 10:00 specs
 ```
 
@@ -102,9 +101,10 @@ drwxr-xr-x  2 user  staff   64 Jan 15 10:00 specs
 
 - ✅ `.kiro/project.json` が存在
 - ✅ `.kiro/settings/templates/` が存在
-- ✅ `.kiro/steering/` が存在
 - ✅ `.kiro/specs/` が存在（空でもOK）
 
+**注意**: `.kiro/steering/` は `/kiro:steering` コマンドで必要に応じて作成します（セットアップ直後には存在しません）。
+
 → **すべて存在する場合、Step 1に進んでください**
 
 **❌ セットアップ未完了の場合**:

package/docs/user-guide/reference/quick-reference.md

@@ -303,6 +303,8 @@ npm install
 
 ### Steering
 
+**注意**: `/kiro:steering`コマンドで作成（セットアップ時には自動生成されません）
+
 - `.kiro/steering/product.md`
 - `.kiro/steering/tech.md`
 - `.kiro/steering/structure.md`

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sk8metal/michi-cli",
-  "version": "0.2.1",
+  "version": "0.3.0",
   "description": "Managed Intelligent Comprehensive Hub for Integration - AI-driven development workflow automation",
   "license": "MIT",
   "type": "module",

package/templates/michi/cc-sdd-overrides/README.md

@@ -0,0 +1,50 @@
+# Michi cc-sdd-overrides
+
+このディレクトリは、cc-sddツールが生成する汎用テンプレートに対する、Michi固有のカスタマイズを管理します。
+
+## 目的
+
+- **問題**: cc-sddが生成する`.kiro/settings/`はGit管理外だが、Michi固有のカスタマイズ（日本語、Phase A/B、JIRA/Confluence連携）が必要
+- **解決**: Michi固有の差分をこのディレクトリで管理し、`setup-existing`実行時に適用
+
+## ディレクトリ構造
+
+```
+cc-sdd-overrides/
+└── settings/
+    └── templates/
+        └── specs/
+            ├── tasks.md   # Michi固有のタスクテンプレート
+            └── init.json  # 日本語デフォルト設定
+```
+
+## Michi固有の要素
+
+### tasks.md
+- 日本語で記述
+- Michiワークフロー（Phase 0.1-0.4, Phase 1-5, Phase A, Phase B）
+- JIRA連携（ラベル: `spec-init`, `requirements`, `design`, `phase-a`, `phase-b`等）
+- Confluence連携（リリース手順書、完了報告）
+- `michi-cli`コマンド参照
+
+### init.json
+- `"language": "ja"` - 日本語をデフォルト言語として設定
+
+## 適用タイミング
+
+`setup-existing`コマンド実行時、以下の順序で処理：
+
+1. cc-sddが汎用テンプレートを生成 → `.kiro/settings/`
+2. Michiがオーバーライドを適用 ← `templates/michi/cc-sdd-overrides/`
+
+結果として、`.kiro/settings/templates/specs/tasks.md`がMichi固有版に上書きされます。
+
+## Git管理
+
+- このディレクトリ（`templates/michi/cc-sdd-overrides/`）: **Git管理対象**
+- 生成先（`.kiro/settings/`）: **Git管理外**（`.gitignore`に含まれる）
+
+## 参考
+
+- [cc-sdd公式リポジトリ](https://github.com/gotalab/cc-sdd)
+- [setup-existingコマンド実装](../../../src/commands/setup-existing.ts)

package/templates/michi/cc-sdd-overrides/settings/templates/specs/init.json

@@ -0,0 +1,24 @@
+{
+  "feature_name": "{{FEATURE_NAME}}",
+  "created_at": "{{TIMESTAMP}}",
+  "updated_at": "{{TIMESTAMP}}",
+  "language": "ja",
+  "phase": "initialized",
+  "approvals": {
+    "requirements": {
+      "generated": false,
+      "approved": false
+    },
+    "design": {
+      "generated": false,
+      "approved": false
+    },
+    "tasks": {
+      "generated": false,
+      "approved": false
+    }
+  },
+  "ready_for_implementation": false
+}
+
+