@sk8metal/michi-cli 0.11.0 → 0.13.0

package/docs/guides/ai-tools.md

@@ -1,311 +0,0 @@
-# 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/templates/cline/rules/atlassian-integration.md

@@ -1,36 +0,0 @@
-# Atlassian Integration Rules
-
-## Confluence Integration
-
-### Page Creation Format
-- Title: `[{{PROJECT_ID}}] {document_type}`
-- Labels: Use {{KIRO_DIR}}/project.json `confluenceLabels`
-- Space: Reference environment variables (CONFLUENCE_PRD_SPACE, etc.)
-
-### Content Sync
-- Source: GitHub {{KIRO_DIR}}/specs/
-- Destination: Confluence pages
-- Sync tool: `npm run confluence:sync`
-
-## JIRA Integration
-
-### Issue Creation Format
-- Summary: `[{{JIRA_KEY}}] {title}`
-- Project Key: Use {{KIRO_DIR}}/project.json `jiraProjectKey`
-- Labels: Derived from Confluence labels
-
-### Workflow
-1. Generate specs in GitHub
-2. Create JIRA epics/stories
-3. Link Confluence pages to JIRA issues
-
-## Environment Variables
-
-Required variables (from .env):
-- `ATLASSIAN_URL`
-- `ATLASSIAN_EMAIL`
-- `ATLASSIAN_API_TOKEN`
-- `JIRA_PROJECT_KEYS`
-- `CONFLUENCE_PRD_SPACE`
-- `CONFLUENCE_QA_SPACE`
-- `CONFLUENCE_RELEASE_SPACE`

package/templates/cline/rules/michi-core.md

@@ -1,56 +0,0 @@
-# Michi Core Principles
-
-## Development Guidelines
-{{DEV_GUIDELINES}}
-
-## Language
-All generated documents should be in: **{{LANG_CODE}}**
-
-Reference the language field in {{KIRO_DIR}}/project.json.
-
-## Single Source of Truth (SSoT)
-
-### GitHub as SSoT
-- **All specifications are managed in GitHub** ({{KIRO_DIR}}/specs/)
-- Confluence is **reference and approval only** (editing is GitHub only)
-- Avoid duplicate management
-
-### Data Flow
-```
-GitHub ({{KIRO_DIR}}/specs/)  ← Source of truth (editable)
-    ↓ sync
-Confluence ← Display and approval (read-only)
-```
-
-## Multi-Project Management
-
-### Project Identification
-- All operations reference {{KIRO_DIR}}/project.json
-- Dynamically use project ID, JIRA key, Confluence labels
-- Project ID: {{PROJECT_ID}}
-
-### Naming Conventions
-
-#### Confluence Pages
-- Format: `[{projectName}] {document_type}`
-- Example: `[{{PROJECT_ID}}] Requirements`
-
-#### JIRA Epic/Story
-- Format: `[{JIRA_KEY}] {title}`
-- Use project metadata from {{KIRO_DIR}}/project.json
-
-## Project Structure
-
-- Project metadata: {{KIRO_DIR}}/project.json
-- Specifications: {{KIRO_DIR}}/specs/
-- Templates: {{KIRO_DIR}}/settings/templates/
-- Steering: {{KIRO_DIR}}/steering/
-- Rules: {{AGENT_DIR}}/rules/
-
-## Best Practices
-
-1. **Always reference project.json** for project-specific metadata
-2. **Use SSoT principle** - Edit in GitHub, reference in Confluence
-3. **Follow naming conventions** for consistency
-4. **Generate specs incrementally** - Requirements → Design → Tasks
-5. **Commit frequently** to GitHub

package/templates/codex/AGENTS.override.md

