@sk8metal/michi-cli 0.0.8 → 0.1.0

package/README.md

@@ -1,9 +1,11 @@
 # Michi (道)
+
 **M**anaged **I**ntelligent **C**omprehensive **H**ub for **I**ntegration
 
 AI駆動開発ワークフロー自動化プラットフォーム
 
 [![CI](https://github.com/sk8metalme/michi/actions/workflows/ci.yml/badge.svg)](https://github.com/sk8metalme/michi/actions/workflows/ci.yml)
+[![Test Setup](https://github.com/sk8metalme/michi/actions/workflows/test-setup.yml/badge.svg)](https://github.com/sk8metalme/michi/actions/workflows/test-setup.yml)
 [![Security](https://github.com/sk8metalme/michi/actions/workflows/security.yml/badge.svg)](https://github.com/sk8metalme/michi/actions/workflows/security.yml)
 [![codecov](https://codecov.io/gh/sk8metalme/michi/branch/main/graph/badge.svg)](https://codecov.io/gh/sk8metalme/michi)
 
@@ -11,10 +13,12 @@ AI駆動開発ワークフロー自動化プラットフォーム
 
 Michiは、開発フロー全体（要件定義→設計→タスク分割→実装→テスト→リリース）をAIで自動化するプラットフォームです。
 
-**Powered by [cc-sdd](https://github.com/gotalab/cc-sdd)** 
+**Powered by [cc-sdd](https://github.com/gotalab/cc-sdd)**
 
 ### 主な機能
+
 - ✅ **AI駆動開発**: cc-sdd + Cursor/VS Code統合
+- ✅ **多言語サポート**: 12言語対応（AI駆動、翻訳ファイル不要）
 - ✅ **GitHub SSoT(Single Source Of True)**: GitHubを情報源として管理
 - ✅ **Confluence/JIRA連携**: 承認者向けドキュメント、タスク管理
 - ✅ **マルチプロジェクト対応**: 3-5プロジェクト同時進行
@@ -30,16 +34,108 @@ Confluence ← ドキュメント管理
 JIRA ← タスク管理・進捗追跡
 ```
 
+## ワークフロー構造の概要
+
+### 新ワークフロー構造（推奨）
+
+Michiは以下のフェーズで構成されています:
+
+**Phase 0.0-0.6: 仕様化フェーズ**
+
+- **Phase 0.0**: プロジェクト初期化
+- **Phase 0.1**: 要件定義（Requirements） - 必須
+- **Phase 0.2**: 設計（Design） - 必須
+- **Phase 0.3**: テストタイプ選択（任意）
+- **Phase 0.4**: テスト仕様書作成（任意）
+- **Phase 0.5**: タスク分割 - 必須
+- **Phase 0.6**: JIRA同期 - 必須
+
+**Phase 1: 環境構築（任意）**
+
+- テスト環境のセットアップ
+- 開発環境の構築
+
+**Phase 2: TDD実装（必須）**
+
+- テスト駆動開発による実装
+- RED-GREEN-REFACTORサイクル
+
+**Phase A: PR前自動テスト（任意）**
+
+- 単体テスト自動実行
+- Lint自動実行
+- ビルド自動実行
+
+**Phase 3: 追加QA（任意）**
+
+- 統合テスト
+- E2Eテスト
+
+**Phase B: リリース準備テスト（任意）**
+
+- 手動テスト実行
+- セキュリティテスト
+- パフォーマンステスト
+
+**Phase 4: リリース準備（必須）**
+
+- 本番環境構築
+- リリースドキュメント作成
+
+**Phase 5: リリース（必須）**
+
+- ステージング環境デプロイ
+- 本番環境リリース
+
+### レガシー6-Phaseサポート
+
+後方互換性のため、従来のPhase 0-5構造（要件定義→設計→実装→試験→リリース準備→リリース）もサポートしています。既存プロジェクトはそのまま動作します。
+
+詳細は [ワークフローガイド](./docs/user-guide/guides/workflow.md) を参照してください。
+
+### 対応プロジェクト
+
+Michiは**言語非依存**で、どんなプロジェクトでも使用できます：
+
+- ✅ **Java**（Maven/Gradle）
+- ✅ **Python**（pip/poetry/uv）
+- ✅ **Go**（go mod）
+- ✅ **Node.js**（npm/yarn/pnpm）
+- ✅ **Rust**（Cargo）
+- ✅ **PHP**（Composer）
+- ✅ **Ruby**（Bundler）
+- ✅ その他あらゆる言語
+
+**重要**: Michiは`package.json`を要求しません。プロジェクトの設定は`.kiro/project.json`で完結します。
+
 ## クイックスタート
 
 ### 前提条件
 
-- Node.js 20.x以上
+- Node.js 20.x以上（Michi CLIの実行に必要。プロジェクト自体はNode.jsでなくてもOK）
 - Git（または Jujutsu (jj) も使用可能）
-- Cursor IDE または VS Code
+- **AI開発環境**（以下のいずれか）:
+  - [Cursor IDE](https://cursor.sh/) (推奨)
+  - [Claude Code](https://claude.com/claude-code)
+  - [Gemini CLI](https://geminicli.com/)
+  - [Codex CLI](https://developers.openai.com/codex/cli)
+  - [Cline](https://cline.bot/) (VSCode拡張)
+  - VSCode + 他のAI拡張
 - GitHub CLI (gh) - PR作成時に使用
+- **GitHub Personal Access Token** - GitHub連携に必要（[作成ガイド](./docs/user-guide/getting-started/github-token-setup.md)）
 - **cc-sdd**: AI駆動開発ワークフローのコアフレームワーク
 
+**重要な注意事項**:
+
+- ⚠️ **セットアップ時にテンプレートファイルが不足している場合、エラーが発生します**
+  - 最新のMichiをインストールしてください
+  - エラーが発生した場合は[トラブルシューティング](./docs/hands-on/troubleshooting.md)を参照
+- ⚠️ **tasks.mdのフォーマットが間違っているとJIRA同期が失敗します**
+  - 新ワークフロー構造では必須フェーズ（Phase 0.1, 0.2, 2, 4, 5）が必要です
+  - レガシー構造では全6フェーズ（Phase 0-5）が必須です
+  - AIコマンド実行時は必ずテンプレートを参照するよう指示してください
+  - 詳細: [tasks.mdフォーマット問題](./docs/hands-on/troubleshooting.md#問題-tasksmdのフォーマットが間違っているformat-validation-error)
+
 ### インストール
 
 #### 方法1: NPMパッケージとしてインストール（推奨）
@@ -105,14 +201,14 @@ cp env.example .env
 **AIコマンド + CLIツール実行** で抜け漏れを防止：
 
 ```bash
-# Phase 0: 初期化
+# Phase 0.0: プロジェクト初期化
 # 凡例
 /kiro:spec-init <機能説明>
 
 # 具体例
 /kiro:spec-init ユーザー認証機能
 
-# Phase 1: 要件定義
+# Phase 0.1: 要件定義
 # 凡例
 /kiro:spec-requirements <feature>                              # AIで requirements.md 作成
 npx @sk8metal/michi-cli phase:run <feature> requirements     # Confluence作成＋バリデーション（必須）
@@ -121,7 +217,7 @@ npx @sk8metal/michi-cli phase:run <feature> requirements     # Confluence作成
 /kiro:spec-requirements user-auth                              # AIで requirements.md 作成
 npx @sk8metal/michi-cli phase:run user-auth requirements      # Confluence作成＋バリデーション（必須）
 
-# Phase 2: 設計
+# Phase 0.2: 設計
 # 凡例
 /kiro:spec-design <feature>                                     # AIで design.md 作成
 npx @sk8metal/michi-cli phase:run <feature> design           # Confluence作成＋バリデーション（必須）
@@ -130,32 +226,46 @@ npx @sk8metal/michi-cli phase:run <feature> design           # Confluence作成
 /kiro:spec-design user-auth                                     # AIで design.md 作成
 npx @sk8metal/michi-cli phase:run user-auth design           # Confluence作成＋バリデーション（必須）
 
-# Phase 3: タスク分割（6フェーズすべて）
+# Phase 0.3-0.4: テスト計画（任意）
+# プロジェクトに応じてテストタイプを選択し、テスト仕様書を作成
+# 詳細: docs/user-guide/testing/test-planning-flow.md
+
+# Phase 0.5-0.6: タスク分割とJIRA同期
 # 凡例
-/kiro:spec-tasks <feature>                                      # AIで tasks.md 作成（要件定義～リリースまで）
+/kiro:spec-tasks <feature>                                      # AIで tasks.md 作成（全フェーズ）
 npx @sk8metal/michi-cli phase:run <feature> tasks            # 全フェーズのJIRA作成＋バリデーション（必須）
 
 # 具体例
-/kiro:spec-tasks user-auth                                      # AIで tasks.md 作成（要件定義～リリースまで）
+/kiro:spec-tasks user-auth                                      # AIで tasks.md 作成（全フェーズ）
 npx @sk8metal/michi-cli phase:run user-auth tasks            # 全フェーズのJIRA作成＋バリデーション（必須）
 
-# Phase 4: 実装
+# Phase 1: 環境構築（任意）
+# テスト環境のセットアップ、開発環境の構築
+
+# Phase 2: TDD実装
 # 凡例
 /kiro:spec-impl <feature>                            # TDD実装開始
 
 # 具体例
 /kiro:spec-impl user-auth                            # TDD実装開始
 
-# Phase 5: 試験
-# tasks.mdのPhase 3: 試験（Testing）に従ってテスト実施
+# Phase A: PR前自動テスト（任意）
+# CI/CDで自動実行される単体テスト、Lint、ビルド
 
-# Phase 6: リリース準備・リリース
+# Phase 3: 追加QA（任意）
+# tasks.mdに従って統合テスト、E2Eテストを実施
+
+# Phase B: リリース準備テスト（任意）
+# 手動テスト、セキュリティテスト、パフォーマンステストを実施
+
+# Phase 4-5: リリース準備・リリース
 # tasks.mdのPhase 4-5に従ってリリース準備・本番リリース
 ```
 
-**重要**: 各フェーズで `npx @sk8metal/michi-cli phase:run` を実行しないと、Confluence/JIRAが作成されず、承認者がレビューできません。
+**重要**: Phase 0.1, 0.2, 0.5-0.6では `npx @sk8metal/michi-cli phase:run` を実行しないと、Confluence/JIRAが作成されず、承認者がレビューできません。
 
 **CLIツールの使用方法**:
+
 - **npx実行（推奨）**: `npx @sk8metal/michi-cli <command>` - 常に最新版を使用
 - **グローバルインストール**: `npm install -g @sk8metal/michi-cli` 後、`michi <command>` で実行
 - **ローカル開発**: `npm run michi <command>` または `npx tsx src/cli.ts <command>`
@@ -188,6 +298,27 @@ npx @sk8metal/michi-cli project:list                            # プロジェ
 npx @sk8metal/michi-cli workflow:run --feature user-auth       # ワークフロー実行
 ```
 
+### 実装フェーズ（JIRA連携）
+
+```bash
+# AIコマンドで実装（JIRA連携は自動）
+# /kiro:spec-impl user-auth
+# ↑ spec.json から JIRA 情報を自動取得
+# ↑ Epic + 最初の Story を「進行中」に移動
+# ↑ TDD 実装
+# ↑ PR 作成
+# ↑ Epic + 最初の Story を「レビュー待ち」に移動
+# ↑ PR リンクを JIRA にコメント
+
+# 個別のJIRA操作（必要な場合のみ）
+npx @sk8metal/michi-cli jira:transition <issueKey> <status>
+npx @sk8metal/michi-cli jira:comment <issueKey> <comment>
+
+# 具体例
+npx @sk8metal/michi-cli jira:transition MICHI-123 "In Progress"
+npx @sk8metal/michi-cli jira:comment MICHI-123 "PRを作成しました: https://github.com/..."
+```
+
 ## プロジェクト構造
 
 ```text
@@ -198,6 +329,16 @@ michi/
 │   ├── settings/     # テンプレート
 │   ├── specs/        # 機能仕様書（GitHub SSoT）
 │   └── steering/     # AIガイダンス
+├── templates/        # cc-sdd準拠のマルチ環境テンプレート（Issue #35）
+│   ├── cursor/       # Cursor IDE用テンプレート
+│   │   ├── rules/    # ルールファイル（.mdc）
+│   │   └── commands/
+│   │       └── michi/ # Michi専用コマンド
+│   ├── claude/       # Claude Code用テンプレート（プレースホルダー含む）
+│   │   ├── rules/    # ルールファイル（.md、統合版）
+│   │   └── commands/
+│   │       └── michi/ # Michi専用コマンド（言語指示含む）
+│   └── claude-agent/ # Claude Agentテンプレート
 ├── scripts/          # 自動化スクリプト
 ├── docs/             # ドキュメント
 ├── env.example       # 環境変数テンプレート
@@ -205,6 +346,55 @@ michi/
 └── package.json      # 依存関係
 ```
 
+### テンプレートアーキテクチャ
+
+Michiは**cc-sdd準拠の多環境対応**を目指しています：
+
+#### 設計原則
+
+1. **単一の英語テンプレート**: 言語別ファイルを作らない
+2. **プレースホルダー使用**: `{{LANG_CODE}}`, `{{DEV_GUIDELINES}}` 等
+3. **AI駆動の多言語生成**: 実行時にAIが指定言語で出力
+4. **セットアップ時は置換しない**: テンプレートをそのままコピー、AIが実行時に解釈
+
+#### プレースホルダー一覧
+
+| プレースホルダー     | 説明             | 例                                       |
+| -------------------- | ---------------- | ---------------------------------------- |
+| `{{LANG_CODE}}`      | 言語コード       | ja, en                                   |
+| `{{DEV_GUIDELINES}}` | 言語別AI指示     | "Think in English, generate in Japanese" |
+| `{{KIRO_DIR}}`       | 仕様書ルート     | .kiro                                    |
+| `{{AGENT_DIR}}`      | エージェント設定 | .claude                                  |
+| `{{PROJECT_ID}}`     | プロジェクトID   | michi                                    |
+| `{{FEATURE_NAME}}`   | 機能名           | user-auth                                |
+
+#### テンプレート例
+
+```markdown
+# Michi Core Principles
+
+## Development Guidelines
+
+{{DEV_GUIDELINES}}
+
+## Language
+
+All generated documents should be in: **{{LANG_CODE}}**
+
+## Project Metadata
+
+- Project ID: {{PROJECT_ID}}
+- Kiro directory: {{KIRO_DIR}}
+- Agent directory: {{AGENT_DIR}}
+```
+
+**利点:**
+
+- ✅ 静的翻訳ファイル不要（メンテナンスコスト削減）
+- ✅ cc-sddとの完全互換
+- ✅ Cursor/Claude両環境で動作
+- ✅ プロジェクト固有値の動的生成
+
 ### 設定ファイル
 
 OSS公開に対応するため、以下のテンプレートファイルを用意しています：
@@ -214,7 +404,6 @@ OSS公開に対応するため、以下のテンプレートファイルを用
   - GitHub認証情報
   - プロジェクト固有設定
   - **ワークフロー承認ゲート設定**（オプション）
-  
 - **`mcp.json.example`**: MCP設定テンプレート
   - Cursor/VS Code用のAtlassian MCP設定
 
@@ -226,6 +415,7 @@ OSS公開に対応するため、以下のテンプレートファイルを用
   - **注意**: 以前は `.kiro/config.json` を使用していましたが、Michi専用の設定ファイルとして `.michi/config.json` に変更されました。
 
 **初回セットアップ時:**
+
 ```bash
 # 環境変数を設定
 cp env.example .env
@@ -260,24 +450,157 @@ APPROVAL_GATES_RELEASE=SM,部長
 
 ## 他のリポジトリでプロジェクトを進める
 
-### 既存リポジトリにMichiワークフローを追加（最も簡単）
+### 推奨ワークフロー（cc-sdd準拠）
+
+既存リポジトリにMichiを導入する標準的な手順です：
+
+```bash
+# Step 1: cc-sddで標準ファイル生成
+npx cc-sdd@latest --cursor --lang ja
+
+# Step 2: Michi固有ファイルを追加
+npx @sk8metal/michi-cli setup-existing --cursor --lang ja
+
+# Step 3: 環境設定
+npm run setup:interactive
+```
+
+**ステップの説明**:
+
+1. **cc-sdd導入**: AI駆動開発ワークフローのコアフレームワークをインストール
+2. **Michi固有ファイル追加**: Confluence/JIRA連携、マルチプロジェクト管理などのMichi専用機能を追加
+3. **環境設定**: 認証情報とプロジェクトメタデータを対話的に設定
+
+### IDE別セットアップ例
+
+#### Cursor IDE（推奨）
+
+```bash
+# Step 1: cc-sdd導入
+npx cc-sdd@latest --cursor --lang ja
+
+# Step 2: Michi固有ファイル追加
+npx @sk8metal/michi-cli setup-existing --cursor --lang ja
+# または npm run michi:setup:cursor
+
+# Step 3: 環境設定
+npm run setup:interactive
+```
+
+#### Claude Code
+
+```bash
+# Step 1: cc-sdd導入
+npx cc-sdd@latest --claude --lang ja
+
+# Step 2: Michi固有ファイル追加
+npx @sk8metal/michi-cli setup-existing --claude --lang ja
+# または npm run michi:setup:claude
+
+# Step 3: 環境設定
+npm run setup:interactive
+```
+
+#### Gemini CLI
+
+```bash
+# Step 1: cc-sdd導入（準備中 - 現在はスキップ可能）
+# npx cc-sdd@latest --gemini --lang ja
+
+# Step 2: Michi固有ファイル追加
+npx @sk8metal/michi-cli setup-existing --gemini --lang ja
+
+# Step 3: 環境設定
+npm run setup:interactive
+```
+
+**Gemini CLI特有の機能**:
+
+- `.gemini/GEMINI.md` - プロジェクトコンテキスト（階層的ロード対応）
+- `.gemini/extensions/` - 拡張機能
+
+#### Codex CLI
+
+```bash
+# Step 1: cc-sdd導入（必須）
+npx cc-sdd@latest --codex --lang ja
+
+# Step 2: Michi拡張をインストール
+npx @sk8metal/michi-cli setup-existing --codex --lang ja
+
+# Step 3: 環境設定
+npm run setup:interactive
+```
+
+**Codex CLI + cc-sdd統合**:
+
+- ✅ **完全対応**: cc-sddとの統合により、Michiワークフロー全機能をサポート
+- ✅ **11個の /kiro:* コマンド**: cc-sddが提供（spec-init, requirements, design, tasks, impl など）
+- ✅ **1個の /prompts:confluence-sync コマンド**: Michi独自（Confluence連携）
+- ✅ **AGENTS.md**: プロジェクトコンテキスト（cc-sdd提供 + Michi拡張）
+- ✅ **`.kiro/` ディレクトリ**: Spec-Driven Development構造
+
+**詳細**: `templates/codex/rules/README.md` を参照
+
+#### Cline (VSCode拡張)
+
+```bash
+# Step 1: VSCodeにCline拡張をインストール
+# https://marketplace.visualstudio.com/items?itemName=saoudrizwan.claude-dev
+
+# Step 2: Michi固有ファイル追加
+npx @sk8metal/michi-cli setup-existing --cline --lang ja
+
+# Step 3: 環境設定
+npm run setup:interactive
+```
+
+**Cline特有の機能**:
+
+- `.clinerules/rules/` - プロジェクト固有のルール（Markdown形式）
+- ルールのトグル機能（v3.13以降）- 各ルールファイルを個別に有効/無効化可能
+
+#### Windsurf IDE
+
+```bash
+# Step 1: cc-sdd導入
+npx cc-sdd@next --windsurf --lang ja
+
+# Step 2: Michi固有ファイル追加（Cursor互換モード）
+npx @sk8metal/michi-cli setup-existing --cursor --lang ja
+
+# Step 3: 環境設定
+npm run setup:interactive
+```
+
+### 既存リポジトリ vs 新規リポジトリ
+
+#### 既存リポジトリにMichiを追加（推奨）
+
+既に稼働しているプロジェクトにMichiを追加する場合：
 
 ```bash
 # 既存プロジェクトのディレクトリに移動
 cd /path/to/existing-repo
 
-# Michiのセットアップスクリプトを実行（対話式）
-bash /path/to/michi/scripts/setup-existing.sh
+# 推奨ワークフローを実行
+npx cc-sdd@latest --cursor --lang ja
+npx @sk8metal/michi-cli setup-existing --cursor --lang ja
+npm run setup:interactive
 ```
 
-対話式で以下を入力：
-- プロジェクト名
-- JIRAプロジェクトキー
-- 顧客名
+**自動的に追加されるもの**:
 
-自動的にcc-sdd、ルール、スクリプトなどがセットアップされます。
+- 共通ルール（`.cursor/rules/`または`.claude/rules/`）
+- Michi専用コマンド（`.cursor/commands/michi/`または`.claude/commands/michi/`）
+- Steeringテンプレート（`.kiro/steering/`）
+- Specテンプレート（`.kiro/settings/templates/`）
+- プロジェクトメタデータ（`.kiro/project.json`）
+- 環境変数テンプレート（`.env`）
 
-### 新規リポジトリを作成してセットアップ
+#### 新規リポジトリを作成してMichiを導入
+
+新しいプロジェクトをゼロから始める場合：
 
 ```bash
 # Michiディレクトリから実行
@@ -290,24 +613,35 @@ npm run create-project -- \
 
 詳細: [新規リポジトリセットアップガイド](./docs/getting-started/new-repository-setup.md)
 
+**どちらを選ぶべきか？**
+
+- ✅ **既存リポジトリに追加**: 既に稼働中のプロジェクトがある場合
+- ✅ **新規リポジトリ作成**: 新しいプロジェクトを始める場合
+
 ## ドキュメント
 
 ### はじめに
+
 - [クイックスタート](./docs/getting-started/quick-start.md) - 5分で始める ⭐
 - [セットアップガイド](./docs/getting-started/setup.md) - インストール・設定手順
 - [新規リポジトリセットアップ](./docs/getting-started/new-repository-setup.md) - 新規リポジトリでの開始方法
+- **[ハンズオンガイド](./docs/hands-on/README.md)** - 実際に手を動かして学ぶ1時間のチュートリアル ⭐
 
 ### 実践ガイド
+
 - [ワークフローガイド](./docs/guides/workflow.md) - AI開発フロー ⭐
 - [フェーズ自動化ガイド](./docs/guides/phase-automation.md) - Confluence/JIRA自動作成 ⭐
 - [マルチプロジェクト管理](./docs/guides/multi-project.md) - 複数プロジェクト管理
 - [カスタマイズガイド](./docs/guides/customization.md) - Confluence/JIRA階層構造のカスタマイズ
+- [多言語サポートガイド](./docs/guides/internationalization.md) - AI駆動多言語対応（12言語サポート） ⭐
 
 ### リファレンス
+
 - [クイックリファレンス](./docs/reference/quick-reference.md) - コマンド一覧、チートシート ⭐
 - [設定値リファレンス](./docs/reference/config.md) - `.michi/config.json`の全設定値の説明
 
 ### コントリビューター向け
+
 - [コントリビューションガイド](./CONTRIBUTING.md) - 貢献方法
 - [開発環境セットアップ](./docs/contributing/development.md) - 開発者向けセットアップ
 - [リリース手順](./docs/contributing/release.md) - バージョンアップ・NPM公開手順
@@ -315,7 +649,6 @@ npm run create-project -- \
 
 すべてのドキュメントは [docs/README.md](./docs/README.md) から参照できます。
 
-
 ## CI/CD
 
 このプロジェクトでは、GitHub Actionsを使用してCI/CDパイプラインを構築しています。
@@ -342,6 +675,7 @@ npm run create-project -- \
 **設定手順**: [NPM_TOKEN設定ガイド](./docs/contributing/npm-token-setup.md)
 
 **設定内容**:
+
 1. NPMアカウントでAutomation Tokenを生成
 2. GitHub Secretsに`NPM_TOKEN`を追加
 
@@ -399,26 +733,28 @@ Copyright (c) 2025 sk8metalme
 
 ドキュメント内で使用している記号の意味：
 
-| 記号 | 説明 | 例 |
-|------|------|-----|
-| `<feature>` | 機能名 | user-auth, health-check-endpoint |
-| `<project-id>` | プロジェクトID | michi, 20240115-payment-api |
-| `<project-name>` | プロジェクト名 | Michi, プロジェクトA |
-| `<phase>` | フェーズ名 | requirements, design, tasks |
-| `<tasks>` | タスクID | FE-1,BE-1, STORY-1 |
-| `<doc-type>` | ドキュメント種類 | requirements, design, tasks |
-| `<jira-key>` | JIRAプロジェクトキー | MICHI, PRJA |
+| 記号             | 説明                 | 例                               |
+| ---------------- | -------------------- | -------------------------------- |
+| `<feature>`      | 機能名               | user-auth, health-check-endpoint |
+| `<project-id>`   | プロジェクトID       | michi, 20240115-payment-api      |
+| `<project-name>` | プロジェクト名       | Michi, プロジェクトA             |
+| `<phase>`        | フェーズ名           | requirements, design, tasks      |
+| `<tasks>`        | タスクID             | FE-1,BE-1, STORY-1               |
+| `<doc-type>`     | ドキュメント種類     | requirements, design, tasks      |
+| `<jira-key>`     | JIRAプロジェクトキー | MICHI, PRJA                      |
 
 ### 凡例と具体例の読み方
 
 ドキュメント内のコマンド例は「凡例」と「具体例」を併記しています：
 
 **凡例**: 汎用的なパターン（記号を使用）
+
 ```bash
 /kiro:spec-requirements <feature>
 ```
 
 **具体例**: 実際の使用例
+
 ```bash
 /kiro:spec-requirements user-auth
 ```
@@ -431,19 +767,20 @@ Copyright (c) 2025 sk8metalme
 
 feature名は以下の場所で使用されるため、**英語・小文字・ハイフン区切り**が必須です：
 
-| 使用箇所 | 例 | 制約理由 |
-|---------|-----|---------|
-| ディレクトリ名 | `.kiro/specs/user-auth/` | ファイルシステム互換性 |
-| GitHub URL | `.../specs/user-auth/requirements.md` | URLセーフ |
-| Confluenceラベル | `user-auth` | ラベル検索・フィルタ |
-| JIRA Epic検索 | `labels = "user-auth"` | JQLクエリ |
-| ブランチ名 | `michi/feature/user-auth` | Git命名規則 |
+| 使用箇所         | 例                                    | 制約理由               |
+| ---------------- | ------------------------------------- | ---------------------- |
+| ディレクトリ名   | `.kiro/specs/user-auth/`              | ファイルシステム互換性 |
+| GitHub URL       | `.../specs/user-auth/requirements.md` | URLセーフ              |
+| Confluenceラベル | `user-auth`                           | ラベル検索・フィルタ   |
+| JIRA Epic検索    | `labels = "user-auth"`                | JQLクエリ              |
+| ブランチ名       | `michi/feature/user-auth`             | Git命名規則            |
 
 #### 命名ルール
 
 **形式**: 英語、kebab-case（ハイフン区切り）、小文字のみ
 
 **ルール**:
+
 - 2-4単語推奨
 - 英数字とハイフン(`-`)のみ使用
 - スペース、アンダースコア、日本語は不可
@@ -451,14 +788,14 @@ feature名は以下の場所で使用されるため、**英語・小文字・
 
 #### 変換例
 
-| spec-init（日本語説明） | spec-requirements以降（feature名） |
-|----------------------|--------------------------------|
-| ユーザー認証機能 | `user-auth` |
-| OAuth 2.0を使った認証 | `oauth-auth` |
-| 支払い処理機能 | `payment` |
-| ヘルスチェックエンドポイント | `health-check-endpoint` |
-| 商品検索API | `product-search-api` |
-| 在庫管理システム | `inventory-management` |
+| spec-init（日本語説明）      | spec-requirements以降（feature名） |
+| ---------------------------- | ---------------------------------- |
+| ユーザー認証機能             | `user-auth`                        |
+| OAuth 2.0を使った認証        | `oauth-auth`                       |
+| 支払い処理機能               | `payment`                          |
+| ヘルスチェックエンドポイント | `health-check-endpoint`            |
+| 商品検索API                  | `product-search-api`               |
+| 在庫管理システム             | `inventory-management`             |
 
 #### 変換のコツ
 
@@ -470,11 +807,13 @@ feature名は以下の場所で使用されるため、**英語・小文字・
 #### 良い例・悪い例
 
 ✅ **良い例**:
+
 - `user-auth` - 短く明確
 - `payment-processing` - 具体的
 - `health-check` - 標準的な用語
 
 ❌ **悪い例**:
+
 - `ユーザー認証` - 日本語（URL/ラベルに不適）
 - `user_auth` - アンダースコア（kebab-caseではない）
 - `UserAuth` - CamelCase（kebab-caseではない）
@@ -482,6 +821,38 @@ feature名は以下の場所で使用されるため、**英語・小文字・
 - `-user-auth` - 先頭ハイフン（無効）
 - `very-long-feature-name-for-user-authentication` - 長すぎる
 
+## テスト
+
+Michiプロジェクトは、統合テストによって品質を保証しています。
+
+### テスト実行
+
+```bash
+# すべてのテスト実行
+npm test
+
+# 統合テストのみ実行
+npm run test:integration:setup
+
+# カバレッジ付き実行
+npm run test:coverage:setup
+
+# 監視モード
+npm test -- --watch
+
+# UIモード
+npm run test:ui
+```
+
+### テストカバレッジ
+
+- **目標**: 95%以上
+- **現在のカバレッジ**: [![codecov](https://codecov.io/gh/sk8metalme/michi/branch/main/graph/badge.svg)](https://codecov.io/gh/sk8metalme/michi)
+
+### テストドキュメント
+
+詳細なテストガイドは [docs/testing/integration-tests.md](./docs/testing/integration-tests.md) を参照してください。
+
 ## 参考リンク
 
 ### AI開発フレームワーク