@sk8metal/michi-cli 0.10.1 → 0.11.0

package/docs/guides/ai-tools.md

@@ -0,0 +1,311 @@
+# AIツール統合ガイド
+
+Michiは、Claude Code以外のAI開発ツールもサポートしています。
+このガイドでは、Cursor、Gemini CLI、Codex CLI、Clineの各ツールでMichiを使用するためのセットアップと基本的な使い方を説明します。
+
+## 対応AIツール一覧
+
+| ツール | 種別 | 推奨用途 | セットアップコマンド |
+|--------|------|---------|---------------------|
+| Claude Code | CLI | メイン開発ツール | `michi setup --claude` |
+| Cursor | エディタ統合 | コード編集・生成 | `michi setup --cursor` |
+| Gemini CLI | CLI | Google AI活用 | `michi setup --gemini` |
+| Codex CLI | CLI | プロンプトベース開発 | `michi setup --codex` |
+| Cline | VS Code拡張 | エディタ統合AI | `michi setup --cline` |
+
+**注意**: すべてのツールで同じワークフロー（`/kiro:*`、`/michi:*`コマンド）が利用可能です。
+
+## 共通セットアップ手順
+
+### 1. cc-sddのインストール
+
+すべてのツールで、まずcc-sddをインストールします。
+
+```bash
+npx cc-sdd@latest --lang ja
+```
+
+**生成されるファイル**:
+- `.kiro/settings/` - cc-sdd標準のルール、テンプレート（`.gitignore`対象）
+- `.kiro/steering/` - プロジェクト固有のコンテキスト
+- `.kiro/specs/` - 機能仕様（Git管理）
+
+### 2. 環境変数の設定（オプション）
+
+JIRA/Confluence連携を使用する場合、環境変数を設定してください。
+
+```bash
+# .envファイルに以下を追加
+ATLASSIAN_URL=https://your-domain.atlassian.net
+ATLASSIAN_EMAIL=your-email@example.com
+ATLASSIAN_API_TOKEN=your-api-token
+```
+
+詳細は [環境変数リファレンス](../reference/environment-variables.md) を参照してください。
+
+## Cursor
+
+### 概要
+
+Cursorは、AI統合エディタです。コードエディタ内でAIによるコード生成、リファクタリング、ドキュメント作成を行えます。
+
+### セットアップ
+
+```bash
+# Cursor固有の拡張をインストール
+michi setup --cursor
+```
+
+**生成されるファイル**:
+- `.cursor/rules/` - Cursor固有ルール
+  - `michi-core.md` - Michi基本原則
+  - `atlassian-mcp.md` - Atlassian MCP統合
+  - `github-ssot.md` - GitHub SSoT原則
+  - `multi-project.mdc` - マルチプロジェクト管理
+- `.cursor/commands/michi/` - Michiコマンド
+  - `confluence-sync.md` - Confluence同期
+  - `project-switch.md` - プロジェクト切り替え
+- `.cursor/commands/kiro/` - Kiroコマンド
+  - `kiro-spec-tasks.md` - タスク分割
+  - `kiro-spec-impl.md` - TDD実装
+
+### 利用可能なコマンド
+
+Cursorでは、以下のコマンドが利用できます：
+
+```bash
+# cc-sdd標準コマンド
+/kiro:spec-init "機能の説明"
+/kiro:spec-requirements {feature}
+/kiro:spec-design {feature}
+/michi:spec-tasks {feature}
+/kiro:spec-impl {feature}
+
+# Michi拡張コマンド
+/michi:confluence-sync {feature} {type}
+/michi:project-switch
+```
+
+### 特徴
+
+- エディタ内でのリアルタイムコード提案
+- MCP（Model Context Protocol）によるAtlassian統合
+- プロジェクト切り替え機能
+
+## Gemini CLI
+
+### 概要
+
+Gemini CLIは、Google AIを活用したCLIツールです。プロンプトベースで仕様書やコードを生成できます。
+
+### セットアップ
+
+```bash
+# Gemini CLI固有の拡張をインストール
+michi setup --gemini
+```
+
+**生成されるファイル**:
+- `.gemini/GEMINI.md` - Gemini CLI設定
+- `.gemini/commands/` - Gemini CLI専用コマンド
+
+### 利用可能なコマンド
+
+Gemini CLIでは、以下のコマンドが利用できます：
+
+```bash
+# cc-sdd標準コマンド
+/kiro:spec-init "機能の説明"
+/kiro:spec-requirements {feature}
+/kiro:spec-design {feature}
+/michi:spec-tasks {feature}
+/kiro:spec-impl {feature}
+
+# Gemini固有の操作
+# GitHubにコミット後、Confluence同期を実行
+michi confluence:sync {feature} requirements
+```
+
+### 特徴
+
+- Google AIの最新モデルを使用
+- プロジェクトコンテキスト（`.kiro/project.json`）の自動参照
+- GitHub SSoT原則（GitHub→Confluence同期）
+
+## Codex CLI
+
+### 概要
+
+Codex CLIは、プロンプトベースのAI開発ツールです。エージェントベースのワークフローをサポートします。
+
+### セットアップ
+
+```bash
+# Codex CLI固有の拡張をインストール
+michi setup --codex
+```
+
+**生成されるファイル**:
+- `AGENTS.override.md` - Codex CLI用エージェント設定
+- `.codex/prompts/` - Codex CLI専用プロンプト
+  - `confluence-sync.md` - Confluence同期プロンプト
+
+### 利用可能なプロンプト
+
+Codex CLIでは、以下のプロンプトが利用できます：
+
+```bash
+# cc-sdd標準フロー
+/kiro:spec-init FEATURE=calculator-app
+/kiro:spec-requirements FEATURE=calculator-app
+/kiro:spec-design FEATURE=calculator-app
+/michi:spec-tasks FEATURE=calculator-app
+/kiro:spec-impl FEATURE=calculator-app
+
+# Michi拡張プロンプト
+/prompts:confluence-sync FEATURE=calculator-app
+```
+
+### 特徴
+
+- エージェントベースのワークフロー
+- Michi固有のテスト戦略（マスタテスト方式）
+- 対応言語: Node.js、Java（Gradle）、PHP
+
+### テスト戦略
+
+Codex CLIでは、Michi固有のマスタテスト方式を採用しています。
+
+**Phase A（PR時に自動実行）**:
+- 単体テスト
+- Lint
+- ビルド
+
+**Phase B（リリース前に手動実行）**:
+- 統合テスト
+- E2Eテスト
+- パフォーマンステスト
+- セキュリティテスト
+
+詳細は [ワークフローガイド](workflow.md) を参照してください。
+
+## Cline
+
+### 概要
+
+Clineは、VS Code拡張機能として動作するAIツールです。エディタ内でAIによるコード生成、リファクタリング、ドキュメント作成を行えます。
+
+### セットアップ
+
+```bash
+# Cline固有の拡張をインストール
+michi setup --cline
+```
+
+**生成されるファイル**:
+- `.clinerules/rules/` - Cline固有ルール
+  - `michi-core.md` - Michi基本原則
+  - `atlassian-integration.md` - Atlassian統合ルール
+
+### 利用可能な機能
+
+Clineでは、以下の機能が利用できます：
+
+```bash
+# cc-sdd標準コマンド
+/kiro:spec-init "機能の説明"
+/kiro:spec-requirements {feature}
+/kiro:spec-design {feature}
+/michi:spec-tasks {feature}
+/kiro:spec-impl {feature}
+
+# Michi拡張
+# エディタ内でAtlassian統合を使用
+```
+
+### 特徴
+
+- VS Code拡張として動作
+- エディタ内でのリアルタイムコード提案
+- GitHub SSoT原則のサポート
+- Multi-Project管理機能
+
+## 共通注意事項
+
+### ワークフローの一貫性
+
+すべてのAIツールで、同じワークフロー（cc-sdd + Michi拡張）が利用できます。
+
+**基本フロー**:
+```
+Phase 0.0 → 0.1 → 0.2 → 0.5 → Phase 2
+```
+
+**完全フロー（Michi拡張含む）**:
+```
+Phase 0.0 → 0.1 → 0.2 → [0.3-0.4] → 0.5 → 0.6-0.7
+  → Phase 1 → Phase 2 → Phase A → Phase 3 → Phase B → Phase 4-5
+```
+
+詳細は [ワークフローガイド](workflow.md) を参照してください。
+
+### GitHub SSoT原則
+
+すべてのツールで、GitHub SSoT（Single Source of Truth）原則を遵守します。
+
+**基本原則**:
+- すべての仕様はGitHub（`.kiro/specs/`）で管理
+- Confluenceは参照と承認のみ（編集はGitHubのみ）
+- 重複管理を避ける
+
+**データフロー**:
+```
+GitHub (.kiro/specs/)  ← 真実の源（編集可能）
+    ↓ 同期
+Confluence ← 表示と承認（読み取り専用）
+```
+
+### Multi-Project管理
+
+すべてのツールで、Multi-Project管理機能が利用できます。
+
+**プロジェクトメタデータ**（`.kiro/project.json`）:
+```json
+{
+  "projectId": "my-project",
+  "jiraProjectKey": "MYPROJ",
+  "confluenceSpaceKey": "MYSPACE",
+  "confluenceLabels": ["ai-development", "michi"]
+}
+```
+
+詳細は [Multi-Repoガイド](multi-repo.md) を参照してください。
+
+### コマンド実行方法の違い
+
+| ツール | コマンド形式 | 実行場所 |
+|--------|------------|---------|
+| Claude Code | `/kiro:*`, `/michi:*` | CLI |
+| Cursor | `/kiro:*`, `/michi:*` | エディタ内 |
+| Gemini CLI | `/kiro:*`, `michi *` | CLI |
+| Codex CLI | `/kiro:*`, `/prompts:*` | CLI |
+| Cline | `/kiro:*`, `/michi:*` | VS Code拡張 |
+
+## 推奨ツールの選び方
+
+| 用途 | 推奨ツール | 理由 |
+|------|-----------|------|
+| メイン開発 | Claude Code | 最も完全な統合、サブエージェント機能 |
+| コード編集 | Cursor | エディタ統合、リアルタイム提案 |
+| Google AI活用 | Gemini CLI | Google AIの最新モデル |
+| プロンプトベース | Codex CLI | エージェントベースワークフロー |
+| VS Code統合 | Cline | VS Code拡張、エディタ内完結 |
+
+## 関連ドキュメント
+
+- [Claude Codeセットアップガイド](claude-code.md) - Claude Code固有のセットアップ
+- [AIコマンドリファレンス](../reference/ai-commands.md) - すべてのコマンドの詳細
+- [ワークフローガイド](workflow.md) - 開発ワークフロー全体像
+- [Atlassian連携ガイド](atlassian-integration.md) - JIRA/Confluence連携の詳細
+- [環境変数リファレンス](../reference/environment-variables.md) - 環境変数の詳細設定
+- [トラブルシューティング](../troubleshooting.md) - よくある問題と解決策

