@sk8metal/michi-cli 0.2.1 → 0.4.0

package/templates/claude/commands/michi/test-planning.md

@@ -0,0 +1,174 @@
+---
+name: /michi:test-planning
+description: Integrated test planning workflow for Phase 0.3-0.4 (Test type selection and test specification creation)
+allowed-tools: Bash, Glob, Grep, LS, Read, Write, Edit, MultiEdit, Update, AskUserQuestion
+argument-hint: <feature-name> [-y]
+---
+
+# Michi: Test Planning (Phase 0.3-0.4)
+
+## Development Guidelines
+
+{{DEV_GUIDELINES}}
+
+## Overview
+
+This command integrates Phase 0.3 (Test Type Selection) and Phase 0.4 (Test Specification Creation) into a single, guided workflow. The AI will help you select appropriate test types based on your design document and create comprehensive test specifications.
+
+## Prerequisites
+
+Before running this command, ensure:
+- Phase 0.2 (Design) has been completed
+- `.kiro/specs/{feature}/design.md` exists
+- `spec.json` shows `design.approved: true`
+
+## Workflow
+
+### Phase 0.3: Test Type Selection
+
+1. **Read Design Document**
+   - Load `.kiro/specs/{feature}/design.md`
+   - Extract Testing Strategy section
+   - Analyze project requirements to determine appropriate test types
+
+2. **Recommend Test Types**
+   Based on the design analysis, recommend appropriate test types:
+   - **Unit Test** (単体テスト): Required for all features with business logic
+   - **Integration Test** (統合テスト): Required when multiple components interact
+   - **E2E Test**: Required for user-facing features
+   - **Performance Test** (パフォーマンステスト): Required for APIs or high-load features
+   - **Security Test** (セキュリティテスト): Required for authentication, authorization, or data handling features
+
+3. **User Selection**
+   Use `AskUserQuestion` to let the user select which test types to implement:
+
+   ```markdown
+   Question: "どのテストタイプを実装しますか？（複数選択可）"
+
+   Options:
+   - Unit Test (単体テスト) - 推奨
+   - Integration Test (統合テスト) - 推奨
+   - E2E Test - 推奨（ユーザー向け機能の場合）
+   - Performance Test (パフォーマンステスト)
+   - Security Test (セキュリティテスト) - 推奨（認証・認可機能の場合）
+   ```
+
+   Set `multiSelect: true` to allow multiple selections.
+
+4. **Save Selection**
+   Create `.kiro/specs/{feature}/test-type-selection.json`:
+
+   ```json
+   {
+     "featureName": "{feature}",
+     "selectedTypes": ["unit", "integration", "e2e", "performance", "security"],
+     "timestamp": "2025-12-09T12:00:00Z",
+     "phase": "0.3"
+   }
+   ```
+
+### Phase 0.4: Test Specification Creation
+
+For each selected test type, create a test specification document:
+
+1. **Read Template**
+   Load the appropriate template from:
+   - Unit: `docs/user-guide/templates/test-specs/unit-test-spec-template.md`
+   - Integration: `docs/user-guide/templates/test-specs/integration-test-spec-template.md`
+   - E2E: `docs/user-guide/templates/test-specs/e2e-test-spec-template.md`
+   - Performance: `docs/user-guide/templates/test-specs/performance-test-spec-template.md`
+   - Security: `docs/user-guide/templates/test-specs/security-test-spec-template.md`
+
+2. **Extract Design Information**
+   From `design.md`, extract:
+   - Architecture diagrams
+   - Component interfaces
+   - API endpoints
+   - Data models
+   - Testing Strategy section
+
+3. **Generate Test Specification**
+   Use the template structure and design information to create a comprehensive test specification:
+   - Replace template placeholders with actual feature details
+   - Generate specific test cases based on requirements and design
+   - Include requirement traceability IDs
+   - Add coverage targets (95% for critical code, 80% minimum)
+
+4. **Save Test Specification**
+   Create `.kiro/specs/{feature}/test-specs/{test-type}-test-spec.md`:
+   - `unit-test-spec.md`
+   - `integration-test-spec.md`
+   - `e2e-test-spec.md`
+   - `performance-test-spec.md`
+   - `security-test-spec.md`
+
+5. **Update spec.json**
+   Update phase information in `spec.json`:
+
+   ```json
+   {
+     "phase": "test-planning-completed",
+     "testPlanning": {
+       "phase03Completed": true,
+       "phase04Completed": true,
+       "testTypesSelected": ["unit", "integration", "e2e"],
+       "testSpecsGenerated": ["unit", "integration", "e2e"]
+     }
+   }
+   ```
+
+## Output Structure
+
+After completion, the following structure will be created:
+
+```
+.kiro/specs/{feature}/
+├── spec.json (updated)
+├── requirements.md
+├── design.md
+├── test-type-selection.json (NEW)
+└── test-specs/ (NEW)
+    ├── unit-test-spec.md
+    ├── integration-test-spec.md
+    ├── e2e-test-spec.md
+    ├── performance-test-spec.md (optional)
+    └── security-test-spec.md (optional)
+```
+
+## Next Steps
+
+After completing test planning, guide the user to the next phase:
+
+### Recommended: Design Validation (Optional)
+
+```bash
+/michi:validate-design {feature-name}
+```
+
+This command will:
+- Review the design quality
+- **Verify test planning completion** ✅
+- Check requirement traceability
+
+### Or: Proceed to Task Generation
+
+```bash
+/kiro:spec-tasks {feature-name} [-y]
+```
+
+This will generate implementation tasks based on requirements, design, and test specifications.
+
+---
+
+**Important:** Test planning (Phase 0.3-0.4) ensures that test implementation is properly included in the task breakdown, leading to comprehensive TDD implementation.
+
+## Error Handling
+
+- **Feature not found**: Display error and guide user to run `/kiro:spec-init` first
+- **Design not approved**: Display error and guide user to complete Phase 0.2 first
+- **Template read failure**: Use fallback structure and warn user
+- **User cancels selection**: Save partial progress and allow resumption
+
+---
+
+**Michi Extension:** This command provides an integrated, AI-guided workflow for test planning that enhances the standard cc-sdd flow.

