@sk8metal/michi-cli 0.11.0 → 0.12.0

package/templates/cursor/commands/michi/project-switch.md

@@ -1,69 +0,0 @@
----
-name: /michi:project-switch
-description: プロジェクトを切り替える
----
-
-# プロジェクト切り替えコマンド
-
-{{DEV_GUIDELINES}}
-
-複数プロジェクトを管理している場合、プロジェクトを切り替えるコマンドです。
-
-## 使い方
-
-```
-/michi:project-switch <project_id>
-```
-
-**パラメータ**:
-- `project_id`: プロジェクトID（例: customer-a-service-1, michi）
-
-**例**:
-```
-/michi:project-switch michi
-/michi:project-switch customer-a-service-1
-```
-
-## 実行内容
-
-1. プロジェクトIDに対応するGitHubリポジトリを特定
-2. ローカルにクローン（未クローンの場合）またはチェックアウト
-3. `{{KIRO_DIR}}/project.json` を読み込んで表示
-4. 対応するConfluenceプロジェクトページのURLを表示
-5. JIRAプロジェクトダッシュボードのURLを表示
-
-## 出力例
-
-```
-✅ プロジェクト切り替え: michi
-
-プロジェクト情報:
-  名前: Michi - Managed Intelligent Comprehensive Hub for Integration
-  JIRA: MICHI
-  Confluence Labels: project:michi, service:hub
-  ステータス: active
-  チーム: @arigatatsuya
-
-リンク:
-  📄 Confluence: https://your-domain.atlassian.net/wiki/spaces/PRD/pages/
-  🎯 JIRA Dashboard: https://your-domain.atlassian.net/jira/projects/MICHI
-  🐙 GitHub: https://github.com/sk8metalme/michi
-```
-
-## ターミナル実行
-
-```bash
-# リポジトリをクローン/チェックアウト
-cd ~/work/projects
-jj git clone https://github.com/org/<project_id>
-cd <project_id>
-
-# プロジェクト情報を表示
-cat {{KIRO_DIR}}/project.json
-```
-
-## 関連コマンド
-
-- `/michi:project-list`: すべてのプロジェクトを一覧表示
-- `/kiro:spec-status`: 現在のプロジェクトの仕様ステータスを表示（cc-sdd標準コマンド）
-

package/templates/cursor/commands/michi/spec-tasks.md

