phasegate 0.16.0 → 0.31.0

package/skills/unit-test-designer/SKILL.md

@@ -69,22 +69,7 @@ story-implementor ← TDD実装
    - 上位設計をスキップして進める（非推奨）
 3. **ユーザー指示待ち** — 独自判断でテスト設計を開始しない
 
-**報告テンプレート:**
-```markdown
-## ⚠️ 上位レイヤー設計が見つかりません
-
-以下の設計文書が存在しないため、ユニットテスト設計を開始できません：
-- `docs/product/construction/{unit}/domain_model.md` ❌ 未作成
-
-### 推奨アクション
-`domain-designer` スキルを使用してドメインモデルを作成してください。
-
-### 選択肢
-1. **domain-designerを先に実行する**（推奨）
-2. **このまま進める**（上位設計なしで進める場合、整合性リスクあり）
-
-どちらを選択しますか？
-```
+報告テンプレートは [references/unit-test-design-template.md](references/unit-test-design-template.md) の「3. 上位設計不足時の報告テンプレート」を参照。
 
 ---
 
@@ -109,43 +94,9 @@ story-implementor ← TDD実装
 
 ### 計画ファイルの構成
 
-```markdown
-# ユニットテスト設計計画: {Unit名}
-
-## 1. スコープ
-- 対象Unitのドメインモデル
-- テスト対象コンポーネント一覧
-
-## 2. テスト対象分析
-
-### 集約
-| 集約名 | 不変条件数 | 状態遷移数 | テストケース概算 |
-|--------|----------|----------|---------------|
+スコープ、テスト対象分析（集約・エンティティ・値オブジェクト）、テスト方針、QA、前提条件・リスクの5セクション構成。
 
-### エンティティ
-| エンティティ名 | ビジネスルール数 | テストケース概算 |
-|--------------|---------------|---------------|
-
-### 値オブジェクト
-| 値オブジェクト名 | 制約数 | テストケース概算 |
-|----------------|-------|---------------|
-
-## 3. テスト方針
-- 正常系/異常系のバランス
-- 境界値テストの対象
-
-## 4. QA（不明点・確認事項）
-
-### [Question] Q1: {質問タイトル}
-{質問の詳細と背景}
-**推奨案:** {AIの推奨案}
-
-[Answer]
-（人間が回答を記入）
-
-## 5. 前提条件・リスク
-- ...
-```
+詳細なテンプレートは [references/unit-test-design-template.md](references/unit-test-design-template.md) の「1. Phase 1 計画ファイルテンプレート」を参照。
 
 ### Phase 1 完了条件
 - 計画ファイルを出力した
@@ -189,61 +140,9 @@ story-implementor ← TDD実装
 
 ### unit_test_design.md の構成
 
-```markdown
-# ユニットテスト設計: {Unit名}
-
-## 1. 対象ドメインモデル
-- 集約: {集約名一覧}
-- エンティティ: {エンティティ名一覧}
-- 値オブジェクト: {値オブジェクト名一覧}
+対象ドメインモデル、集約テストケース（不変条件・状態遷移・生成）、エンティティテストケース（ビジネスルール・振る舞い）、値オブジェクトテストケース（等値性・制約）、境界値・異常系の5セクション構成。
 
-## 2. 集約テストケース
-
-### {集約名}
-
-#### 不変条件テスト
-| ケースID | 不変条件 | 入力 | 期待結果 |
-|---------|---------|------|---------|
-| UT-{集約}-001 | {条件説明} | ... | ... |
-
-#### 状態遷移テスト
-| ケースID | 初期状態 | 操作 | 期待状態 |
-|---------|---------|------|---------|
-
-#### 生成テスト
-| ケースID | 入力 | 期待結果 |
-|---------|------|---------|
-
-## 3. エンティティテストケース
-
-### {エンティティ名}
-
-#### ビジネスルールテスト
-| ケースID | ルール | 入力 | 期待結果 |
-|---------|-------|------|---------|
-
-#### 振る舞いテスト
-| ケースID | メソッド | 入力 | 期待結果 |
-|---------|---------|------|---------|
-
-## 4. 値オブジェクトテストケース
-
-### {値オブジェクト名}
-
-#### 等値性テスト
-| ケースID | 比較対象 | 期待結果 |
-|---------|---------|---------|
-
-#### 制約テスト
-| ケースID | 入力 | 期待結果 |
-|---------|------|---------|
-
-## 5. 境界値・異常系
-| ケースID | 対象 | 入力 | 期待結果 |
-|---------|------|------|---------|
-```
-
----
+詳細なテンプレートは [references/unit-test-design-template.md](references/unit-test-design-template.md) の「2. unit_test_design.md 成果物テンプレート」を参照。
 
 ---
 