package/templates/claude/commands/michi/validate-design.md

@@ -0,0 +1,58 @@
+---
+name: /michi:validate-design
+description: Interactive technical design validation with test planning readiness check (Michi version)
+allowed-tools: Bash, Glob, Grep, LS, Read, Write, Edit, MultiEdit, Update, WebSearch, WebFetch, AskUserQuestion
+argument-hint: <feature-name>
+---
+
+# Michi: Design Validation with Test Planning
+
+## Base Command Reference
+@.claude/commands/kiro/validate-design.md
+
+## Development Guidelines
+
+{{DEV_GUIDELINES}}
+
+## Michi Extension: Test Planning Readiness Check
+
+設計レビューで GO 判定後、Phase 0.3-0.4（テスト計画）が完了しているか確認します。
+
+### Post-Validation Checklist
+
+設計が承認された場合（GO Decision）、以下を確認してください：
+
+#### テスト計画完了確認
+
+- [ ] `.kiro/specs/$1/test-specs/` ディレクトリが存在するか
+- [ ] テスト仕様書が作成されているか（Phase 0.4 完了）
+- [ ] テストタイプが選択されているか（Phase 0.3 完了）
+
+**未完了の場合の推奨アクション**:
+
+Phase 0.3-0.4 が未完了の場合は、タスク生成前に完了することを推奨します：
+
+1. **Phase 0.3: テストタイプの選択**
+   - 参照: `docs/user-guide/testing/test-planning-flow.md#phase-03-テストタイプの選択`
+   - 設計書の Testing Strategy セクションを基に決定
+
+2. **Phase 0.4: テスト仕様書の作成**
+   - テンプレート:
+     - 単体テスト: `docs/user-guide/templates/test-specs/unit-test-spec-template.md`
+     - 統合テスト: `docs/user-guide/templates/test-specs/integration-test-spec-template.md`
+   - 出力先: `.kiro/specs/$1/test-specs/`
+
+3. **完了後**: `/kiro:spec-tasks $1` でタスク生成に進む
+
+### Next Phase Guidance
+
+**テスト計画完了済みの場合**:
+- `/kiro:spec-tasks $1` でタスク生成
+
+**テスト計画未完了の場合**:
+- Phase 0.3-0.4 を実施してから `/kiro:spec-tasks $1`
+- または `/michi:spec-design $1` を再実行して Next Phase ガイダンスを確認
+
+---
+
+**Michi 固有機能**: このコマンドは cc-sdd 標準の `/kiro:validate-design` を拡張し、Michi 固有のテスト計画完了確認を追加します。

package/templates/claude/commands/michi/version-audit.md

@@ -5,6 +5,10 @@ description: 依存パッケージのStableバージョンを確認する
 
 # バージョン確認
 
+## Development Guidelines
+
+{{DEV_GUIDELINES}}
+
 このコマンドは、プロジェクトの依存パッケージのバージョンを確認し、Stable/LTSバージョンの使用を推奨します。
 
 ## サブエージェント呼び出し

package/templates/michi/cc-sdd-overrides/README.md

