@sk8metal/michi-cli 0.10.1 → 0.11.0

package/docs/user-guide/reference/tasks-template.md

@@ -1,550 +0,0 @@
-# タスク分割テンプレート（6フェーズ版）
-
-このドキュメントは、要件定義・設計・実装・試験・リリース準備・リリースの**6フェーズすべて**を含むtasks.mdのテンプレートです。
-
-## 概要
-
-**重要**: tasks.mdは以下の6フェーズを含める必要があります：
-
-1. **Phase 0: 要件定義（Requirements）**
-2. **Phase 1: 設計（Design）**
-3. **Phase 2: 実装（Implementation）** - プロジェクトセットアップからコア機能実装まで
-4. **Phase 3: 試験（Testing）**
-5. **Phase 4: リリース準備（Release Preparation）**
-6. **Phase 5: リリース（Release）**
-
-### 完了条件について
-
-**完了条件（Acceptance Criteria）**は、そのStoryが「完了」とみなされるために満たすべき条件です。
-
-- ✅ **正しい理解**: 「そのJIRAタスクが完了するための条件」
-- すべての完了条件を満たした時点で、Storyは「完了」とみなされます
-- レビュー時には、完了条件を1つずつ確認して完了を判断します
-
-## フェーズヘッダーの形式
-
-```markdown
-## Phase X: フェーズ名（ラベル）
-```
-
-**重要**: `（ラベル）`部分は必須です。JIRAストーリーのラベル検出に使用されます。
-
-### 例
-
-```markdown
-## Phase 0: 要件定義（Requirements）
-## Phase 1: 設計（Design）
-## Phase 2: 実装（Implementation）
-## Phase 3: 試験（Testing）
-## Phase 4: リリース準備（Release Preparation）
-## Phase 5: リリース（Release）
-```
-
-## テンプレート例
-
----
-
-# タスク分割: 機能名
-
-> **プロジェクト**: プロジェクト名  
-> **作成日**: YYYY-MM-DD  
-> **Epic**: JIRA-KEY
-> **期限**: YYYY-MM-DD
-
-## 概要
-
-機能の概要説明
-
----
-
-## Phase 0: 要件定義（Requirements）
-
-### Story 0.1: 要件定義書作成
-
-**JIRA**: 未作成  
-**優先度**: High  
-**見積もり**: 2 SP  
-**担当**: PM
-
-**説明**:
-ステークホルダーへのヒアリングと要件定義書の作成
-
-**完了条件**:
-- [ ] ステークホルダーへのヒアリング完了
-- [ ] 機能要件の定義
-- [ ] 非機能要件の定義
-- [ ] requirements.md作成
-- [ ] Confluenceページ作成
-- [ ] フィードバック対応
-- [ ] 承認取得
-
-**サブタスク**:
-- [ ] Task 0.1.1: ステークホルダーヒアリング（2h）
-- [ ] Task 0.1.2: 要件定義書作成（3h）
-- [ ] Task 0.1.3: Confluence同期（0.5h）
-- [ ] Task 0.1.4: レビュー依頼（0.5h）
-- [ ] Task 0.1.5: フィードバック対応（1h）
-- [ ] Task 0.1.6: 承認取得（0.5h）
-
-**依存関係**: なし
-
----
-
-## Phase 1: 設計（Design）
-
-### Story 1.1: 基本設計
-
-**JIRA**: 未作成  
-**優先度**: High  
-**見積もり**: 3 SP  
-**担当**: リードエンジニア
-
-**説明**:
-アーキテクチャ、データモデル、API設計の基本設計
-
-**完了条件**:
-- [ ] アーキテクチャ設計完了
-- [ ] データモデル設計完了
-- [ ] API仕様設計完了
-- [ ] design.md作成（基本設計セクション）
-
-**サブタスク**:
-- [ ] Task 1.1.1: アーキテクチャ設計（3h）
-- [ ] Task 1.1.2: データモデル設計（2h）
-- [ ] Task 1.1.3: API仕様設計（2h）
-
-**依存関係**: Story 0.2完了後
-
----
-
-### Story 1.2: 詳細設計
-
-**JIRA**: 未作成  
-**優先度**: High  
-**見積もり**: 5 SP  
-**担当**: 開発者
-
-**説明**:
-クラス設計、シーケンス図、画面設計の詳細設計
-
-**完了条件**:
-- [ ] クラス図作成
-- [ ] シーケンス図作成
-- [ ] 画面設計完了
-- [ ] design.md完成
-- [ ] Confluenceページ作成
-
-**サブタスク**:
-- [ ] Task 1.2.1: クラス設計（5h）
-- [ ] Task 1.2.2: シーケンス図作成（3h）
-- [ ] Task 1.2.3: 画面設計（2h）
-- [ ] Task 1.2.4: Confluence同期（0.5h）
-
-**依存関係**: Story 1.1完了後
-
----
-
-### Story 1.3: 技術レビュー・PM承認
-
-**JIRA**: 未作成  
-**優先度**: High  
-**見積もり**: 1 SP  
-**担当**: PM、リードエンジニア
-
-**説明**:
-設計書の技術レビューとPM承認の取得
-
-**完了条件**:
-- [ ] 技術レビュー完了
-- [ ] PM承認取得
-- [ ] spec.jsonのmilestones.design.completed更新
-
-**サブタスク**:
-- [ ] Task 1.3.1: 技術レビュー（1h）
-- [ ] Task 1.3.2: フィードバック対応（1h）
-- [ ] Task 1.3.3: PM承認取得（0.5h）
-
-**依存関係**: Story 1.2完了後
-
----
-
-## Phase 2: 実装（Implementation）
-
-### Story 2.1: プロジェクトの初期構築・環境構築・開発準備
-
-**JIRA**: 未作成  
-**優先度**: High  
-**見積もり**: 2 SP  
-**担当**: 開発者
-
-**説明**:
-プロジェクトの初期構築、開発環境の構築、開発準備を行います。設計書に基づいて、プロジェクトの骨組み（フレームワーク、依存関係、ディレクトリ構造）を作成します。
-
-**具体例（Java + Spring Bootの場合）**:
-- Gradle/Mavenプロジェクトの作成
-- Spring Boot依存関係の追加
-- Onion Architectureなどのアーキテクチャパターンに基づいたパッケージ構造の構築
-- 基本設定ファイル（application.yml、.gitignore等）の作成
-
-**完了条件**:
-- [ ] プロジェクト作成（フレームワーク初期化）
-- [ ] 必要な依存関係を設定ファイルに追加
-- [ ] 設計書に基づいたディレクトリ構造構築
-- [ ] 基本設定ファイル作成
-- [ ] プロジェクトがビルド可能な状態
-
-**サブタスク**:
-- [ ] Task 2.1.1: プロジェクト初期化（1h）
-  - フレームワークの初期化コマンド実行
-  - 基本設定ファイル作成
-- [ ] Task 2.1.2: 依存関係設定（1h）
-  - build.gradle/pom.xmlに依存関係追加
-  - バージョン管理
-- [ ] Task 2.1.3: ディレクトリ構造構築（0.5h）
-  - 設計書に基づいたパッケージ構造作成
-  - 空のクラスファイル配置（必要に応じて）
-
-**依存関係**: Story 1.3完了後（設計承認後）
-
----
-
-### Story 2.2以降: コア機能実装
-
-（ここに具体的な実装タスクを記載）
-**重要**: 単体テストはこのフェーズで実装します。TDD（テスト駆動開発）で進めること。
-
-**実装順序の例（Onion Architectureの場合）**:
-- Story 2.2: Domain層実装（モデル、ドメインサービス）
-- Story 2.3: Application層実装（ユースケース、ポート定義）
-- Story 2.4: Infrastructure層実装（リポジトリ、外部サービス連携）
-- Story 2.5: Presentation層実装（Controller、UI）
-
-**各Storyのテンプレート**:
-
-### Story 2.X: [機能名]実装
-
-**JIRA**: 未作成  
-**優先度**: High  
-**見積もり**: X SP  
-**担当**: 開発者
-
-**説明**:
-[具体的な機能の説明]
-
-**完了条件**:
-- [ ] 実装完了
-- [ ] 単体テスト作成（カバレッジ95%以上）
-- [ ] コードレビュー完了
-
-**サブタスク**:
-- [ ] Task 2.X.1: [具体的なタスク]（Xh）
-
-**依存関係**: Story 2.X-1完了後
-
-
----
-
-## Phase 3: 試験（Testing）
-
-### Story 3.1: 結合テスト
-
-**JIRA**: 未作成  
-**優先度**: High  
-**見積もり**: 3 SP  
-**担当**: QAエンジニア
-
-**説明**:
-モジュール間の連携テスト
-
-**完了条件**:
-- [ ] テストシナリオ作成
-- [ ] 結合テスト実施
-- [ ] バグ修正完了
-
-**サブタスク**:
-- [ ] Task 3.1.1: テストシナリオ作成（2h）
-- [ ] Task 3.1.2: 結合テスト実施（5h）
-- [ ] Task 3.1.3: バグ修正（3h）
-
-**依存関係**: Story 2.x完了後（実装完了後）
-
----
-
-### Story 3.2: システムテスト（E2E）
-
-**JIRA**: 未作成  
-**優先度**: High  
-**見積もり**: 2 SP  
-**担当**: QAエンジニア
-
-**説明**:
-ユーザーシナリオに基づくE2Eテスト
-
-**完了条件**:
-- [ ] ユーザーシナリオ作成
-- [ ] E2Eテスト実施
-- [ ] すべてのシナリオ成功
-
-**サブタスク**:
-- [ ] Task 3.2.1: シナリオ作成（1h）
-- [ ] Task 3.2.2: E2Eテスト実施（3h）
-- [ ] Task 3.2.3: バグ修正（1h）
-
-**依存関係**: Story 3.1完了後
-
----
-
-### Story 3.3: 性能テスト
-
-**JIRA**: 未作成  
-**優先度**: Medium  
-**見積もり**: 2 SP  
-**担当**: QAエンジニア
-
-**説明**:
-負荷テストとレスポンスタイム測定
-
-**完了条件**:
-- [ ] 負荷テスト実施
-- [ ] レスポンスタイム基準達成
-- [ ] ボトルネック特定・改善
-
-**サブタスク**:
-- [ ] Task 3.3.1: 負荷テスト実施（2h）
-- [ ] Task 3.3.2: パフォーマンス改善（3h）
-
-**依存関係**: Story 3.2完了後
-
----
-
-## Phase 4: リリース準備（Release Preparation）
-
-### Story 4.1: 本番環境構築
-
-**JIRA**: 未作成  
-**優先度**: High  
-**見積もり**: 2 SP  
-**担当**: インフラエンジニア
-
-**説明**:
-本番環境のインフラ構築と設定
-
-**完了条件**:
-- [ ] サーバー構築
-- [ ] データベース設定
-- [ ] SSL証明書設定
-- [ ] 監視設定
-
-**サブタスク**:
-- [ ] Task 4.1.1: サーバー構築（2h）
-- [ ] Task 4.1.2: データベース設定（1h）
-- [ ] Task 4.1.3: SSL証明書設定（1h）
-- [ ] Task 4.1.4: 監視設定（1h）
-
-**依存関係**: Story 3.3完了後（性能テスト完了後）
-
----
-
-### Story 4.2: リリースドキュメント作成
-
-**JIRA**: 未作成  
-**優先度**: Medium  
-**見積もり**: 1 SP  
-**担当**: PM
-
-**説明**:
-リリースノート、マニュアル、運用手順書の作成
-
-**完了条件**:
-- [ ] リリースノート作成
-- [ ] ユーザーマニュアル作成
-- [ ] 運用手順書作成
-
-**サブタスク**:
-- [ ] Task 4.2.1: リリースノート作成（1h）
-- [ ] Task 4.2.2: マニュアル作成（1h）
-- [ ] Task 4.2.3: 運用手順書作成（0.5h）
-
-**依存関係**: Story 4.1完了後
-
----
-
-## Phase 5: リリース（Release）
-
-### Story 5.1: ステージング環境デプロイ
-
-**JIRA**: 未作成  
-**優先度**: High  
-**見積もり**: 1 SP  
-**担当**: インフラエンジニア
-
-**説明**:
-ステージング環境へのデプロイと最終確認
-
-**完了条件**:
-- [ ] ステージング環境デプロイ成功
-- [ ] スモークテスト成功
-- [ ] 最終確認完了
-
-**サブタスク**:
-- [ ] Task 5.1.1: デプロイ実施（0.5h）
-- [ ] Task 5.1.2: スモークテスト（1h）
-- [ ] Task 5.1.3: 最終確認（0.5h）
-
-**依存関係**: Story 4.2完了後
-
----
-
-### Story 5.2: 本番環境リリース
-
-**JIRA**: 未作成  
-**優先度**: High  
-**見積もり**: 1 SP  
-**担当**: インフラエンジニア、PM
-
-**説明**:
-本番環境へのリリース実施
-
-**完了条件**:
-- [ ] 本番環境デプロイ成功
-- [ ] スモークテスト成功
-- [ ] 監視確認
-- [ ] ステークホルダーへの通知
-
-**サブタスク**:
-- [ ] Task 5.2.1: 本番デプロイ（0.5h）
-- [ ] Task 5.2.2: スモークテスト（1h）
-- [ ] Task 5.2.3: 監視確認（0.5h）
-- [ ] Task 5.2.4: 通知送信（0.2h）
-
-**依存関係**: Story 5.1完了後
-
----
-
-### Story 5.3: リリース承認・完了報告
-
-**JIRA**: 未作成  
-**優先度**: High  
-**見積もり**: 1 SP  
-**担当**: PM
-
-**説明**:
-リリース承認の取得と完了報告
-
-**完了条件**:
-- [ ] 承認取得
-- [ ] Confluenceにリリース完了報告
-- [ ] spec.jsonのmilestones.release.completed更新
-
-**サブタスク**:
-- [ ] Task 5.3.1: 承認取得（0.5h）
-- [ ] Task 5.3.2: 完了報告作成（0.5h）
-- [ ] Task 5.3.3: Confluenceに完了報告（0.5h）
-
-**依存関係**: Story 5.2完了後
-
----
-
-## タイムライン（営業日ベース）
-
-**前提**: 土日・祝日を除いた営業日で計算（1日8時間の実開発時間）
-
-### Week 1: 要件定義・設計
-
-```text
-Day 1（月）:
-  - Story 0.1: 要件定義書作成（2 SP）
-  - Story 0.2: PM承認（1 SP）
-
-Day 2-3（火水）:
-  - Story 1.1: 基本設計（3 SP）
-  - Story 1.2: 詳細設計（5 SP）開始
-
-Day 4-5（木金）:
-  - Story 1.2: 詳細設計（完了）
-  - Story 1.3: 技術レビュー・PM承認（1 SP）
-```
-
-**Week 1完了時**: 要件定義・設計完了、実装開始可能
-
----
-
-### Week 2-3: 実装
-
-（プロジェクトに応じて調整）
-
----
-
-### Week 4: 試験
-
-```text
-Day 13-14（月火）:
-  - Story 3.1: 結合テスト（3 SP）
-  - Story 3.2: システムテスト（E2E）（2 SP）
-
-Day 15（水）:
-  - Story 3.3: 性能テスト（2 SP）
-```
-
-**Week 4完了時**: すべてのテスト完了
-
----
-
-### Week 5: リリース準備・リリース
-
-```text
-Day 16-17（木金）:
-  - Story 4.1: 本番環境構築（2 SP）
-  - Story 4.2: リリースドキュメント作成（1 SP）
-
-Day 18（月）:
-  - Story 5.1: ステージング環境デプロイ（1 SP）
-  - Story 5.2: 本番環境リリース（1 SP）
-  - Story 5.3: リリース承認・完了報告（1 SP）
-```
-
-**Week 5完了時**: リリース完了 🎉
-
----
-
-## 見積もりサマリー
-
-| フェーズ | ストーリーポイント | 工数（人日） | ストーリー数 |
-|---------|----------------|------------|------------|
-| Phase 0: 要件定義 | 3 SP | 1.5 日 | 2 |
-| Phase 1: 設計 | 9 SP | 4.5 日 | 3 |
-| Phase 2: 実装 | XX SP | XX 日 | XX（プロジェクトに応じて調整） |
-| Phase 3: 試験 | 7 SP | 3.5 日 | 3 |
-| Phase 4: リリース準備 | 3 SP | 1.5 日 | 2 |
-| Phase 5: リリース | 3 SP | 1.5 日 | 3 |
-| **合計** | **XX SP** | **XX 日** | **XX** |
-
-**換算レート**: 1 SP ≈ 0.5人日
-
----
-
-## JIRAラベル一覧
-
-各ストーリーには以下のラベルが自動付与されます：
-
-- `requirements` - 要件定義フェーズ
-- `design` - 設計フェーズ
-- `dev` - 実装フェーズ
-- `testing` - 試験フェーズ
-- `release-prep` - リリース準備フェーズ
-- `release` - リリースフェーズ
-
-**JIRAフィルター例**:
-```text
-project = PROJ AND labels = "requirements"  # 要件定義タスクのみ
-project = PROJ AND labels = "testing"       # 試験タスクのみ
-project = PROJ AND labels = "release"       # リリースタスクのみ
-```
-
----
-
-**次のステップ**:
-1. tasks.mdを上記テンプレートに従って作成
-2. `michi phase:run <feature> tasks` 実行
-3. JIRAに全フェーズのストーリーが自動作成される
-