@@ -1,277 +0,0 @@
-# AGENTS.override.md - Michi Project Extensions
-
-このファイルはcc-sddのAGENTS.mdを拡張し、Michi固有のワークフローとルールを追加します。
-
-## Michi Overview
-
-**Michi**は、AI駆動開発を支援するプロジェクト管理・ドキュメント管理フレームワークです。Claude Code、Cursor、Codex CLI、Claude Agent SDKと統合し、効率的な開発フローを実現します。
-
-- **Repository**: https://github.com/sk8metalme/michi
-- **Documentation**: `docs/user-guide/`
-- **License**: MIT
-
----
-
-## Michi-Specific Workflows
-
-### 1. Confluence Integration
-
-#### Confluence同期コマンド
-```bash
-/prompts:confluence-sync FEATURE=<機能名>
-```
-
-#### 必要な環境変数
-```bash
-ATLASSIAN_URL=https://your-domain.atlassian.net
-ATLASSIAN_EMAIL=your-email@example.com
-ATLASSIAN_API_TOKEN=your-api-token
-```
-
-#### プロジェクト設定
-`.kiro/project.json`に以下を設定：
-```json
-{
-  "confluenceSpaceKey": "YOUR_SPACE",
-  "confluenceLabels": ["ai-development", "michi"]
-}
-```
-
-#### 同期対象
-- 要件定義書（requirements.md）→ Confluenceページ
-- 設計書（design.md）→ Confluenceページ
-- タスク一覧（tasks.md）→ Confluenceページ（オプション）
-
----
-
-### 2. JIRA Integration
-
-#### プロジェクトキー設定
-`.kiro/project.json`の`jiraProjectKey`を使用してJIRAチケットを管理：
-```json
-{
-  "jiraProjectKey": "MYPROJ"
-}
-```
-
-#### リリース管理
-- JIRAでリリースバージョンを作成
-- Confluenceでリリース手順書を管理
-- GitHub Releasesと連携
-
----
-
-### 3. Multi-Language Support
-
-Michiは以下の言語とビルドツールをサポート：
-
-| 言語 | ビルドツール | テストコマンド |
-|------|------------|---------------|
-| Node.js/TypeScript | npm | `npm test` |
-| Java | **Gradle のみ** | `./gradlew test` |
-| PHP | Composer | `composer test` |
-
-**重要:** Javaプロジェクトでは**Gradleのみ**を使用してください。Mavenは使用しません。
-
----
-
-### 4. Test Strategy - Master Test Approach
-
-Michiは**マスタテスト方式**を採用しています：
-
-#### 基本原則
-- テストは常に最新の仕様を反映（phase-0、phase-1のような履歴管理はしない）
-- 仕様変更時は既存のテストファイルを更新
-- テスト実行時間を一定に保つ
-
-#### Phase構成
-- **Phase A**: PR時に自動実行
-  - Unit tests
-  - Lint
-  - Build
-- **Phase B**: リリース前に手動実行
-  - Integration tests
-  - E2E tests
-  - Performance tests
-  - Security tests
-
-#### テストカバレッジ
-- 目標: **95%以上**
-- テストは仕様として扱う
-- 実装に合わせてテストを変更しない（仕様通りでない場合のみ修正）
-
----
-
-### 5. CI/CD Integration
-
-#### サポート対象
-- **GitHub Actions**
-- **Screwdriver**
-
-#### 推奨ワークフロー
-```yaml
-# .github/workflows/ci.yml
-name: CI
-on: [pull_request]
-jobs:
-  test:
-    runs-on: ubuntu-latest
-    steps:
-      - uses: actions/checkout@v3
-      - name: Run Phase A Tests
-        run: |
-          npm install
-          npm run test:unit
-          npm run lint
-          npm run build
-```
-
----
-
-### 6. Release Flow
-
-#### セマンティックバージョニング
-```
-v<major>.<minor>.<patch>
-例: v1.2.3
-```
-
-#### リリース手順
-1. **Confluenceでリリース手順書作成**
-   - テンプレート: `.kiro/templates/release-procedure.md`
-2. **JIRAでリリースチケット起票**
-   - チケットタイプ: Release
-   - バージョン: 自動生成
-3. **GitHub Releaseの作成**
-   - リリースノート自動生成
-   - タグ付け
-
----
-
-## Coding Standards
-
-### TypeScript/Node.js
-- **Style Guide**: Airbnb JavaScript Style Guide準拠
-- **Linter**: ESLint
-- **Formatter**: Prettier
-- **Type Checking**: `tsc --noEmit`
-
-### Java (Gradle)
-- **Style Guide**: Google Java Style Guide
-- **Build Tool**: Gradle 8.x
-- **Test Framework**: JUnit 5
-- **Coverage**: JaCoCo
-
-### PHP
-- **Style Guide**: PSR-12
-- **Build Tool**: Composer
-- **Test Framework**: PHPUnit
-- **Static Analysis**: PHPStan
-
----
-
-## File Structure Standards
-
-### .kiro/ Directory
-```
-.kiro/
-├── project.json              # プロジェクトメタデータ
-├── specs/                    # 機能仕様（cc-sdd管理）
-│   └── {feature}/
-│       ├── requirements.md
-│       ├── design.md
-│       ├── tasks.md
-│       └── spec.json
-├── steering/                 # AI指導ルール（cc-sdd管理）
-│   ├── structure.md
-│   ├── tech.md
-│   └── product.md
-└── settings/                 # 共通ルール（cc-sdd管理）
-```
-
-### Michi Extensions
-```
-.kiro/
-├── project.json              # ⭐ Michi固有
-└── templates/                # ⭐ Michi固有
-    ├── confluence-page.md
-    ├── jira-ticket.md
-    └── release-procedure.md
-```
-
----
-
-## Security Policy
-
-### 環境変数管理
-- **絶対禁止**: APIキー、トークンのハードコード
-- **推奨**: `.env`ファイル + `.gitignore`
-- **CI/CD**: GitHub Secrets / Screwdriver Secrets
-
-### 依存関係管理
-- 定期的な脆弱性スキャン（`npm audit`, `snyk`）
-- 依存ライブラリの最小化
-- 信頼できるソースからのみダウンロード
-
----
-
-## Workflow Integration
-
-### cc-sdd + Michi 連携フロー
-
-1. **プロジェクト初期化**
-   ```bash
-   # cc-sddインストール
-   npx cc-sdd@latest --codex --lang ja
-
-   # Michi拡張インストール
-   npx michi setup --codex
-   ```
-
-2. **仕様作成（cc-sdd）**
-   ```bash
-   /kiro:spec-init FEATURE=user-auth
-   /kiro:spec-requirements FEATURE=user-auth
-   /kiro:spec-design FEATURE=user-auth
-   ```
-
-3. **Confluence同期（Michi）**
-   ```bash
-   /prompts:confluence-sync FEATURE=user-auth
-   ```
-
-4. **実装とテスト（cc-sdd + TDD）**
-   ```bash
-   /michi:spec-tasks FEATURE=user-auth
-   /kiro:spec-impl FEATURE=user-auth
-   ```
-
-5. **検証（cc-sdd）**
-   ```bash
-   /kiro:validate-impl FEATURE=user-auth
-   ```
-
----
-
-## Communication Guidelines
-
-### 日本語優先
-- コミュニケーションは日本語を基本とする
-- 技術用語は適切に英語/日本語を使い分ける
-
-### 質問と確認
-- 不明な点は必ず質問し精度を高めることを最優先する
-- AskUserQuestionツールを積極的に活用
-
----
-
-## Reference Links
-
-- [Michi Documentation](https://github.com/sk8metalme/michi/tree/main/docs)
-- [cc-sdd Documentation](https://github.com/gotalab/cc-sdd)
-- [Confluence API](https://developer.atlassian.com/cloud/confluence/rest/v2/)
-- [JIRA API](https://developer.atlassian.com/cloud/jira/platform/rest/v3/)
-
----
-
-**Note**: このファイルはCodex CLIの`AGENTS.md`を上書き（override）するものではなく、cc-sddの基本ルールに**追加**される形で適用されます。