@@ -1,117 +0,0 @@
----
-name: /michi:spec-tasks
-description: Generate implementation tasks with JIRA sync option (Michi version)
-allowed-tools: Read, Write, Edit, MultiEdit, Glob, Grep, Bash
-argument-hint: <feature-name> [-y] [--sequential]
----
-
-# Michi: Spec Tasks with JIRA Sync Option
-
-## Base Command Reference
-@.claude/commands/kiro/spec-tasks.md
-
-## Development Guidelines
-{{DEV_GUIDELINES}}
-
----
-
-## Michi Extension: JIRA Sync Prompt
-
-このコマンドは cc-sdd 標準の `/kiro:spec-tasks` を拡張し、タスク生成完了後にJIRA同期オプションを提示します。
-
-### 機能追加内容
-
-1. **タスク生成完了後の次ステップ案内**:
-   - JIRA連携が設定されている場合: JIRA同期の選択肢（A/B/C形式）を表示
-   - JIRA連携が未設定の場合: 実装フェーズへの案内 + JIRA設定ヒントを表示
-
-2. **環境変数による条件分岐**:
-   - 以下の環境変数がすべて設定されている場合のみ、JIRA同期の選択肢を表示
-   - `ATLASSIAN_URL`
-   - `ATLASSIAN_EMAIL`
-   - `ATLASSIAN_API_TOKEN`
-
----
-
-## タスク生成完了後のフロー
-
-基底コマンド `/kiro:spec-tasks` によるタスク生成が完了した後、以下のフローを実行してください:
-
-### Step 1: 環境変数チェック
-
-```bash
-# JIRA連携の環境変数をチェック
-if [ -n "$ATLASSIAN_URL" ] && [ -n "$ATLASSIAN_EMAIL" ] && [ -n "$ATLASSIAN_API_TOKEN" ]; then
-    JIRA_CONFIGURED=true
-else
-    JIRA_CONFIGURED=false
-fi
-```
-
-### Step 2a: JIRA連携が設定されている場合の表示
-
-`JIRA_CONFIGURED=true` の場合、以下のメッセージと選択肢を表示:
-
-```
-============================================
- タスク生成完了 - JIRA同期オプション
-============================================
-
-次のアクション:
-A) JIRAにタスクを同期する（推奨: タスク管理を一元化）
-   → `michi jira:sync {{FEATURE_NAME}}` を実行
-
-B) JIRAへの同期をスキップして実装に進む
-   → `/michi:spec-impl {{FEATURE_NAME}}` を実行
-
-C) 何もせずにこのまま終了する
-
-選択 (A/B/C): _
-```
-
-**選択肢の説明**:
-- **A**: Epic/Story/Subtaskを自動作成し、タスクをJIRAに同期します
-- **B**: JIRA同期をスキップして直接TDD実装フェーズに進みます
-- **C**: タスク生成のみで終了し、ユーザーが手動で次のステップを選択します
-
-### Step 2b: JIRA連携が未設定の場合の表示
-
-`JIRA_CONFIGURED=false` の場合、以下のメッセージを表示:
-
-```
-============================================
- タスク生成完了
-============================================
-
-次のステップ:
-→ `/michi:spec-impl {{FEATURE_NAME}}` で実装を開始
-
----
-ℹ️ ヒント: JIRA連携を使用すると、タスクを自動的にJIRAに同期できます。
-
-設定方法: 以下の環境変数を .env に追加してください:
-   - ATLASSIAN_URL=https://your-domain.atlassian.net
-   - ATLASSIAN_EMAIL=your-email@company.com
-   - ATLASSIAN_API_TOKEN=your-api-token
-
-詳細はドキュメントを参照: docs/guides/atlassian-integration.md
-```
-
----
-
-## 実装上の注意点
-
-1. **基底コマンドの実行結果を維持**:
-   - `/kiro:spec-tasks` の「Output Description」セクションで出力されるタスクサマリーは維持してください
-   - Michi Extensionの選択肢はその**後**に追加で表示します
-
-2. **言語設定の考慮**:
-   - メッセージは日本語固定（将来的にspec.jsonの言語設定に対応する可能性あり）
-
-3. **ユーザーインタラクション**:
-   - 選択肢を表示した後、ユーザーの入力を待ちます
-   - 選択に応じて適切なコマンド/処理を案内または実行してください
-
----
-
-**Michi 固有機能**: このコマンドは cc-sdd 標準の `/kiro:spec-tasks` を拡張し、Phase 0.6（JIRA同期）への誘導を Next Phase として案内します。これにより、タスク分割からJIRA連携へのスムーズな移行を実現します。

package/templates/cursor/rules/atlassian-mcp.mdc