package/docs/user-guide/release/ci-setup-java.md

@@ -1,114 +0,0 @@
-# Michi CI/CD設定ガイド - Java/Gradle
-
-**親ドキュメント**: [ci-setup.md](./ci-setup.md)
-
----
-
-## Java（Gradle）プロジェクトのCI/CD設定
-
-### GitHub Actions設定例
-
-**設定ファイル例**: `.github/workflows/test.yml`
-
-```yaml
-name: Test
-
-on:
-  push:
-    branches:
-      - main
-  pull_request:
-
-jobs:
-  test:
-    runs-on: ubuntu-latest
-
-    strategy:
-      matrix:
-        java-version: [17, 21]
-
-    steps:
-      - uses: actions/checkout@v4
-
-      - name: Setup JDK
-        uses: actions/setup-java@v4
-        with:
-          distribution: 'temurin'
-          java-version: ${{ matrix.java-version }}
-          cache: 'gradle'
-
-      - name: Grant execute permission for gradlew
-        run: chmod +x gradlew
-
-      - name: Run checkstyle
-        run: ./gradlew checkstyleMain checkstyleTest
-
-      - name: Run tests
-        run: ./gradlew test
-
-      - name: Build
-        run: ./gradlew build
-
-      - name: Upload test results
-        uses: actions/upload-artifact@v3
-        if: failure()
-        with:
-          name: test-results
-          path: build/reports/tests/test/
-```
-
-### Screwdriver設定例
-
-**設定ファイル例**: `screwdriver.yaml`
-
-```yaml
-shared:
-  image: openjdk:17
-
-jobs:
-  main:
-    requires: [~pr, ~commit]
-    steps:
-      - setup: chmod +x gradlew
-      - checkstyle: ./gradlew checkstyleMain checkstyleTest
-      - test: ./gradlew test
-      - build: ./gradlew build
-      - report: |
-          if [ -d "build/reports" ]; then
-            echo "Test reports generated"
-          fi
-```
-
-### build.gradle設定
-
-```gradle
-plugins {
-    id 'java'
-    id 'checkstyle'
-    id 'jacoco'
-}
-
-test {
-    useJUnitPlatform()
-    testLogging {
-        events "passed", "skipped", "failed"
-    }
-}
-
-jacoco {
-    toolVersion = "0.8.10"
-}
-
-jacocoTestReport {
-    reports {
-        xml.required = true
-        html.required = true
-    }
-}
-
-checkstyle {
-    toolVersion = '10.12.0'
-    configFile = file("${rootDir}/config/checkstyle/checkstyle.xml")
-}
-```
-