package/skills/unit-test-designer/references/unit-test-design-template.md

@@ -0,0 +1,127 @@
+# ユニットテスト設計テンプレート集
+
+本ファイルは `unit-test-designer` スキルで使用するテンプレートをまとめたリファレンスです。
+
+---
+
+## 1. Phase 1 計画ファイルテンプレート
+
+出力先: `docs/inception/{unit}/unit_test_design_plan.md`
+
+```markdown
+# ユニットテスト設計計画: {Unit名}
+
+## 1. スコープ
+- 対象Unitのドメインモデル
+- テスト対象コンポーネント一覧
+
+## 2. テスト対象分析
+
+### 集約
+| 集約名 | 不変条件数 | 状態遷移数 | テストケース概算 |
+|--------|----------|----------|---------------|
+
+### エンティティ
+| エンティティ名 | ビジネスルール数 | テストケース概算 |
+|--------------|---------------|---------------|
+
+### 値オブジェクト
+| 値オブジェクト名 | 制約数 | テストケース概算 |
+|----------------|-------|---------------|
+
+## 3. テスト方針
+- 正常系/異常系のバランス
+- 境界値テストの対象
+
+## 4. QA（不明点・確認事項）
+
+### [Question] Q1: {質問タイトル}
+{質問の詳細と背景}
+**推奨案:** {AIの推奨案}
+
+[Answer]
+（人間が回答を記入）
+
+## 5. 前提条件・リスク
+- ...
+```
+
+---
+
+## 2. unit_test_design.md 成果物テンプレート
+
+出力先: `docs/product/construction/{unit}/unit_test_design.md`
+
+```markdown
+# ユニットテスト設計: {Unit名}
+
+## 1. 対象ドメインモデル
+- 集約: {集約名一覧}
+- エンティティ: {エンティティ名一覧}
+- 値オブジェクト: {値オブジェクト名一覧}
+
+## 2. 集約テストケース
+
+### {集約名}
+
+#### 不変条件テスト
+| ケースID | 不変条件 | 入力 | 期待結果 |
+|---------|---------|------|---------|
+| UT-{集約}-001 | {条件説明} | ... | ... |
+
+#### 状態遷移テスト
+| ケースID | 初期状態 | 操作 | 期待状態 |
+|---------|---------|------|---------|
+
+#### 生成テスト
+| ケースID | 入力 | 期待結果 |
+|---------|------|---------|
+
+## 3. エンティティテストケース
+
+### {エンティティ名}
+
+#### ビジネスルールテスト
+| ケースID | ルール | 入力 | 期待結果 |
+|---------|-------|------|---------|
+
+#### 振る舞いテスト
+| ケースID | メソッド | 入力 | 期待結果 |
+|---------|---------|------|---------|
+
+## 4. 値オブジェクトテストケース
+
+### {値オブジェクト名}
+
+#### 等値性テスト
+| ケースID | 比較対象 | 期待結果 |
+|---------|---------|---------|
+
+#### 制約テスト
+| ケースID | 入力 | 期待結果 |
+|---------|------|---------|
+
+## 5. 境界値・異常系
+| ケースID | 対象 | 入力 | 期待結果 |
+|---------|------|------|---------|
+```
+
+---
+
+## 3. 上位設計不足時の報告テンプレート
+
+```markdown
+## 上位レイヤー設計が見つかりません
+
+以下の設計文書が存在しないため、ユニットテスト設計を開始できません：
+- `docs/product/construction/{unit}/domain_model.md` — 未作成
+
+### 推奨アクション
+`domain-designer` スキルを使用してドメインモデルを作成してください。
+
+### 選択肢
+1. **domain-designerを先に実行する**（推奨）
+2. **このまま進める**（上位設計なしで進める場合、整合性リスクあり）
+
+どちらを選択しますか？
+```

package/skills/unit-test-logic-designer/SKILL.md

@@ -40,33 +40,25 @@ TDD実装フェーズ
 
 ---
 
