@sk8metal/michi-cli 0.0.9 → 0.1.0

package/CHANGELOG.md

@@ -5,6 +5,33 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [0.1.0] - 2025-12-03
+
+### Added
+- **Codex統合**: Codex環境のcc-sdd統合とワークフロー機能拡張（#81）
+  - 検証ガイド（`docs/verification-guide.md`）
+  - クイック検証スクリプト（`scripts/quick-verify.sh`）
+  - 新機能テスト（`scripts/test-new-features.ts`）
+  - ワークフローステージテスト（`scripts/test-workflow-stages.ts`）
+  - Confluence承認ユーティリティ（`scripts/utils/confluence-approval.ts`）
+  - リリースノート生成ユーティリティ（`scripts/utils/release-notes-generator.ts`）
+  - テストランナー（`scripts/utils/test-runner.ts`とテストスイート）
+  - Codexテンプレート（`templates/codex/AGENTS.override.md`、`templates/codex/prompts/confluence-sync.md`）
+  - 共通プロジェクト設定テンプレート（`templates/common/.kiro/project.json.template`）
+- **Kiro統合**: Claude Code/Claude AgentにkiroコードレビューとPR確認機能を追加（#79）
+- **Kiro spec-impl**: コードレビューとPR作成確認を追加（#78）
+- **Kiro spec-impl統合**: 統合ワークフローと関連機能を追加（#77）
+- **マルチ環境サポート**: 対話型テスト実行とマルチ環境サポートを追加（#65）
+- **新CLIサポート**: Gemini CLI、Codex CLI、Clineのサポートを追加（#64）
+
+### Changed
+- **依存関係更新**: inquirerを9.3.8から13.0.1にメジャーバージョンアップ（dependabot）
+- **ワークフローオーケストレーター**: `scripts/workflow-orchestrator.ts`を機能拡張
+- **setup-existingコマンド**: `src/commands/setup-existing.ts`を改善
+
+### Refactored
+- **コードクリーンアップ**: 不要なファイルを整理（#75）
+
 ## [0.0.9] - 2025-11-17
 
 ### Added

package/README.md

@@ -1,4 +1,5 @@
 # Michi (道)
+
 **M**anaged **I**ntelligent **C**omprehensive **H**ub for **I**ntegration
 
 AI駆動開発ワークフロー自動化プラットフォーム
@@ -12,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プロジェクト同時進行
@@ -31,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パッケージとしてインストール（推奨）
@@ -106,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作成＋バリデーション（必須）
@@ -122,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作成＋バリデーション（必須）
@@ -131,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 3: 追加QA（任意）
+# tasks.mdに従って統合テスト、E2Eテストを実施
+
+# Phase B: リリース準備テスト（任意）
+# 手動テスト、セキュリティテスト、パフォーマンステストを実施
 
-# Phase 6: リリース準備・リリース
+# 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>`
@@ -189,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
@@ -229,14 +359,14 @@ Michiは**cc-sdd準拠の多環境対応**を目指しています：
 
 #### プレースホルダー一覧
 
-| プレースホルダー | 説明 | 例 |
-|----------------|------|-----|
-| `{{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 |
+| プレースホルダー     | 説明             | 例                                       |
+| -------------------- | ---------------- | ---------------------------------------- |
+| `{{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                                |
 
 #### テンプレート例
 
@@ -244,24 +374,27 @@ Michiは**cc-sdd準拠の多環境対応**を目指しています：
 # 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公開に対応するため、以下のテンプレートファイルを用意しています：
@@ -271,7 +404,6 @@ OSS公開に対応するため、以下のテンプレートファイルを用
   - GitHub認証情報
   - プロジェクト固有設定
   - **ワークフロー承認ゲート設定**（オプション）
-  
 - **`mcp.json.example`**: MCP設定テンプレート
   - Cursor/VS Code用のAtlassian MCP設定
 
@@ -283,6 +415,7 @@ OSS公開に対応するため、以下のテンプレートファイルを用
   - **注意**: 以前は `.kiro/config.json` を使用していましたが、Michi専用の設定ファイルとして `.michi/config.json` に変更されました。
 
 **初回セットアップ時:**
+
 ```bash
 # 環境変数を設定
 cp env.example .env
@@ -371,29 +504,62 @@ npm run setup:interactive
 #### Gemini CLI
 
 ```bash
-# Step 1: cc-sdd導入
-npx cc-sdd@latest --gemini --lang ja
+# Step 1: cc-sdd導入（準備中 - 現在はスキップ可能）
+# npx cc-sdd@latest --gemini --lang ja
 
-# Step 2: Michi固有ファイル追加（Cursor互換モード）
-npx @sk8metal/michi-cli setup-existing --cursor --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@next --codex --lang ja
+# Step 1: cc-sdd導入（必須）
+npx cc-sdd@latest --codex --lang ja
 
-# Step 2: Michi固有ファイル追加（Cursor互換モード）
-npx @sk8metal/michi-cli setup-existing --cursor --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
@@ -424,6 +590,7 @@ npm run setup:interactive
 ```
 
 **自動的に追加されるもの**:
+
 - 共通ルール（`.cursor/rules/`または`.claude/rules/`）
 - Michi専用コマンド（`.cursor/commands/michi/`または`.claude/commands/michi/`）
 - Steeringテンプレート（`.kiro/steering/`）
@@ -454,21 +621,27 @@ npm run create-project -- \
 ## ドキュメント
 
 ### はじめに
+
 - [クイックスタート](./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公開手順
@@ -476,7 +649,6 @@ npm run create-project -- \
 
 すべてのドキュメントは [docs/README.md](./docs/README.md) から参照できます。
 
-
 ## CI/CD
 
 このプロジェクトでは、GitHub Actionsを使用してCI/CDパイプラインを構築しています。
@@ -503,6 +675,7 @@ npm run create-project -- \
 **設定手順**: [NPM_TOKEN設定ガイド](./docs/contributing/npm-token-setup.md)
 
 **設定内容**:
+
 1. NPMアカウントでAutomation Tokenを生成
 2. GitHub Secretsに`NPM_TOKEN`を追加
 
@@ -560,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
 ```
@@ -592,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単語推奨
 - 英数字とハイフン(`-`)のみ使用
 - スペース、アンダースコア、日本語は不可
@@ -612,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`             |
 
 #### 変換のコツ
 
@@ -631,11 +807,13 @@ feature名は以下の場所で使用されるため、**英語・小文字・
 #### 良い例・悪い例
 
 ✅ **良い例**:
+
 - `user-auth` - 短く明確
 - `payment-processing` - 具体的
 - `health-check` - 標準的な用語
 
 ❌ **悪い例**:
+
 - `ユーザー認証` - 日本語（URL/ラベルに不適）
 - `user_auth` - アンダースコア（kebab-caseではない）
 - `UserAuth` - CamelCase（kebab-caseではない）