package/docs/guides/atlassian-integration.md

@@ -0,0 +1,116 @@
+# Atlassian連携ガイド
+
+JIRA と Confluence との連携機能を説明します。
+
+## 前提条件
+
+### 環境変数の設定
+
+以下の環境変数が必要です。
+
+**必須**:
+- `ATLASSIAN_URL` - Atlassianドメイン（例: `https://your-domain.atlassian.net`）
+- `ATLASSIAN_EMAIL` - Atlassianアカウントのメールアドレス
+- `ATLASSIAN_API_TOKEN` - Atlassian APIトークン
+
+**オプション**:
+- `CONFLUENCE_PRD_SPACE` - Confluenceスペースキー（デフォルト: PRD）
+
+**APIトークン取得**: https://id.atlassian.com/manage-profile/security/api-tokens から取得します。
+
+**設定方法**: `.env` または `~/.michi/.env` ファイルでの設定方法と優先順位については、[環境変数リファレンス](../reference/environment-variables.md) を参照してください。
+
+## Confluence同期
+
+### 基本的な使い方
+
+```bash
+michi confluence:sync my-feature              # 要件定義
+michi confluence:sync my-feature design       # 設計書
+michi confluence:sync my-feature tasks        # タスク
+```
+
+### 設定
+
+`.michi/config.json` でカスタマイズできます。
+
+```json
+{
+  "confluence": {
+    "spaces": {
+      "requirements": "PRD",
+      "design": "TECH"
+    },
+    "pageCreationGranularity": "hierarchical",
+    "autoLabels": ["{projectLabel}", "{docType}", "github-sync"]
+  }
+}
+```
+
+**pageCreationGranularity**:
+- `single`: 1ページ（デフォルト）
+- `hierarchical`: 見出しごとに子ページ
+
+### レートリミット
+
+```bash
+export ATLASSIAN_REQUEST_DELAY=1000  # ミリ秒
+```
+
+## JIRA同期
+
+### 基本的な使い方
+
+```bash
+michi jira:sync my-feature
+```
+
+### Story詳細設定
+
+```markdown
+### Story 1.1: ユーザー認証
+
+**説明**: OAuth2認証の実装
+**優先度**: High
+**見積もり**: 5 SP
+**期限**: 2025-01-15
+
+**完了条件**:
+- [ ] OAuth2認証フロー
+- [ ] トークン管理
+
+**依存関係**: DB設計完了
+```
+
+### その他の操作
+
+```bash
+michi jira:transition PROJ-123 "In Progress"
+michi jira:comment PROJ-123 "実装完了"
+```
+
+## トラブルシューティング
+
+### Epic Linkが設定されない
+
+```bash
+export JIRA_EPIC_LINK_FIELD=customfield_10014
+```
+
+### Story Pointsが設定されない
+
+```bash
+export JIRA_STORY_POINTS_FIELD=customfield_10016
+```
+
+### APIレート制限エラー
+
+```bash
+export ATLASSIAN_REQUEST_DELAY=2000
+```
+
+## 関連リンク
+
+- [設定ガイド](configuration.md)
+- [ワークフローガイド](workflow.md)
+- [Multi-Repoガイド](multi-repo.md)