-## ⚠️ 上位レイヤー存在チェック
+## 上位レイヤー存在チェック
 
 **このスキルはテストケース設計完了後、TDD実装前に実行します。**
 
-### 依存する上位設計文書
-
 | ファイル | 必須 | チェック方法 |
 |---------|------|------------|
-| `docs/product/construction/{unit}/unit_test_design.md` | ✅ 必須 | ユニットテストケース設計の存在を確認 |
-| `docs/product/construction/{unit}/domain_model.md` | ✅ 必須 | ドメインモデルの存在を確認 |
-| `docs/product/construction/{unit}/coverage_report.md` | 📋 推奨 | カバレッジ検証済みか確認 |
-
-### 上位設計が存在しない場合のアクション
+| `docs/product/construction/{unit}/unit_test_design.md` | 必須 | ユニットテストケース設計の存在を確認 |
+| `docs/product/construction/{unit}/domain_model.md` | 必須 | ドメインモデルの存在を確認 |
+| `docs/product/construction/{unit}/coverage_report.md` | 推奨 | カバレッジ検証済みか確認 |
 
 上位設計文書が存在しない場合、**ロジック設計を開始せず**、以下を行う：
-
-1. **状況報告** — ユーザーに不足している設計文書を明示
-2. **選択肢提示** — 以下の選択肢を提示
-   - 上位設計（unit-test-designer）を先に実行する
-   - 上位設計をスキップして進める（非推奨）
+1. **状況報告** — 不足している設計文書を明示
+2. **選択肢提示** — 上位設計を先に実行する / スキップして進める（非推奨）
 3. **ユーザー指示待ち** — 独自判断でロジック設計を開始しない
 
 ---
 
-## ⚠️ 3フェーズ実行ルール
+## 3フェーズ実行ルール
 
-**このスキルは3フェーズで実行する。**
 - **Phase 1（計画）**: Opus がスコープ・方針・不明点を整理し、人間の承認を得る
 - **Phase 2（実行）**: Sonnet 4.6 に委任して成果物を生成する（`scripts/delegate-sonnet.sh` 経由）
 - **Phase 3（レビュー）**: Opus が成果物を検証し、問題があれば直接修正する
@@ -97,24 +89,16 @@ TDD実装フェーズ
 | テストファイル | 対象モデル | ケース数 |
 |--------------|----------|---------|
 | `{aggregate}.test.ts` | {集約名} | X |
-| `{entity}.test.ts` | {エンティティ名} | X |
-| `{value-object}.test.ts` | {値オブジェクト名} | X |
 
 ## 3. モック/ファクトリ設計方針
-- ファクトリ関数の配置場所
-- 共通ヘルパーの使用方針
 
 ## 4. QA（不明点・確認事項）
 
 ### [Question] Q1: {質問タイトル}
-{質問の詳細と背景}
 **推奨案:** {AIの推奨案}
-
-[Answer]
-（人間が回答を記入）
+[Answer]（人間が回答を記入）
 
 ## 5. 前提条件・リスク
