@sk8metal/michi-cli 0.0.1

package/docs/testing.md

@@ -0,0 +1,202 @@
+# テスト・検証ガイド
+
+> **凡例について**: `<feature>` などの記号の意味は [README.md#凡例の記号説明](../README.md#凡例の記号説明) を参照してください。
+
+## E2Eテストシナリオ
+
+### シナリオ1: 単一機能の完全フロー
+
+新機能「ユーザー認証」を要件定義からリリースまで実行：
+
+#### Step 1: 要件定義
+```bash
+# 凡例
+/kiro:spec-init <機能説明>
+/kiro:spec-requirements <feature>
+jj commit -m "docs: <feature> 要件定義"
+jj git push
+npm run confluence:sync <feature> requirements
+
+# 具体例
+/kiro:spec-init OAuth 2.0を使ったユーザー認証機能
+/kiro:spec-requirements user-auth
+jj commit -m "docs: ユーザー認証 要件定義"
+jj git push
+npm run confluence:sync user-auth requirements
+```
+
+**確認ポイント**:
+- [ ] `.kiro/specs/user-auth/requirements.md` が生成された
+- [ ] Confluenceページが作成された
+- [ ] ラベル `project:michi, requirements, user-auth` が付与された
+- [ ] 企画・部長にメンション通知が届いた
+
+#### Step 2: 設計
+```bash
+# 凡例
+/kiro:spec-design <feature>
+jj commit -m "docs: <feature> 設計"
+jj git push
+npm run confluence:sync <feature> design
+npm run excel:sync <feature>
+
+# 具体例
+/kiro:spec-design user-auth
+jj commit -m "docs: ユーザー認証 設計"
+jj git push
+npm run confluence:sync user-auth design
+npm run excel:sync user-auth
+```
+
+**確認ポイント**:
+- [ ] `.kiro/specs/user-auth/design.md` が生成された
+- [ ] 見積もりセクションが含まれている
+- [ ] Confluenceページが作成された（親: 要件定義）
+- [ ] Excelファイルが出力された
+
+#### Step 3: タスク分割
+```bash
+# 凡例
+/kiro:spec-tasks <feature>
+jj commit -m "docs: <feature> タスク分割"
+jj git push
+npm run jira:sync <feature>
+
+# 具体例
+/kiro:spec-tasks user-auth
+jj commit -m "docs: ユーザー認証 タスク分割"
+jj git push
+npm run jira:sync user-auth
+```
+
+**確認ポイント**:
+- [ ] `.kiro/specs/user-auth/tasks.md` が生成された
+- [ ] JIRA Epicが作成された
+- [ ] JIRA Storyが作成された（複数）
+- [ ] Epic-Storyリンクが設定された
+
+#### Step 4: 実装
+```
+/kiro:spec-impl user-auth FE-1,BE-1
+jj commit -m "feat: ユーザー認証実装 [MICHI-123]"
+jj bookmark create michi/feature/user-auth -r '@-'
+jj git push --bookmark michi/feature/user-auth --allow-new
+npm run github:create-pr michi/feature/user-auth
+```
+
+**確認ポイント**:
+- [ ] テストが先に書かれた（TDD）
+- [ ] コードが実装された
+- [ ] PRが作成された
+- [ ] JIRA ステータスが "In Review" に更新された
+
+### シナリオ2: マルチプロジェクト横断テスト
+
+3つのプロジェクトで同時に要件定義を実施：
+
+```bash
+# プロジェクトA
+cd customer-a-service-1
+/kiro:spec-requirements payment-feature
+npm run confluence:sync payment-feature
+
+# プロジェクトB
+cd ../customer-b-api
+/kiro:spec-requirements user-api
+npm run confluence:sync user-api
+
+# プロジェクトC（Michi）
+cd ../michi
+/kiro:spec-requirements integration-hub
+npm run confluence:sync integration-hub
+
+# 横断確認
+npm run project:list
+npm run project:dashboard
+```
+
+**確認ポイント**:
+- [ ] 3つのプロジェクトすべてでページ作成成功
+- [ ] Confluenceダッシュボードに3プロジェクト表示
+- [ ] ラベルでフィルタリング可能
+- [ ] JIRAダッシュボードに3プロジェクト表示
+
+## チームフィードバック収集
+
+### フィードバック項目
+
+#### 使いやすさ
+- [ ] Cursorコマンドは直感的か？
+- [ ] ドキュメントは理解しやすいか？
+- [ ] エラーメッセージは明確か？
+
+#### 効率性
+- [ ] 要件定義の時間短縮できたか？
+- [ ] Confluence/JIRA連携は手間を減らしたか？
+- [ ] 全体の開発スピードは向上したか？
+
+#### 品質
+- [ ] AIが生成する仕様書の品質は十分か？
+- [ ] テンプレートは実務に適しているか？
+- [ ] 見積もりの精度は妥当か？
+
+### フィードバック方法
+
+GitHub Issuesで収集：
+```bash
+gh issue create --title "フィードバック: <内容>" --body "<詳細>"
+```
+
+ラベル:
+- `feedback:usability`: 使いやすさ
+- `feedback:efficiency`: 効率性
+- `feedback:quality`: 品質
+
+## 継続的改善
+
+### Week 1-2: パイロット運用
+- 1プロジェクトで全フロー実行
+- 問題点を記録
+- フィードバック収集
+
+### Week 3-4: 改善
+- テンプレート調整
+- スクリプト改善
+- ドキュメント更新
+
+### Week 5-6: 横展開
+- 2-3プロジェクトに展開
+- チーム全体でフィードバック
+
+### Week 7-8: 最適化
+- ベストプラクティス確立
+- 自動化範囲の拡大
+- ツールの安定化
+
+## メトリクス
+
+### 効率化指標
+
+| 指標 | 導入前 | 導入後 | 改善率 |
+|------|--------|--------|--------|
+| 要件定義時間 | 3日 | 0.5日 | 83% |
+| 設計時間 | 5日 | 1日 | 80% |
+| タスク分割時間 | 2日 | 0.5日 | 75% |
+| ドキュメント作成 | 2日 | 0.2日 | 90% |
+
+### 品質指標
+
+| 指標 | 目標値 | 測定方法 |
+|------|--------|---------|
+| 仕様書の完成度 | 90%以上 | レビュースコア |
+| 見積もり精度 | ±20%以内 | 実績との比較 |
+| テストカバレッジ | 95%以上 | 自動測定 |
+
+## 次のステップ
+
+1. パイロットプロジェクトでE2Eテスト実行
+2. フィードバック収集
+3. 改善実施
+4. 他プロジェクトに横展開
+5. ベストプラクティス確立
+

package/docs/workflow.md

@@ -0,0 +1,342 @@
+# AI開発ワークフローガイド
+
+> **凡例について**: `<feature>` などの記号の意味は [README.md#凡例の記号説明](../README.md#凡例の記号説明) を参照してください。
+
+## 概要
+
+このガイドでは、Michiを使用したAI駆動開発フローの全体像を説明します。
+
+## ワークフロー全体像
+
+```
+1. 要件定義 (/kiro:spec-requirements)
+   ↓ GitHub → Confluence同期
+   ↓ 企画・部長が承認
+   
+2. 設計 (/kiro:spec-design)
+   ↓ GitHub → Confluence同期
+   ↓ 見積もり生成 → Excel出力
+   ↓ アーキテクト・部長が承認
+   
+3. タスク分割 (/kiro:spec-tasks)
+   ↓ GitHub → JIRA連携
+   ↓ Epic/Story/Subtask自動作成
+   
+4. 実装 (/kiro:spec-impl)
+   ↓ TDD（テスト → コード → リファクタリング）
+   ↓ GitHub PR作成
+   ↓ JIRA ステータス更新
+   
+5. テスト
+   ↓ テストレポート生成
+   ↓ Confluence同期
+   
+6. リリース準備 (/kiro:release-prep)
+   ↓ リリースノート生成
+   ↓ JIRA Release作成
+   ↓ GitHub Release作成
+```
+
+## フェーズ別詳細
+
+### Phase 1: 要件定義
+
+#### Step 1: 仕様の初期化
+
+Cursorで実行：
+```bash
+# 凡例
+/kiro:spec-init <機能説明>
+
+# 具体例
+/kiro:spec-init ユーザー認証機能を実装したい。OAuth 2.0とJWTを使用。
+```
+
+AIが `.kiro/specs/<feature>/` ディレクトリを作成します。
+
+#### Step 2: 要件定義の生成
+
+```bash
+# 凡例
+/kiro:spec-requirements <feature>
+
+# 具体例
+/kiro:spec-requirements user-auth
+```
+
+AIが以下を生成：
+- `.kiro/specs/<feature>/requirements.md`
+- ビジネス要件、機能要件、非機能要件、リスク
+
+#### Step 3: GitHubにコミット
+
+```bash
+# 凡例
+jj commit -m "docs: <feature> 要件定義追加"
+jj git push
+
+# 具体例
+jj commit -m "docs: ユーザー認証 要件定義追加"
+jj git push
+```
+
+#### Step 4: Confluenceに同期
+
+Cursorで実行：
+```bash
+# 凡例
+/kiro:confluence-sync <feature> requirements
+
+# 具体例
+/kiro:confluence-sync user-auth requirements
+```
+
+または：
+```bash
+# 凡例
+npm run confluence:sync <feature> requirements
+
+# 具体例
+npm run confluence:sync user-auth requirements
+```
+
+AIが自動的に：
+- Confluenceページ作成
+- プロジェクト情報付与
+- 企画・部長にメンション通知
+
+#### Step 5: 承認待ち
+
+企画・部長がConfluenceで：
+- 要件をレビュー
+- コメントでフィードバック
+- Page Propertiesで承認
+
+### Phase 2: 設計
+
+#### Step 1: 設計書の生成
+
+```bash
+# 凡例
+/kiro:spec-design <feature>
+
+# 具体例
+/kiro:spec-design user-auth
+```
+
+AIが以下を生成：
+- アーキテクチャ図
+- API設計
+- データベース設計
+- 見積もり
+
+#### Step 2: GitHubにコミット
+
+```bash
+# 凡例
+jj commit -m "docs: <feature> 設計追加"
+jj git push
+
+# 具体例
+jj commit -m "docs: ユーザー認証 設計追加"
+jj git push
+```
+
+#### Step 3: Confluenceに同期 + 見積もり出力
+
+```bash
+# 凡例
+npm run confluence:sync <feature> design
+npm run excel:sync <feature>
+
+# 具体例
+npm run confluence:sync user-auth design
+npm run excel:sync user-auth
+```
+
+見積もりExcelファイルが `estimates/<feature>-estimate.xlsx` に出力されます。
+
+#### Step 4: 承認待ち
+
+アーキテクト・部長がレビュー・承認
+
+### Phase 3: タスク分割
+
+#### Step 1: タスク生成
+
+```bash
+# 凡例
+/kiro:spec-tasks <feature>
+
+# 具体例
+/kiro:spec-tasks user-auth
+```
+
+AIが実装タスクをストーリーに分割します。
+
+#### Step 2: GitHubにコミット
+
+```bash
+# 凡例
+jj commit -m "docs: <feature> タスク分割追加"
+jj git push
+
+# 具体例
+jj commit -m "docs: ユーザー認証 タスク分割追加"
+jj git push
+```
+
+#### Step 3: JIRAに同期
+
+```bash
+# 凡例
+npm run jira:sync <feature>
+
+# 具体例
+npm run jira:sync user-auth
+```
+
+自動的に：
+- Epic作成: `[<project-name>] <feature>`
+- Story作成: 各実装タスク
+- Subtask作成: テスト、レビュータスク
+
+### Phase 4: 実装
+
+#### Step 1: TDD実装
+
+```bash
+# 凡例
+/kiro:spec-impl <feature> <tasks>
+
+# 具体例
+/kiro:spec-impl user-auth FE-1,BE-1
+```
+
+AIがTDD（テスト駆動開発）で実装：
+1. テストを書く
+2. コードを書く
+3. リファクタリング
+
+#### Step 2: コミット
+
+```bash
+# 凡例
+jj commit -m "feat: <feature> 実装 [JIRA-XXX]"
+jj bookmark create <project-id>/feature/<feature> -r '@-'
+jj git push --bookmark <project-id>/feature/<feature> --allow-new
+
+# 具体例
+jj commit -m "feat: ユーザー認証実装 [MICHI-123]"
+jj bookmark create michi/feature/user-auth -r '@-'
+jj git push --bookmark michi/feature/user-auth --allow-new
+```
+
+#### Step 3: PR作成
+
+```bash
+# 凡例
+npm run github:create-pr <project-id>/feature/<feature> "[JIRA-XXX] <タイトル>"
+
+# 具体例
+npm run github:create-pr michi/feature/user-auth "[MICHI-123] ユーザー認証実装"
+```
+
+または手動で：
+```bash
+# 凡例
+gh pr create --head <project-id>/feature/<feature> --base main \
+  --title "[JIRA-XXX] <タイトル>" \
+  --body "<説明>"
+
+# 具体例
+gh pr create --head michi/feature/user-auth --base main \
+  --title "[MICHI-123] ユーザー認証実装" \
+  --body "実装内容..."
+```
+
+### Phase 5-6: テスト・リリース
+
+テストレポート生成とリリース準備は、同様のフローで実行します。
+
+## 統合ワークフロー実行
+
+すべてのフェーズを自動実行：
+
+```bash
+# 凡例
+npm run workflow:run -- --feature <feature>
+
+# 具体例
+npm run workflow:run -- --feature user-auth
+```
+
+承認ゲートで一時停止し、承認後に次のフェーズに進みます。
+
+### 承認ゲートの設定
+
+ワークフロー実行時の承認ゲートで使用するロール名は、環境変数で設定できます。
+
+#### 環境変数設定
+
+`.env` ファイルに以下を追加：
+
+```bash
+# 要件定義フェーズの承認者
+APPROVAL_GATES_REQUIREMENTS=pm,director
+
+# 設計フェーズの承認者
+APPROVAL_GATES_DESIGN=architect,director
+
+# リリースフェーズの承認者
+APPROVAL_GATES_RELEASE=sm,director
+```
+
+#### 設定例
+
+**デフォルト（英語ロール名）:**
+```bash
+APPROVAL_GATES_REQUIREMENTS=pm,director
+APPROVAL_GATES_DESIGN=architect,director
+APPROVAL_GATES_RELEASE=sm,director
+```
+
+**日本語ロール名:**
+```bash
+APPROVAL_GATES_REQUIREMENTS=企画,部長
+APPROVAL_GATES_DESIGN=アーキテクト,部長
+APPROVAL_GATES_RELEASE=SM,部長
+```
+
+**カスタムロール名:**
+```bash
+APPROVAL_GATES_REQUIREMENTS=product-manager,cto,legal
+APPROVAL_GATES_DESIGN=tech-lead,architect,security
+APPROVAL_GATES_RELEASE=release-manager,qa-lead,director
+```
+
+詳細は [セットアップガイド](./setup.md#4-3-ワークフロー承認ゲートの設定オプション) を参照してください。
+
+## ベストプラクティス
+
+1. **小さく始める**: 最初は1フェーズずつ手動実行
+2. **承認を待つ**: 各フェーズで承認を取ってから次へ
+3. **GitHubを真実の源に**: 編集は常にGitHubで
+4. **定期的な同期**: GitHub更新後は必ずConfluence/JIRA同期
+5. **プロジェクトメタデータの維持**: `.kiro/project.json` を最新に保つ
+
+## トラブルシューティング
+
+### Confluence同期エラー
+- `.env` の認証情報を確認
+- Confluenceスペースが存在するか確認
+- Markdownファイルが存在するか確認
+
+### JIRA同期エラー
+- JIRAプロジェクトキーが正しいか確認
+- Epic/Storyの作成権限があるか確認
+
+### PR作成エラー
+- GitHub認証を確認: `gh auth status`
+- ブランチが存在するか確認: `jj bookmark list`
+

package/env.example

@@ -0,0 +1,44 @@
+# Atlassian設定
+ATLASSIAN_URL=https://your-domain.atlassian.net
+ATLASSIAN_EMAIL=your-email@company.com
+ATLASSIAN_API_TOKEN=your-atlassian-api-token-here
+
+# GitHub設定
+GITHUB_ORG=your-github-org
+GITHUB_TOKEN=your-github-token-here
+GITHUB_REPO=your-org/your-repo
+
+# Confluence設定
+CONFLUENCE_PRD_SPACE=PRD
+CONFLUENCE_QA_SPACE=QA
+CONFLUENCE_RELEASE_SPACE=RELEASE
+
+# JIRA設定
+JIRA_PROJECT_KEYS=PROJECT
+
+# JIRA Issue Type IDs（JIRAインスタンス固有の値 - 必須）
+# JIRA管理画面（Settings > Issues > Issue types）またはREST APIで確認してください
+# REST API: GET /rest/api/3/issuetype で取得可能
+JIRA_ISSUE_TYPE_STORY=10036
+JIRA_ISSUE_TYPE_SUBTASK=10037
+
+# レートリミット対策（オプション、デフォルト: 500ms）
+ATLASSIAN_REQUEST_DELAY=500
+
+# Story Pointsカスタムフィールド（JIRAプロジェクト固有）
+# 環境変数 JIRA_STORY_POINTS_FIELD で設定可能（例: customfield_10016）
+JIRA_STORY_POINTS_FIELD=customfield_10016
+
+# Epic Linkカスタムフィールド（JIRAプロジェクト固有）
+# 環境変数 JIRA_EPIC_LINK_FIELD で設定可能（例: customfield_10014）
+JIRA_EPIC_LINK_FIELD=customfield_10014
+
+# Slack通知（オプション）
+SLACK_WEBHOOK_URL=your-slack-webhook-url-here
+
+# ワークフロー承認ゲート（オプション）
+# カンマ区切りでロール名を指定。未設定の場合はデフォルト値を使用
+# デフォルト: requirements=pm,director, design=architect,director, release=sm,director
+APPROVAL_GATES_REQUIREMENTS=pm,director
+APPROVAL_GATES_DESIGN=architect,director
+APPROVAL_GATES_RELEASE=sm,director

package/mcp.json.example

@@ -0,0 +1,14 @@
+{
+  "mcpServers": {
+    "atlassian": {
+      "command": "npx",
+      "args": ["-y", "@atlassian/mcp-server-atlassian"],
+      "env": {
+        "ATLASSIAN_URL": "https://your-domain.atlassian.net",
+        "ATLASSIAN_EMAIL": "your-email@company.com",
+        "ATLASSIAN_API_TOKEN": "your-atlassian-api-token-here"
+      }
+    }
+  }
+}
+

package/package.json

@@ -0,0 +1,97 @@
+{
+  "name": "@sk8metal/michi-cli",
+  "version": "0.0.1",
+  "description": "Managed Intelligent Comprehensive Hub for Integration - AI-driven development workflow automation",
+  "license": "MIT",
+  "type": "module",
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/sk8metalme/michi.git"
+  },
+  "homepage": "https://github.com/sk8metalme/michi#readme",
+  "bugs": {
+    "url": "https://github.com/sk8metalme/michi/issues"
+  },
+  "keywords": [
+    "ai",
+    "development",
+    "workflow",
+    "automation",
+    "confluence",
+    "jira",
+    "atlassian",
+    "spec-driven-development",
+    "cc-sdd",
+    "cursor",
+    "github"
+  ],
+  "bin": {
+    "michi": "dist/src/cli.js"
+  },
+  "files": [
+    "dist",
+    "docs",
+    "README.md",
+    "LICENSE",
+    "env.example",
+    "mcp.json.example"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "prepare": "npm run build",
+    "setup:env": "bash scripts/setup-env.sh",
+    "create-project": "tsx scripts/create-project.ts",
+    "setup-existing": "tsx scripts/setup-existing-project.ts",
+    "confluence:sync": "tsx scripts/confluence-sync.ts",
+    "jira:sync": "tsx scripts/jira-sync.ts",
+    "github:create-pr": "tsx scripts/pr-automation.ts",
+    "project:list": "tsx scripts/list-projects.ts",
+    "project:dashboard": "tsx scripts/resource-dashboard.ts",
+    "multi-estimate": "tsx scripts/multi-project-estimate.ts",
+    "markdown:convert": "tsx scripts/markdown-to-confluence.ts",
+    "michi": "tsx src/cli.ts",
+    "workflow:run": "tsx scripts/workflow-orchestrator.ts",
+    "validate:phase": "tsx scripts/validate-phase.ts",
+    "phase:run": "tsx scripts/phase-runner.ts",
+    "preflight": "tsx scripts/pre-flight-check.ts",
+    "config:interactive": "tsx scripts/config-interactive.ts",
+    "config:validate": "tsx scripts/utils/config-validator.ts",
+    "test": "vitest",
+    "test:run": "vitest --run",
+    "test:ui": "vitest --ui",
+    "lint": "eslint .",
+    "lint:fix": "eslint . --fix",
+    "type-check": "tsc --noEmit"
+  },
+  "dependencies": {
+    "@octokit/rest": "^20.0.2",
+    "axios": "^1.13.1",
+    "commander": "^14.0.2",
+    "dotenv": "^16.3.1",
+    "exceljs": "^4.4.0",
+    "googleapis": "^126.0.1",
+    "jira-client": "^8.2.2",
+    "markdown-it": "^14.0.0",
+    "turndown": "^7.1.2",
+    "zod": "^3.22.4"
+  },
+  "devDependencies": {
+    "@types/markdown-it": "^13.0.7",
+    "@types/node": "^20.10.6",
+    "@types/turndown": "^5.0.4",
+    "@typescript-eslint/eslint-plugin": "^6.17.0",
+    "@typescript-eslint/parser": "^6.17.0",
+    "eslint": "^8.56.0",
+    "prettier": "^3.1.1",
+    "tsx": "^4.7.0",
+    "typescript": "^5.3.3",
+    "vitest": "^1.1.1"
+  },
+  "engines": {
+    "node": ">=20.0.0",
+    "npm": ">=10.0.0"
+  }
+}