package/docs/guides/claude-code.md

@@ -0,0 +1,155 @@
+# Claude Code セットアップガイド
+
+Michiは、Claude Codeを第一級のAI開発ツールとしてサポートしています。このガイドでは、Claude CodeでMichiを使用するためのセットアップと基本的な使い方を説明します。
+
+## Claude Codeとは
+
+Claude Codeは、Anthropic社が提供する公式CLI（コマンドラインインターフェース）です。プロジェクトのコンテキストを理解し、コード生成、ドキュメント作成、テスト駆動開発をサポートします。
+
+**主な特徴**:
+- プロジェクト固有のルール（CLAUDE.md）による動作制御
+- カスタムコマンド、スキル、サブエージェントの拡張機能
+- cc-sdd（Spec-Driven Development Core）との統合
+
+## セットアップ手順
+
+### 1. cc-sddのインストール
+
+Michiは、cc-sddを基盤フレームワークとして使用します。以下のコマンドでcc-sddをインストールしてください。
+
+```bash
+npx cc-sdd@latest --claude-agent --lang ja
+```
+
+**生成されるファイル**:
+- `.kiro/settings/` - cc-sdd標準のルール、テンプレート（`.gitignore`対象）
+- `.kiro/steering/` - プロジェクト固有のコンテキスト
+- `.kiro/specs/` - 機能仕様（Git管理）
+
+### 2. Michi拡張のインストール
+
+cc-sddをインストールした後、Michi固有の拡張機能を追加します。
+
+```bash
+michi setup --claude
+```
+
+**生成されるファイル**:
+- `.claude/commands/michi/` - Michi固有コマンド
+- `.claude/rules/` - Michi固有ルール
+- `.claude/agents/` - サブエージェント定義
+- `.claude/skills/` - スキル定義
+
+### 3. 環境変数の設定（オプション）
+
+JIRA/Confluence連携を使用する場合、環境変数を設定してください。
+
+```bash
+# .envファイルに以下を追加
+ATLASSIAN_URL=https://your-domain.atlassian.net
+ATLASSIAN_EMAIL=your-email@example.com
+ATLASSIAN_API_TOKEN=your-api-token
+```
+
+詳細は [環境変数リファレンス](../reference/environment-variables.md) を参照してください。
+
+## Michiとの統合
+
+### 利用可能なコマンド
+
+Claude Codeでは、以下のコマンドが利用できます。
+
+#### cc-sdd標準コマンド
+
+| コマンド | 機能説明 |
+|---------|---------|
+| `/kiro:spec-init` | 新規仕様を初期化 |
+| `/kiro:spec-requirements` | 要件定義を作成 |
+| `/kiro:spec-design` | 設計書を作成 |
+| `/kiro:spec-tasks` | タスク分割とJIRA同期 |
+| `/kiro:spec-impl` | TDD実装を実行 |
+
+#### Michi拡張コマンド
+
+| コマンド | 機能説明 | 備考 |
+|---------|---------|------|
+| `/michi:spec-design` | テスト計画統合設計書を作成 | Phase 0.3-0.4ガイダンス付き |
+| `/michi:test-planning` | テスト計画を実行 | テストタイプ選択+仕様書作成 |
+| `/michi:validate-design` | テスト計画レビュー | テスト計画完了確認付き |
+| `/michi:spec-tasks` | タスク分割+JIRA同期確認 | JIRA連携オプション付き |
+| `/michi:spec-impl` | TDD実装+品質自動化 | ライセンス/バージョン監査+レビュー |
+| `/michi:confluence-sync` | Confluence同期 | 要件定義書/設計書を同期 |
+
+### スキルとサブエージェント
+
+Michiは、Claude Codeのスキルとサブエージェント機能を拡張します。
+
+**利用可能なスキル**:
+- `design-review`: UIデザインレビュー（アクセシビリティ、レスポンシブ、UXパターン、パフォーマンス）
+- `e2e-first-planning`: E2Eテストファースト計画
+- `oss-license`: OSSライセンスチェック
+- `stable-version`: バージョン監査
+
+**利用可能なサブエージェント**:
+- `design-reviewer`: 設計レビュー担当
+- `e2e-first-planner`: E2Eテスト計画担当
+- `oss-license-checker`: OSSライセンスチェック担当
+- `stable-version-auditor`: バージョン監査担当
+
+## 基本的な使い方
+
+### 新機能の開発フロー
+
+```bash
+# 1. 仕様の初期化
+/kiro:spec-init "計算機アプリケーション: 四則演算を行う"
+
+# 2. 要件定義
+/kiro:spec-requirements calculator-app
+
+# 3. 設計（Michi推奨: テスト計画ガイダンス付き）
+/michi:spec-design calculator-app
+
+# 4. テスト計画（任意）
+/michi:test-planning calculator-app
+
+# 5. タスク分割（Michi推奨: JIRA同期確認付き）
+/michi:spec-tasks calculator-app
+
+# 6. TDD実装（Michi推奨: 品質自動化付き）
+/michi:spec-impl calculator-app
+```
+
+### Multi-Repoプロジェクトの場合
+
+Multi-Repoプロジェクトでは、以下のコマンドが利用できます。
+
+```bash
+# 1. プロジェクト初期化
+/michi-multi-repo:spec-init
+
+# 2. 要件定義
+/michi-multi-repo:spec-requirements my-project
+
+# 3. 設計
+/michi-multi-repo:spec-design my-project
+
+# 4. クロスリポジトリレビュー
+/michi-multi-repo:spec-review my-project
+
+# 5. 各リポジトリへ仕様展開
+/michi-multi-repo:propagate-specs my-project
+
+# 6. 全リポジトリで実装実行
+/michi-multi-repo:impl-all my-project
+```
+
+詳細は [Multi-Repoガイド](multi-repo.md) を参照してください。
+
+## 関連ドキュメント
+
+- [AIコマンドリファレンス](../reference/ai-commands.md) - すべてのコマンドの詳細
+- [ワークフローガイド](workflow.md) - 開発ワークフロー全体像
+- [Atlassian連携ガイド](atlassian-integration.md) - JIRA/Confluence連携の詳細
+- [環境変数リファレンス](../reference/environment-variables.md) - 環境変数の詳細設定
+- [トラブルシューティング](../troubleshooting.md) - よくある問題と解決策