-- ...
 ```
 
 ### Phase 1 完了条件
@@ -138,6 +122,8 @@ TDD実装フェーズ
 3. **ファクトリ関数の設計** — テストデータ生成の共通化
 4. **モック戦略の設計** — vi.mock の使用方針
 
+詳細なテストパターン（ファクトリ関数、集約/VOテストテンプレート、モック戦略、AAAパターン例）は [references/test-patterns.md](references/test-patterns.md) を参照。
+
 ### Phase 2 最低出力基準（Sonnet委任時の品質制約）
 
 以下の基準を満たさない出力は不完全とみなし、Phase 3レビューでBLOCKとする。
@@ -153,233 +139,28 @@ TDD実装フェーズ
 
 ### 出力ファイル
 
-| 種別 | 配置先 |
-|------|--------|
-| 成果物 | `docs/product/construction/{unit}/unit_test_logic.md` |
+`docs/product/construction/{unit}/unit_test_logic.md`
 
 ### unit_test_logic.md の構成
 
-```markdown
-# ユニットテストロジック設計: {Unit名}
-
-## 1. テストファイル構成
-
-| ファイルパス | 対象モデル | ケース数 |
-|------------|----------|---------|
-| `backend/test/unit/{context}/domain/aggregates/{aggregate}.test.ts` | {集約名} | X |
-| `backend/test/unit/{context}/domain/entities/{entity}.test.ts` | {エンティティ名} | X |
-| `backend/test/unit/{context}/domain/value-objects/{vo}.test.ts` | {値オブジェクト名} | X |
-
-## 2. 共通ヘルパー・ファクトリ
-
-### ファクトリ関数
-
-```typescript
-// backend/test/helpers/{context}-helper.ts
-
-/**
- * {集約名}のテスト用ファクトリ
- */
-export function create{Aggregate}(overrides?: Partial<{Aggregate}Props>): {Aggregate} {
-  return {Aggregate}.create({
-    // デフォルト値
-    id: to{Aggregate}Id('test-001'),
-    name: 'テスト',
-    ...overrides,
-  });
-}
-```
-
-### 共通ヘルパーのインポート
-
-```typescript
-import { target, context } from '../../../../helpers/common-helper.js';
-```
-
-## 3. テストケース詳細ロジック
-
-### {集約名} テスト
-
-#### ファイル: `{aggregate}.test.ts`
-
-```typescript
-import { describe, it, expect } from 'vitest';
-import { target, context } from '../../../../helpers/common-helper.js';
-import { {Aggregate} } from '../../../../../src/{context}/domain/aggregates/{aggregate}.js';
-
-target('{Aggregate}', () => {
-  // UT-{Aggregate}-001: 不変条件テスト
-  describe('{不変条件の説明}', () => {
-    it('{期待される振る舞い}', () => {
-      // Arrange
-      const props = {
-        // テストデータ
-      };
-
-      // Act
-      const actual = {Aggregate}.create(props);
-
-      // Assert
-      expect(actual.{property}).toBe({expectedValue});
-    });
-
-    context('{特定の条件}の場合', () => {
-      it('{期待される結果}', () => {
-        // Arrange
-        const invalidProps = {
-          // 不正なデータ
-        };
-
-        // Act & Assert
-        expect(() => {Aggregate}.create(invalidProps)).toThrow({ExpectedError});
-      });
-    });
-  });
-
-  // UT-{Aggregate}-002: 状態遷移テスト
-  describe('{状態遷移の説明}', () => {
-    it('{初期状態}から{操作}で{期待状態}に遷移する', () => {
-      // Arrange
-      const aggregate = create{Aggregate}({ status: '{初期状態}' });
-
-      // Act
-      aggregate.{operation}();
-
-      // Assert
-      expect(aggregate.status).toBe('{期待状態}');
-    });
-  });
-});
-```
-
-### {値オブジェクト名} テスト
-
-#### ファイル: `{value-object}.test.ts`
-
-```typescript
-import { describe, it, expect } from 'vitest';
-import { target, context } from '../../../../helpers/common-helper.js';
-import { {ValueObject} } from '../../../../../src/{context}/domain/value-objects/{value-object}.js';
-
-target('{ValueObject}', () => {
-  // UT-VO-{Name}-001: 生成テスト
-  describe('{ValueObject}を生成する', () => {
-    it('有効な値で生成できる', () => {
-      // Arrange
-      const value = '{有効な値}';
-
-      // Act
-      const actual = {ValueObject}.create(value);
-
-      // Assert
-      expect(actual.value).toBe(value);
-    });
-
-    context('無効な値の場合', () => {
-      it.each([
-        ['空文字', ''],
-        ['null', null],
-        ['{境界値}', '{境界値の例}'],
-      ])('%sの場合エラーになる', (_, invalidValue) => {
-        // Act & Assert
-        expect(() => {ValueObject}.create(invalidValue)).toThrow();
-      });
-    });
-  });
-
-  // UT-VO-{Name}-002: 等値性テスト
-  describe('等値性', () => {
-    it('同じ値を持つ{ValueObject}は等しい', () => {
-      // Arrange
-      const vo1 = {ValueObject}.create('{値}');
-      const vo2 = {ValueObject}.create('{値}');
-
-      // Act & Assert
-      expect(vo1.equals(vo2)).toBe(true);
-    });
-  });
-});
-```
-
-## 4. モック戦略
-
-### vi.mock の使用方針
-
-```typescript
-import { vi, describe, it, expect, beforeEach } from 'vitest';
-
-// 外部依存のモック
-vi.mock('../../../../../src/{context}/infrastructure/{dependency}.js', () => ({
-  {DependencyClass}: vi.fn().mockImplementation(() => ({
-    {method}: vi.fn().mockResolvedValue({mockValue}),
-  })),
-}));
-```
-
-### モック不要のケース
-- 純粋なドメインロジック（Entity, ValueObject）
-- 状態遷移ロジック
-- 計算ロジック
+成果物は以下のセクションで構成する：
 