@@ -1,188 +0,0 @@
----
-title: Atlassian MCP Integration Rules
-description: {{DEV_GUIDELINES}} for MCP integration with Confluence/JIRA
----
-
-# Atlassian MCP Integration Rules
-
-## Prerequisites
-
-Atlassian MCP server must be configured in Cursor:
-- Credentials set in `~/.cursor/mcp.json`
-
-Reference: [Atlassian MCP](https://www.atlassian.com/ja/platform/remote-mcp-server)
-
-## Available MCP Tools
-
-Cursor AI can use the following tools:
-
-### Confluence
-- `confluence_create_page`: Create page
-- `confluence_update_page`: Update page
-- `confluence_search`: Search pages
-- `confluence_get_page`: Get page
-
-### JIRA
-- `jira_create_issue`: Create issue
-- `jira_update_issue`: Update issue
-- `jira_search`: Search issues
-- `jira_get_issue`: Get issue
-
-## Workflow Integration
-
-⚠️ **Important**: **Always use REST API scripts** for page/issue creation and updates. Use MCP tools only for reference and search operations.
-
-### Requirements Phase
-
-After generating `.kiro/specs/<feature>/requirements.md`:
-
-```
-Run script (required):
-  npm run phase:run <feature> requirements
-
-Execution:
-1. Load project metadata (.kiro/project.json)
-2. Convert Markdown (markdown-to-confluence.ts)
-3. Create page via REST API (confluence-sync.ts)
-4. Auto-update spec.json
-5. Run validation
-```
-
-### Design Phase
-
-After generating `.kiro/specs/<feature>/design.md`:
-
-```
-Run script (required):
-  npm run phase:run <feature> design
-
-Execution:
-1. Create Confluence page via REST API (confluence-sync.ts)
-2. Auto-update spec.json
-3. Run validation
-```
-
-### Task Breakdown Phase
-
-After generating `.kiro/specs/<feature>/tasks.md`:
-
-```
-Run script (required):
-  npm run phase:run <feature> tasks
-
-Execution:
-1. Create Epic via REST API (jira-sync.ts)
-2. Create Stories via REST API (all stories, jira-sync.ts)
-3. Set story points
-4. Auto-update spec.json
-5. Run validation
-```
-
-### Implementation Phase
-
-Update JIRA when starting and completing implementation (MCP for single reference operations, scripts recommended for multiple updates):
-
-```
-Option 1: MCP tool (for single update)
-  jira_update_issue({
-    issue_key: "{{JIRA_PROJECT_KEY}}-123",
-    status: "In Progress"
-  })
-
-Option 2: REST API script (for bulk updates)
-  npm run jira:sync <feature>
-```
-
-## MCP Usage Guidelines
-
-### When to Use MCP
-
-✅ **Recommended (reference/search only)**:
-- Search/get Confluence pages (reference purpose)
-- Search/get JIRA issues (reference purpose)
-- Single operation information retrieval
-- Interactive information checking within Cursor AI
-
-❌ **Prohibited (creation/update)**:
-- Confluence page creation/update → **Scripts required**
-- JIRA issue creation/update → **Scripts required**
-- Bulk operations (10+ pages/issues) → **Scripts required**
-- Complex workflows → **Scripts required**
-
-### MCP vs REST API Scripts
-
-| Use Case | Method | Reason |
-|----------|--------|--------|
-| Page/Issue creation | **REST API Script** | Rate limit handling, error handling, bulk processing |
-| Page/Issue update | **REST API Script** | Rate limit handling, error handling |
-| Page/Issue search (reference) | MCP | Simple, AI integration |
-| Page/Issue get (reference) | MCP | Simple, AI integration |
-
-## Rate Limiting
-
-Atlassian rate limits vary by product (Confluence/JIRA), tenant, app context, and plan, controlled via quota/burst mode or per-minute windows.
-
-**Confluence Cloud**:
-- Migration: 6,000-12,000 requests/minute
-- General use: Quota + burst mode (~10s burst window, 1h quota window)
-
-**JIRA Cloud**:
-- Cost/quota-based limits (per app, per user, app+user)
-- Issue write limits: 20 ops/2s, 100 ops/30s
-
-Rate limit violations return `429` response with `Retry-After` and `X-RateLimit-*` headers for retry guidance.
-
-**Recommended Mitigation**:
-- Detect and honor response headers (`Retry-After`, `X-RateLimit-*`)
-- Implement exponential backoff + jitter retry
-- Use caching and batch processing
-- For frequent operations, use REST API (fine-grained control)
-
-**Official Documentation**:
-- [Confluence API Rate Limiting](https://developer.atlassian.com/cloud/confluence/rate-limiting/)
-- [JIRA API Rate Limiting](https://developer.atlassian.com/cloud/jira/platform/rate-limiting/)
-- [App Migration Rate Limiting](https://developer.atlassian.com/platform/app-migration/rate-limiting/)
-
-## Using Project Metadata
-
-### When Calling MCP Tools
-
-```typescript
-// Load project metadata
-const projectMeta = JSON.parse(
-  fs.readFileSync('.kiro/project.json', 'utf-8')
-);
-
-// Use with MCP tools
-confluence_create_page({
-  space: "PRD",
-  title: `[${projectMeta.projectName}] ...`,
-  labels: [...projectMeta.confluenceLabels, ...additionalLabels]
-});
-```
-
-## Troubleshooting
-
-### MCP Connection Error
-
-1. Restart Cursor
-2. Verify credentials in `~/.cursor/mcp.json`
-3. Check Atlassian API Token validity
-
-### Rate Limit Error
-
-Use rate-limit-ready scripts:
-```bash
-# Rate limit handling (500ms wait) implemented
-npm run confluence:sync <feature>
-npm run jira:sync <feature>
-
-# Adjust wait time (default: 500ms, in milliseconds)
-ATLASSIAN_REQUEST_DELAY=1000 npm run jira:sync <feature>
-```
-
-### Page Creation Error
-
-- Verify Confluence space exists
-- Check for duplicate page titles
-- Verify permissions

package/templates/cursor/rules/github-ssot.mdc

@@ -1,151 +0,0 @@
----
-title: GitHub Single Source of Truth Rules
-description: {{DEV_GUIDELINES}} for using GitHub as SSoT and syncing with Confluence
----
-
-# GitHub Single Source of Truth (SSoT) Rules
-
-## Basic Principles
-
-### Single Source of Truth
-- **All specifications managed in GitHub** (.kiro/specs/)
-- Confluence is **for reference and approval only** (edit only in GitHub)
-- Avoid dual management
-
-### Data Flow
-```
-GitHub (.kiro/specs/)  ← Source of Truth (editable)
-    ↓ sync
-Confluence ← View & Approval only (read-only)
-```
-
-## File Structure
-
-### GitHub Repository
-```
-.kiro/
-├── project.json          # Project metadata
-├── specs/
-│   └── <feature>/
-│       ├── requirements.md  # Requirements definition
-│       ├── design.md        # Design
-│       ├── tasks.md         # Task breakdown
-│       └── test-report.md   # Test results
-└── settings/
-    └── templates/       # Templates
-```
-
-## Workflow
-
-### 1. Generate Markdown → GitHub
-```
-Cursor: /michi:spec-requirements <feature>
-  ↓ Generate: .kiro/specs/<feature>/requirements.md
-  ↓
-jj commit -m "docs: Add requirements"
-jj git push
-```
-
-### 2. GitHub → Confluence Sync
-```
-Cursor AI (using MCP):
-  1. Get GitHub URL
-  2. Convert Markdown → Confluence Storage Format
-  3. Create page with confluence_create_page()
-  4. Embed GitHub link
-```
-
-### 3. Approval in Confluence
-- Planners/Managers review in Confluence
-- Approve via Page Properties
-- After approval → Proceed to next phase
-
-### 4. Technical Review in GitHub
-- Engineers review Markdown in GitHub
-- Comment/suggest changes in PR format (optional)
-- After merge, auto-update Confluence
-
-## Confluence Page Structure
-
-### Template Structure
-```markdown
-## GitHub Integration
-📄 Latest version managed in [GitHub](URL)
-Edit in GitHub, auto-synced to Confluence
-
----
-
-{Converted Markdown}
-
----
-
-## Approval
-{approval macro}
-Approvers: @Planner, @Manager
-{/approval}
-```
-
-## Review Flow Separation
-
-### Engineer Review (GitHub)
-- Target: requirements.md, design.md, tasks.md
-- Method: GitHub PR, comments
-- Focus: Technical accuracy, feasibility
-
-### Planner/Manager Review (Confluence)
-- Target: Requirements, design, estimates
-- Method: Confluence comments, approval macro
-- Focus: Business requirements, priority, budget
-
-## Update Synchronization
-
-### On GitHub Update
-```
-GitHub push
-  ↓ Webhook (optional)
-Confluence auto-update
-```
-
-### Manual Sync
-```bash
-# Run command
-/michi:confluence-sync <feature>
-
-# Or npm script
-npm run confluence:sync <feature>
-```
-
-## Benefits
-
-✅ **Version Control**: All change history in GitHub
-✅ **Zero Dual Management**: Confluence for reference only
-✅ **Engineer-Friendly**: Markdown, Git, PR
-✅ **Planner/Manager-Friendly**: Confluence's user-friendly UI
-✅ **Auto Sync**: Push = Confluence update
-✅ **Audit Trail**: GitHub as official record
-
-## Prohibited Actions
-
-❌ Direct editing in Confluence
-❌ Managing in both GitHub and Confluence
-❌ Reverse sync from Confluence to GitHub
-
-## Exception Cases
-
-Direct creation in Confluence allowed only for:
-- Meeting minutes
-- Temporary notes
-- Documents outside the project
-
-## Troubleshooting
-
-### If Confluence is outdated
-```bash
-# Manually re-sync
-/michi:confluence-sync <feature>
-```
-
-### On sync error
-1. Verify GitHub Markdown is correct
-2. Check Confluence API authentication
-3. Verify page ID is correct

package/templates/cursor/rules/multi-project.mdc

@@ -1,81 +0,0 @@
----
-title: Multi-Project Management Rules
-description: {{DEV_GUIDELINES}} for managing multiple concurrent projects with naming conventions and workflows
----
-
-# Multi-Project Management Rules
-
-## Project Identification
-
-### Loading Project Metadata
-- Reference `.kiro/project.json` in all operations
-- Retrieve project ID, JIRA key, and Confluence labels
-- Use project information dynamically
-
-### Example
-```typescript
-const projectMeta = JSON.parse(fs.readFileSync('.kiro/project.json', 'utf8'));
-// projectMeta.projectId
-// projectMeta.jiraProjectKey
-// projectMeta.confluenceLabels
-```
-
-## Naming Conventions
-
-### Confluence Pages
-- Format: `[{projectName}] {document_type}`
-- Example: `[Company-A-Service1] Requirements`
-- Example: `[{{PROJECT_ID}}] User Auth Design`
-
-### JIRA Epic/Story
-- Epic: `[{projectName}] {feature_name}`
-- Story: `[{projectName}] {task_name}`
-- Example: `[{{PROJECT_ID}}] User Authentication Feature`
-
-### GitHub Branches
-- Format: `{projectId}/feature/{feature_name}`
-- Example: `{{PROJECT_ID}}/feature/user-auth`
-- Example: `customer-a-service-1/feature/payment`
-
-### Label Assignment
-- Confluence: `projectMeta.confluenceLabels` + `requirements|design|tasks`
-- JIRA: `projectMeta.confluenceLabels` + feature name
-
-## Cross-Project Views
-
-### Confluence Dashboard
-- Display requirements, design, tasks across all projects
-- Filter by labels
-- Filter by status (Pending Review, Approved)
-
-### JIRA Dashboard
-- Track progress by project key
-- Filter: `project IN ({{JIRA_PROJECT_KEY}}, PRJA, PRJB)`
-- Aggregate story points
-
-## Unified Workflow
-
-Use the same workflow across all projects:
-
-1. `/michi:spec-init` → Specification initialization
-2. `/michi:spec-requirements` → Requirements definition (Confluence sync)
-3. `/michi:spec-design` → Design (Confluence sync + estimation)
-4. `/michi:spec-tasks` → Task breakdown (JIRA integration)
-5. `/michi:spec-impl` → TDD implementation
-6. GitHub PR → Review
-7. Release preparation
-
-## Project Switching
-
-When switching between multiple projects:
-
-1. Check out repository
-2. Verify `.kiro/project.json`
-3. Open corresponding Confluence/JIRA pages
-
-## Important Notes
-
-- Maintain independent `.kiro/project.json` for each project
-- Ensure JIRA project keys are unique
-- Identify projects by Confluence labels
-- Include project ID in GitHub branch names

package/templates/gemini/commands/README.md

@@ -1,41 +0,0 @@
-# Gemini CLI Extensions for Michi
-
-This directory contains additional context and extensions for Gemini CLI when working with Michi projects.
-
-## Directory Structure
-
-```
-.gemini/
-├── GEMINI.md           # Main project context (auto-loaded)
-└── extensions/         # Additional extensions (optional)
-    └── README.md       # This file
-```
-
-## Usage
-
-Gemini CLI automatically loads `GEMINI.md` from the project root. Extensions in this directory can be loaded using `/directory add` command:
-
-```
-/directory add .gemini/extensions
-```
-
-## Available Extensions
-
-Currently, Michi provides core principles in the main `GEMINI.md` file. Additional extensions can be added here for:
-
-- **atlassian-integration** - Confluence/JIRA integration patterns
-- **multi-project** - Multi-project management strategies
-- **custom-workflows** - Project-specific workflows
-
-## Creating Custom Extensions
-
-To create a custom extension:
-
-1. Create a new `.md` file in this directory
-2. Add your context/rules in Markdown format
-3. Load it in Gemini CLI: `/directory add .gemini/extensions/<your-file>.md`
-
-## Learn More
-
-- Gemini CLI Documentation: https://geminicli.com/docs
-- Michi Documentation: https://github.com/sk8metalme/michi