@@ -0,0 +1,58 @@
+# Michi cc-sdd-overrides
+
+このディレクトリは、cc-sddツールが生成する汎用テンプレートに対する、Michi固有のカスタマイズを管理します。
+
+## 目的
+
+- **問題**: cc-sddが生成する`.kiro/settings/`はGit管理外だが、Michi固有のカスタマイズ（日本語、Phase A/B、JIRA/Confluence連携）が必要
+- **解決**: Michi固有の差分をこのディレクトリで管理し、`setup-existing`実行時に適用
+
+## ディレクトリ構造
+
+```
+cc-sdd-overrides/
+└── settings/
+    ├── rules/
+    │   └── design-review-michi.md  # Michi固有の設計レビュールール
+    └── templates/
+        └── specs/
+            ├── tasks.md   # Michi固有のタスクテンプレート
+            └── init.json  # 日本語デフォルト設定
+```
+
+## Michi固有の要素
+
+### design-review-michi.md
+- cc-sdd 標準の `design-review.md` を拡張
+- Phase 0.3-0.4（テスト計画）の準備状況評価を追加
+- Testing Strategy セクションの詳細度、トレーサビリティ、非機能要件への対応を評価
+- `/michi:validate-design` コマンドで使用
+
+### tasks.md
+- 日本語で記述
+- Michiワークフロー（Phase 0.1-0.4, Phase 1-5, Phase A, Phase B）
+- JIRA連携（ラベル: `spec-init`, `requirements`, `design`, `phase-a`, `phase-b`等）
+- Confluence連携（リリース手順書、完了報告）
+- `michi-cli`コマンド参照
+
+### init.json
+- `"language": "ja"` - 日本語をデフォルト言語として設定
+
+## 適用タイミング
+
+`setup-existing`コマンド実行時、以下の順序で処理：
+
+1. cc-sddが汎用テンプレートを生成 → `.kiro/settings/`
+2. Michiがオーバーライドを適用 ← `templates/michi/cc-sdd-overrides/`
+
+結果として、`.kiro/settings/templates/specs/tasks.md`がMichi固有版に上書きされます。
+
+## Git管理
+
+- このディレクトリ（`templates/michi/cc-sdd-overrides/`）: **Git管理対象**
+- 生成先（`.kiro/settings/`）: **Git管理外**（`.gitignore`に含まれる）
+
+## 参考
+
+- [cc-sdd公式リポジトリ](https://github.com/gotalab/cc-sdd)
+- [setup-existingコマンド実装](../../../src/commands/setup-existing.ts)

package/templates/michi/cc-sdd-overrides/settings/rules/design-review-michi.md

@@ -0,0 +1,53 @@
+# Michi Extension: Design Review with Test Planning Readiness
+
+> **Michi 固有拡張**: この設計レビュールールは cc-sdd 標準の `design-review.md` を拡張し、Michi 固有のテスト計画準備状況評価を追加します。
+
+## Base Rules Reference
+@.kiro/settings/rules/design-review.md
+
+## Additional Review Criteria
+
+### 5. Testing Strategy Readiness (Michi Extension)
+
+設計レビュー時に、Phase 0.3-0.4（テスト計画）の準備状況も確認してください：
+
+#### 評価ポイント
+
+- [ ] **Testing Strategy セクションの詳細度**: Phase 0.3 のテストタイプ選択を支援できる十分な詳細を含むか
+  - 各テストタイプ（単体/統合/E2E/パフォーマンス/セキュリティ）の必要性が検討されているか
+  - テストシナリオが具体的に記述されているか
+  - テスト対象コンポーネントが明確か
+
+- [ ] **トレーサビリティ**: テストシナリオが requirements.md のトレーサビリティと整合しているか
+  - 各要件に対応するテストシナリオが存在するか
+  - 要件IDとテストシナリオの紐付けが明確か
+
+- [ ] **非機能要件への対応**: パフォーマンス/セキュリティテストの必要性が検討されているか
+  - 高負荷が予想されるシステムでパフォーマンステストが計画されているか
+  - 機密データを扱うシステムでセキュリティテストが計画されているか
+  - 外部公開APIでセキュリティテストが計画されているか
+
+#### 判定基準
+
+**GO 判定の条件**:
+- Testing Strategy セクションが Phase 0.3 のテストタイプ選択に必要な情報を提供している
+- テストシナリオが要件とトレーサブルである
+- 非機能要件に対するテスト計画が適切に検討されている
+
+**NO-GO 判定の条件**:
+- Testing Strategy セクションが不足または不明確
+- テストシナリオと要件の紐付けが不明確
+- 明らかに必要な非機能テスト（パフォーマンス/セキュリティ）が検討されていない
+
+#### レビュー後の推奨アクション
+
+設計が承認された場合（GO Decision）:
+1. Phase 0.3: テストタイプの選択を実施
+2. Phase 0.4: テスト仕様書の作成を実施
+3. Phase 0.5: タスク分割（`/kiro:spec-tasks`）に進む
+
+詳細は [テスト計画フロー](docs/user-guide/testing/test-planning-flow.md) を参照してください。
+
+---
+
+**使用方法**: この拡張ルールを適用するには、`/michi:validate-design` コマンドを使用してください。

package/templates/michi/cc-sdd-overrides/settings/templates/specs/init.json

@@ -0,0 +1,24 @@
+{
+  "feature_name": "{{FEATURE_NAME}}",
+  "created_at": "{{TIMESTAMP}}",
+  "updated_at": "{{TIMESTAMP}}",
+  "language": "ja",
+  "phase": "initialized",
+  "approvals": {
+    "requirements": {
+      "generated": false,
+      "approved": false
+    },
+    "design": {
+      "generated": false,
+      "approved": false
+    },
+    "tasks": {
+      "generated": false,
+      "approved": false
+    }
+  },
+  "ready_for_implementation": false
+}
+
+