-### モック必要のケース
-- インフラ層への依存がある場合
-- 外部APIへの依存がある場合
+1. **テストファイル構成** — ファイルパス・対象モデル・ケース数の一覧
+2. **共通ヘルパー・ファクトリ** — ファクトリ関数とインポートパス
+3. **テストケース詳細ロジック** — 各テストの疑似コード（AAAパターン）
+4. **モック戦略** — vi.mock の使用方針と対象
+5. **境界値テスト一覧** — ケースID・境界条件・入力例・期待結果
+6. **テスト実行コマンド** — 実行方法
 
-## 5. 境界値テスト一覧
-
-| ケースID | 対象 | 境界条件 | 入力例 | 期待結果 |
-|---------|------|---------|-------|---------|
-| UT-BV-001 | {ValueObject} | 最小値 | 0 | 成功 |
-| UT-BV-002 | {ValueObject} | 最小値-1 | -1 | エラー |
-| UT-BV-003 | {ValueObject} | 最大値 | 100 | 成功 |
-| UT-BV-004 | {ValueObject} | 最大値+1 | 101 | エラー |
-
-## 6. テスト実行コマンド
-
-```bash
-# 全ユニットテスト実行
-pnpm --filter backend test:unit
-
-# 特定ファイルのみ
-pnpm --filter backend test:unit -- {aggregate}.test.ts
-
-# watchモード
-pnpm --filter backend test:unit -- --watch
-```
-```
+各セクションのテンプレートは [references/test-patterns.md](references/test-patterns.md) を参照。
 
 ---
 
 ## 設計原則
 
-### 1. AAA パターンの徹底
-- **Arrange**: テストデータの準備
-- **Act**: テスト対象の実行
-- **Assert**: 結果の検証
-
-### 2. コメントによる明示
-```typescript
-// Arrange
-const data = ...;
-
-// Act
-const actual = target.method(data);
-
-// Assert
-expect(actual).toBe(expected);
-```
-
-### 3. 既存パターンの踏襲
-- `target()` と `context()` ヘルパーを使用
-- ファイル配置は既存の構造に合わせる
-- import パスは相対パスで統一
-
-### 4. 疑似コードの粒度
-- 実装エージェントが迷わないレベルの詳細さ
-- 具体的な値・型・メソッド名を記載
-- エッジケースのテストパターンを明示
-
----
+1. **AAA パターンの徹底** — Arrange / Act / Assert を全テストで使用し、コメントで明示する
+2. **既存パターンの踏襲** — `target()` / `context()` ヘルパー使用、相対パスで統一
+3. **疑似コードの粒度** — 実装エージェントが迷わないレベル（具体的な値・型・メソッド名を記載）
 
 ---
 
@@ -406,9 +187,11 @@ expect(actual).toBe(expected);
 - **WARNのみFAIL** → Opusが直接修正してから完了とする
 - **全PASS** → 完了
 
+---
+
 ## 注意事項
 
-- **テストコードは生成しない**（設計文書のみ）— 実装は `story-implementor` スキル（codex-delegator経由、またはメインセッションで直接実行）が行う
+- **テストコードは生成しない**（設計文書のみ）— 実装は `story-implementor` が行う
 - 疑似コードは実装の指針となる詳細レベルで記載する
 - TDDの「RED」フェーズで正しく失敗するテストを設計する
 - 既存のテストパターン（`backend/test/unit/**/*.test.ts`）を参照してスタイルを統一する
@@ -419,11 +202,6 @@ expect(actual).toBe(expected);
 
 ユニットテストロジック設計完了後、以下のスキルに進んでください：
 
-1. **ITテストロジック設計** — UseCase/Repository/Controllerのテストロジック
-   - `it-test-logic-designer`
-
-2. **シナリオテストロジック設計** — E2Eテストのテストロジック
-   - `scenario-test-logic-designer`
-
-3. **TDD実装** — 全テストロジック設計完了後
-   - `story-implementor`
+1. **ITテストロジック設計** — `it-test-logic-designer`
+2. **シナリオテストロジック設計** — `scenario-test-logic-designer`
+3. **TDD実装**（全テストロジック設計完了後） — `story-implementor`