package/docs/guides/multi-repo.md

@@ -0,0 +1,117 @@
+# Multi-Repoガイド
+
+複数リポジトリにまたがるプロジェクトを一元管理します。
+
+## Multi-Repoとは
+
+**特徴**:
+- 複数リポジトリの仕様書を一元管理
+- CI/CD結果の集約表示
+- クロスリポジトリのテスト実行
+- Confluenceへの統合同期
+
+## プロジェクト管理
+
+### 初期化
+
+```bash
+michi multi-repo:init my-project --jira MYPROJ --confluence-space MYPROJ
+```
+
+### リポジトリ追加
+
+```bash
+michi multi-repo:add-repo my-project \
+  --name frontend \
+  --url https://github.com/myorg/frontend.git \
+  --branch main
+```
+
+### 一覧表示
+
+```bash
+michi multi-repo:list
+```
+
+## Confluence同期
+
+```bash
+michi multi-repo:sync my-project
+michi multi-repo:confluence-sync my-project --doc-type requirements
+```
+
+**ドキュメントタイプ**:
+- requirements, architecture, sequence
+- strategy, ci-status, release-notes
+
+## CI結果の集約
+
+```bash
+michi multi-repo:ci-status my-project
+michi multi-repo:ci-status my-project --diff
+```
+
+## テスト実行
+
+```bash
+michi multi-repo:test my-project --type e2e
+michi multi-repo:test my-project --type integration
+michi multi-repo:test my-project --type performance
+```
+
+## AIコマンド
+
+Multi-Repo専用のAIコマンドが利用できます。
+
+```
+/michi-multi-repo:spec-init
+/michi-multi-repo:spec-requirements my-project
+/michi-multi-repo:spec-design my-project
+/michi-multi-repo:spec-review my-project
+/michi-multi-repo:propagate-specs my-project
+/michi-multi-repo:impl-all my-project
+```
+
+各コマンドの詳細な機能説明とパラメータについては、[AIコマンドリファレンス](../reference/ai-commands.md#multi-repoコマンド) を参照してください。
+
+## ベストプラクティス
+
+**リポジトリ分割**:
+- マイクロサービス単位で分割
+- 独立デプロイ可能な単位で分割
+- 過度に細かい分割は避ける
+
+**CI/CD戦略**:
+- 各リポジトリで独立パイプライン
+- Multi-Repoレベルで統合テスト
+- CI結果を定期的に集約
+
+**バージョン管理**:
+- セマンティックバージョニング統一
+- 互換性を明記
+- 依存関係を `multi-repo.md` に記載
+
+## トラブルシューティング
+
+### リポジトリが追加できない
+
+```bash
+michi multi-repo:list
+cat .michi/config.json
+```
+
+### CI結果が取得できない
+
+- GitHub APIトークンに `repo` 権限が必要
+- リポジトリURLを確認
+
+### テスト実行が失敗
+
+- `docs/michi/{project}/tests/scripts/` にスクリプト配置
+- 実行権限を付与（`chmod +x`）
+
+## 関連リンク
+
+- [Atlassian連携ガイド](atlassian-integration.md)
+- [ワークフローガイド](workflow.md)
+- [AIコマンドリファレンス](../reference/ai-commands.md)