@sk8metal/michi-cli 0.0.8 → 0.1.0

package/templates/codex/AGENTS.override.md

@@ -0,0 +1,277 @@
+# 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
+   /kiro: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の基本ルールに**追加**される形で適用されます。

package/templates/codex/prompts/confluence-sync.md

@@ -0,0 +1,177 @@
+---
+description: Confluenceへのドキュメント同期 - Michi仕様書をConfluenceに連携
+argument-hint: [FEATURE=<機能名>]
+---
+# Michi Confluence Sync
+
+機能「$1」の仕様ドキュメントをConfluenceに同期します。
+
+## 前提条件
+
+### 環境変数の設定
+以下の環境変数が必要です：
+```bash
+ATLASSIAN_URL=https://your-domain.atlassian.net
+ATLASSIAN_EMAIL=your-email@example.com
+ATLASSIAN_API_TOKEN=your-api-token
+```
+
+### プロジェクトメタデータ
+`.kiro/project.json`に以下が設定されていること：
+- `confluenceSpaceKey`: Confluenceスペースキー
+- `confluenceLabels`: 自動付与するラベル
+
+## 同期対象ファイル
+
+以下のファイルをConfluenceページに変換して同期します：
+
+1. **要件定義書**
+   - ソース: `.kiro/specs/$1/requirements.md`
+   - タイトル: `[$1] 要件定義`
+
+2. **設計ドキュメント**
+   - ソース: `.kiro/specs/$1/design.md`
+   - タイトル: `[$1] 設計書`
+
+3. **タスク一覧**（オプション）
+   - ソース: `.kiro/specs/$1/tasks.md`
+   - タイトル: `[$1] タスク管理`
+
+## 実行手順
+
+### 1. 環境変数の確認
+```typescript
+// 必要な環境変数をチェック
+const requiredEnvVars = [
+  'ATLASSIAN_URL',
+  'ATLASSIAN_EMAIL',
+  'ATLASSIAN_API_TOKEN'
+];
+
+for (const envVar of requiredEnvVars) {
+  if (!process.env[envVar]) {
+    console.error(`❌ ${envVar} が設定されていません`);
+    process.exit(1);
+  }
+}
+```
+
+### 2. プロジェクトメタデータの読み込み
+```typescript
+import { readFileSync } from 'fs';
+
+const projectMeta = JSON.parse(
+  readFileSync('.kiro/project.json', 'utf-8')
+);
+
+const spaceKey = projectMeta.confluenceSpaceKey;
+const labels = projectMeta.confluenceLabels || [];
+```
+
+### 3. Confluence APIクライアントの初期化
+```typescript
+import { ConfluenceClient } from '../path/to/confluence-client';
+
+const confluence = new ConfluenceClient({
+  url: process.env.ATLASSIAN_URL!,
+  email: process.env.ATLASSIAN_EMAIL!,
+  apiToken: process.env.ATLASSIAN_API_TOKEN!
+});
+```
+
+### 4. Markdownファイルの読み込みと変換
+```typescript
+const requirements = readFileSync(
+  `.kiro/specs/$1/requirements.md`,
+  'utf-8'
+);
+
+// Markdown → Confluence Storage Format変換
+const confluenceHtml = convertMarkdownToConfluence(requirements);
+```
+
+### 5. ページの作成または更新
+```typescript
+// 既存ページの検索
+const existingPage = await confluence.findPageByTitle(
+  spaceKey,
+  `[$1] 要件定義`
+);
+
+if (existingPage) {
+  // 更新
+  await confluence.updatePage(existingPage.id, {
+    title: `[$1] 要件定義`,
+    body: confluenceHtml,
+    version: existingPage.version + 1
+  });
+  console.log('✅ ページを更新しました');
+} else {
+  // 新規作成
+  const newPage = await confluence.createPage({
+    spaceKey,
+    title: `[$1] 要件定義`,
+    body: confluenceHtml,
+    labels
+  });
+  console.log('✅ ページを作成しました:', newPage.url);
+}
+```
+
+### 6. 同期結果の報告
+```typescript
+console.log('\n📊 Confluence同期結果:');
+console.log(`  機能: $1`);
+console.log(`  スペース: ${spaceKey}`);
+console.log(`  同期ファイル数: 2`);
+console.log(`  ラベル: ${labels.join(', ')}`);
+```
+
+## エラーハンドリング
+
+### 認証エラー
+```
+❌ Confluence API認証失敗
+- ATLASSIAN_URLが正しいか確認
+- API Tokenが有効か確認
+- メールアドレスが正しいか確認
+```
+
+### スペースが見つからない
+```
+❌ Confluenceスペースが見つかりません
+- .kiro/project.jsonのconfluenceSpaceKeyを確認
+- スペースへのアクセス権限を確認
+```
+
+### ページ作成失敗
+```
+❌ ページ作成に失敗しました
+- スペースへの書き込み権限を確認
+- タイトルの重複がないか確認
+```
+
+## Markdown変換の注意点
+
+Confluenceは独自のStorage Format（XHTML）を使用するため、以下に注意：
+
+- **コードブロック**: \`\`\`言語 → `<ac:structured-macro ac:name="code">`
+- **表**: GitHub Markdown → Confluence Table
+- **画像**: 相対パス → Confluence添付ファイル
+- **リンク**: 他の.mdファイル → Confluenceページリンク
+
+## 参考リソース
+
+- [Confluence REST API ドキュメント](https://developer.atlassian.com/cloud/confluence/rest/v2/intro/)
+- [Storage Format仕様](https://confluence.atlassian.com/doc/confluence-storage-format-790796544.html)
+- Michiの`scripts/utils/confluence-client.ts`実装を参照
+
+## 使用例
+
+```bash
+# Codex CLIから実行
+/prompts:confluence-sync FEATURE=user-authentication
+
+# 複数ファイルを一括同期（カスタムスクリプト）
+node scripts/sync-all-specs-to-confluence.js
+```

package/templates/codex/rules/README.md

@@ -0,0 +1,210 @@
+# Codex CLI + Michi Integration Guide
+
+## 🎉 Updated Integration with cc-sdd
+
+**Good News!** Codex CLIは[cc-sdd](https://github.com/gotalab/cc-sdd)と統合することで、Michiワークフローを完全にサポートできるようになりました。
+
+## Quick Start
+
+### Step 1: Install cc-sdd (Required)
+
+```bash
+npx cc-sdd@latest --codex --lang ja
+```
+
+**cc-sddがインストールするもの:**
+- ✅ 11個の `/kiro:*` コマンド（`.codex/commands/`）
+- ✅ `AGENTS.md`（`.codex/docs/`）
+- ✅ `.kiro/` ディレクトリ構造
+- ✅ Spec-Driven Development (SDD) ワークフロー
+
+### Step 2: Install Michi Extensions (Automatic)
+
+Michiのセットアップ時に自動的にインストールされます:
+
+```bash
+npx @sk8metal/michi-cli setup-existing --codex --lang ja
+```
+
+**Michi拡張がインストールするもの:**
+- ✅ `/prompts:confluence-sync` コマンド（Confluence連携）
+- ✅ `AGENTS.override.md`（Michi固有ルール）
+- ✅ `.kiro/project.json`（プロジェクトメタデータ）
+
+---
+
+## Available Commands
+
+### cc-sdd Commands (11 total)
+
+| Command | Description |
+|---------|-------------|
+| `/kiro:steering` | プロジェクトメモリの生成・更新 |
+| `/kiro:steering-custom` | ドメイン固有ステアリングファイル作成 |
+| `/kiro:spec-init` | 新規仕様フォルダ初期化 |
+| `/kiro:spec-requirements` | 要件定義書作成（EARS形式） |
+| `/kiro:spec-design` | 設計ドキュメント作成 |
+| `/kiro:spec-tasks` | タスク分割（並列実行可能） |
+| `/kiro:spec-impl` | TDDベース実装 |
+| `/kiro:spec-status` | ワークフロー進捗確認 |
+| `/kiro:validate-gap` | 既存コードとのギャップ分析 |
+| `/kiro:validate-design` | 設計レビュー |
+| `/kiro:validate-impl` | 実装品質検証 |
+
+### Michi Commands (1 total)
+
+| Command | Description |
+|---------|-------------|
+| `/prompts:confluence-sync` | 仕様ドキュメントをConfluenceに同期 |
+
+---
+
+## Workflow Example
+
+### 1. 初期化
+```bash
+/kiro:steering
+```
+→ プロジェクトメモリ（structure.md、tech.md、product.md）を生成
+
+### 2. 仕様作成
+```bash
+/kiro:spec-init FEATURE=user-authentication
+/kiro:spec-requirements FEATURE=user-authentication
+/kiro:spec-design FEATURE=user-authentication
+```
+
+### 3. Confluence同期 (Michi拡張)
+```bash
+/prompts:confluence-sync FEATURE=user-authentication
+```
+→ requirements.mdとdesign.mdをConfluenceページに変換
+
+### 4. 実装
+```bash
+/kiro:spec-tasks FEATURE=user-authentication
+/kiro:spec-impl FEATURE=user-authentication
+```
+
+### 5. 検証
+```bash
+/kiro:validate-impl FEATURE=user-authentication
+```
+
+---
+
+## Confluence Integration Setup
+
+### 環境変数設定
+`.env`ファイルに以下を追加:
+
+```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"]
+}
+```
+
+---
+
+## File Structure
+
+```
+project/
+├── .codex/
+│   ├── commands/          # cc-sdd: /kiro:* commands
+│   ├── docs/
+│   │   └── AGENTS.md      # cc-sdd: Base project context
+│   └── prompts/           # Michi: /prompts:* commands
+│       └── confluence-sync.md
+├── .kiro/
+│   ├── project.json       # Michi: Project metadata
+│   ├── specs/             # cc-sdd: Feature specifications
+│   │   └── {feature}/
+│   │       ├── requirements.md
+│   │       ├── design.md
+│   │       ├── tasks.md
+│   │       └── spec.json
+│   ├── steering/          # cc-sdd: AI guidance documents
+│   │   ├── structure.md
+│   │   ├── tech.md
+│   │   └── product.md
+│   └── settings/          # cc-sdd: Templates and rules
+└── AGENTS.override.md     # Michi: Project-specific rules
+```
+
+---
+
+## Project Metadata
+
+Reference `.kiro/project.json` for project information:
+
+- **Project ID**: {{PROJECT_ID}}
+- **Language**: {{LANG_CODE}}
+- **JIRA Key**: (from project.json)
+- **Confluence Space**: (from project.json)
+- **Confluence Labels**: (from project.json)
+
+---
+
+## Michi-Specific Features
+
+### 1. Multi-Language Support
+- Node.js/TypeScript (npm)
+- Java (Gradle only)
+- PHP (Composer)
+
+### 2. Master Test Approach
+- 常に最新の仕様を反映（履歴管理なし）
+- Phase A: Auto (unit, lint, build)
+- Phase B: Manual (integration, e2e, performance, security)
+
+### 3. CI/CD Integration
+- GitHub Actions
+- Screwdriver
+
+### 4. Release Flow
+- セマンティックバージョニング（v<major>.<minor>.<patch>）
+- Confluence手順書
+- JIRA Release管理
+
+---
+
+## Troubleshooting
+
+### Q1: cc-sddコマンドが見つからない
+```bash
+# 再インストール
+npx cc-sdd@latest --codex --lang ja
+```
+
+### Q2: Confluence同期が失敗する
+```bash
+# 環境変数を確認
+cat .env | grep ATLASSIAN
+
+# 接続テスト
+curl -u "$ATLASSIAN_EMAIL:$ATLASSIAN_API_TOKEN" \
+  "$ATLASSIAN_URL/wiki/rest/api/content"
+```
+
+### Q3: AGENTS.override.mdが反映されない
+Codex CLIは`AGENTS.md`と`AGENTS.override.md`を自動的にマージします。プロジェクトルートに配置されていることを確認してください。
+
+---
+
+## Learn More
+
+- **cc-sdd**: https://github.com/gotalab/cc-sdd
+- **Michi Documentation**: https://github.com/sk8metalme/michi
+- **Codex CLI**: https://developers.openai.com/codex/cli
+- **Confluence API**: https://developer.atlassian.com/cloud/confluence/rest/v2/

package/templates/common/.kiro/project.json.template

@@ -0,0 +1,21 @@
+{
+  "projectId": "{{PROJECT_ID}}",
+  "projectName": "{{PROJECT_NAME}}",
+  "language": "{{LANG_CODE}}",
+  "jiraProjectKey": "{{JIRA_KEY}}",
+  "jiraBaseUrl": "https://your-domain.atlassian.net",
+  "confluenceSpaceKey": "{{CONFLUENCE_SPACE}}",
+  "confluenceLabels": ["{{PROJECT_ID}}", "ai-development"],
+  "status": "active",
+  "team": [],
+  "stakeholders": [],
+  "repository": "{{REPO_URL}}",
+  "description": "{{PROJECT_DESCRIPTION}}",
+  "createdAt": "{{CREATED_DATE}}",
+  "metadata": {
+    "testStrategy": "master-test-approach",
+    "cicd": ["github-actions"],
+    "buildTool": "{{BUILD_TOOL}}",
+    "michiVersion": "{{MICHI_VERSION}}"
+  }
+}