phasegate 0.16.0 → 0.31.0

package/skills/it-test-logic-designer/references/repository-test-patterns.md

@@ -0,0 +1,206 @@
+# Repository テストパターン・テンプレート
+
+本ファイルは `it-test-logic-designer` スキルで使用するRepositoryレイヤーのテストテンプレート集。
+シードデータ設計・トランザクション・クリーンアップ戦略を含む。
+
+---
+
+## テストヘルパーのインポート
+
+```typescript
+import { target, context } from '../../helpers/common-helper.js';
+import { getTestClient, cleanupTestData } from '../../helpers/supabase-test-helper.js';
+```
+
+## シードデータ設計テンプレート
+
+```typescript
+// backend/test/seeds/{context}/{seed-name}.ts
+
+export const {SEED_NAME}_SEED = {
+  // テストデータ定義
+  organizations: [
+    { id: 'org-001', name: 'テスト組織' },
+  ],
+  users: [
+    { id: 'user-001', organizationId: 'org-001', name: 'テストユーザー' },
+  ],
+};
+
+export async function seed{SeedName}(client: SupabaseClient): Promise<void> {
+  // INSERT処理
+}
+
+export async function cleanup{SeedName}(client: SupabaseClient): Promise<void> {
+  // DELETE処理
+}
+```
+
+---
+
+## Repository テストテンプレート
+
+### ファイル: `{repository}.test.ts`
+
+```typescript
+import { describe, it, expect, beforeAll, afterEach } from 'vitest';
+import { target, context } from '../../helpers/common-helper.js';
+import { getTestClient, cleanupTestData } from '../../helpers/supabase-test-helper.js';
+import { {Repository} } from '../../../src/{context}/infrastructure/repositories/{repository}.js';
+
+target('{Repository}', () => {
+  let repository: {Repository};
+  const idsToCleanup: string[] = [];
+
+  beforeAll(() => {
+    repository = new {Repository}(getTestClient());
+  });
+
+  afterEach(async () => {
+    for (const id of idsToCleanup) {
+      await cleanupTestData(id);
+    }
+    idsToCleanup.length = 0;
+  });
+
+  // IT-REPO-{Name}-001: 保存テスト
+  describe('save', () => {
+    context('新規エンティティを保存する場合', () => {
+      it('DBに永続化される', async () => {
+        // Arrange
+        const entity = create{Entity}({
+          // テストデータ
+        });
+        idsToCleanup.push(entity.id);
+
+        // Act
+        await repository.save(entity);
+
+        // Assert — DBから直接確認
+        const client = getTestClient();
+        const { data: row } = await client
+          .from('{table_name}')
+          .select('*')
+          .eq('id', entity.id)
+          .single();
+
+        expect(row).not.toBeNull();
+        expect(row!.{column}).toBe({expectedValue});
+      });
+    });
+  });
+
+  // IT-REPO-{Name}-002: 取得テスト
+  describe('findById', () => {
+    context('存在するIDで取得する場合', () => {
+      it('エンティティが再構築される', async () => {
+        // Arrange
+        const entity = create{Entity}({ /* ... */ });
+        await repository.save(entity);
+        idsToCleanup.push(entity.id);
+
+        // Act
+        const actual = await repository.findById(entity.id);
+
+        // Assert
+        expect(actual).not.toBeNull();
+        expect(actual!.id).toBe(entity.id);
+        expect(actual!.{property}).toBe({expectedValue});
+      });
+    });
+
+    context('存在しないIDで取得する場合', () => {
+      it('nullが返される', async () => {
+        // Act
+        const actual = await repository.findById(to{Entity}Id('non-existent-id'));
+
+        // Assert
+        expect(actual).toBeNull();
+      });
+    });
+  });
+
+  // IT-REPO-{Name}-003: 更新テスト
+  describe('update', () => {
+    it('既存エンティティが更新される', async () => {
+      // Arrange
+      const entity = create{Entity}({ /* 初期値 */ });
+      await repository.save(entity);
+      idsToCleanup.push(entity.id);
+
+      // Act
+      entity.updateXxx({newValue});
+      await repository.save(entity);
+
+      // Assert
+      const actual = await repository.findById(entity.id);
+      expect(actual!.{property}).toBe({newValue});
+    });
+  });
+});
+```
+
+---
+
+## トランザクション・クリーンアップ戦略
+
+### クリーンアップパターン
+
+```typescript
+// テスト毎にクリーンアップ
+afterEach(async () => {
+  for (const id of idsToCleanup) {
+    await cleanupTestData(id);
+  }
+  idsToCleanup.length = 0;
+});
+```
+
+### トランザクション分離
+
+```typescript
+// トランザクション内でテスト実行（ロールバック）
+describe('トランザクションテスト', () => {
+  it('エラー時にロールバックされる', async () => {
+    // Arrange
+    const client = getTestClient();
+
+    // Act
+    try {
+      await client.rpc('test_transaction', { /* ... */ });
+    } catch (e) {
+      // Expected error
+    }
+
+    // Assert — ロールバックされていることを確認
+    const { data } = await client.from('{table}').select('*');
+    expect(data).toHaveLength(0);
+  });
+});
+```
+
+### DB直接確認パターン
+
+```typescript
+// Assert — DBから直接確認
+const client = getTestClient();
+const { data: row } = await client
+  .from('{table}')
+  .select('*')
+  .eq('id', entity.id)
+  .single();
+expect(row).not.toBeNull();
+```
+
+## テスト実行コマンド
+
+```bash
+# 全ITテスト実行
+pnpm --filter backend test:integration
+
+# 特定ファイルのみ
+pnpm --filter backend test:integration -- {repository}.test.ts
+
+# watchモード
+pnpm --filter backend test:integration -- --watch
+```

package/skills/it-test-logic-designer/references/usecase-test-patterns.md

@@ -0,0 +1,87 @@
+# UseCase テストパターン・テンプレート
+
+本ファイルは `it-test-logic-designer` スキルで使用するUseCaseレイヤーのテストテンプレート集。
+
+---
+
+## UseCase テストテンプレート
+
+### ファイル: `{usecase}.test.ts`
+
+```typescript
+import { describe, it, expect, beforeEach, vi } from 'vitest';
+import { target, context } from '../../helpers/common-helper.js';
+import { {UseCase} } from '../../../src/{context}/application/usecases/{usecase}.js';
+import { {Repository}Port } from '../../../src/{context}/application/ports/{repository}-port.js';
+
+target('{UseCase}', () => {
+  let useCase: {UseCase};
+  let mockRepository: {Repository}Port;
+
+  beforeEach(() => {
+    // モックRepository作成
+    mockRepository = {
+      save: vi.fn(),
+      findById: vi.fn(),
+      // ...
+    };
+    useCase = new {UseCase}(mockRepository);
+  });
+
+  // IT-UC-{Name}-001: 正常系
+  describe('execute', () => {
+    context('有効な入力の場合', () => {
+      it('処理が成功し結果が返される', async () => {
+        // Arrange
+        const input = {
+          // UseCaseへの入力
+        };
+        mockRepository.findById.mockResolvedValue(create{Entity}({}));
+
+        // Act
+        const actual = await useCase.execute(input);
+
+        // Assert
+        expect(actual.isSuccess()).toBe(true);
+        expect(actual.value.{property}).toBe({expectedValue});
+        expect(mockRepository.save).toHaveBeenCalledWith(
+          expect.objectContaining({ /* 期待されるエンティティ */ })
+        );
+      });
+    });
+
+    // IT-UC-{Name}-002: 異常系（バリデーションエラー）
+    context('無効な入力の場合', () => {
+      it('バリデーションエラーが返される', async () => {
+        // Arrange
+        const invalidInput = {
+          // 無効な入力
+        };
+
+        // Act
+        const actual = await useCase.execute(invalidInput);
+
+        // Assert
+        expect(actual.isFailure()).toBe(true);
+        expect(actual.error.code).toBe('{ERROR_CODE}');
+      });
+    });
+
+    // IT-UC-{Name}-003: 異常系（リソース不存在）
+    context('対象リソースが存在しない場合', () => {
+      it('NotFoundエラーが返される', async () => {
+        // Arrange
+        mockRepository.findById.mockResolvedValue(null);
+        const input = { id: 'non-existent-id' };
+
+        // Act
+        const actual = await useCase.execute(input);
+
+        // Assert
+        expect(actual.isFailure()).toBe(true);
+        expect(actual.error.code).toBe('NOT_FOUND');
+      });
+    });
+  });
+});
+```

package/skills/pointer-validator/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: pointer-validator
-description: 設計文書内のファイルポインタ（相対パス参照）の有効性を検証するスキル（L4バリデータ拡張）。`p2:validate-pointers` CLIを使い、ドキュメント内で参照されているファイルパスが実際に存在するかチェックする。使用タイミング: 「ドキュメントのリンク切れを確認して」「ポインタ検証を実行して」「broken pointer を探して」「設計文書の参照が正しいか確認して」など。
+description: 設計文書内のファイルポインタ（相対パス参照）の有効性を検証するスキル（L4バリデータ拡張）。`phasegate validate-pointers` CLIを使い、ドキュメント内で参照されているファイルパスが実際に存在するかチェックする。使用タイミング: 「ドキュメントのリンク切れを確認して」「ポインタ検証を実行して」「broken pointer を探して」「設計文書の参照が正しいか確認して」など。
 model: sonnet
 review: opus
 ---
@@ -8,7 +8,7 @@ review: opus
 # Pointer Validator
 
 設計文書内のファイルパス参照（ポインタ）の有効性を検証するスキル。
-`phase2-extensions` Unit の `p2:validate-pointers` CLIをラップし、broken pointer を検出・修正案を提示する。
+`phasegate validate-pointers` CLIをラップし、broken pointer を検出・修正案を提示する。
 
 ## CLIの動作
 
@@ -27,7 +27,7 @@ review: opus
 ### Step 1: CLIの実行
 
 ```bash
-pnpm run p2:validate-pointers
+npx phasegate validate-pointers
 ```
 
 オプション:
@@ -75,7 +75,7 @@ pnpm run p2:validate-pointers
 ## 次のアクション
 （brokenがある場合）
 1. 上記テーブルの broken pointer を修正
-2. `pnpm run p2:validate-pointers` を再実行して0件を確認
+2. `npx phasegate validate-pointers` を再実行して0件を確認
 ```
 
 ---

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

@@ -112,37 +112,9 @@ story-implementor ← TDD実装
 
 ### 計画ファイルの構成
 
-```markdown
-# シナリオテスト設計計画: {ストーリーID}
-
-## 1. スコープ
-- 対象ストーリーと受け入れ基準
-- テスト対象の画面・機能
-
-## 2. テストシナリオ概要（ドラフト）
-| シナリオID | シナリオ名 | 検証観点 |
-|-----------|----------|---------|
-
-## 3. 前提条件
-- 必要なテストデータ
-- 認証状態・権限
-
-## 4. テスト実行環境
-- 使用するテストフレームワーク（Playwright等）
-- データセットアップ方針
-
-## 5. QA（不明点・確認事項）
+詳細なテンプレートは [references/scenario-test-plan-template.md](references/scenario-test-plan-template.md) を参照。
 
-### [Question] Q1: {質問タイトル}
-{質問の詳細と背景}
-**推奨案:** {AIの推奨案}
-
-[Answer]
-（人間が回答を記入）
-
-## 6. 前提条件・リスク
-- ...
-```
+主要セクション: スコープ / テストシナリオ概要 / 前提条件 / テスト実行環境 / QA（不明点） / 前提条件・リスク
 
 ### Phase 1 完了条件
 - 計画ファイルを出力した
@@ -186,45 +158,9 @@ story-implementor ← TDD実装
 
 ### scenario_test_design.md の構成
 
-```markdown
-# シナリオテスト設計: {ストーリーID}
-
-## 1. 対象ストーリー
-- ストーリーID: {story_id}
-- 概要: {ストーリー概要}
-- 受け入れ基準: ...
+詳細なテンプレートは [references/scenario-test-design-template.md](references/scenario-test-design-template.md) を参照。
 
-## 2. テストシナリオ
-
-### SC-001: {シナリオ名}
-
-#### 前提条件
-- ...
-
-#### テストステップ
-| # | 操作 | 期待結果 |
-|---|------|---------|
-| 1 | ... | ... |
-
-#### 検証ポイント
-- ...
-
-### SC-002: ...
-
-## 3. テストデータ要件
-- 必要なシードデータ
-- テストユーザー定義
-
-## 4. 異常系・エッジケース
-| ケースID | 概要 | 入力条件 | 期待結果 |
-|---------|------|---------|---------|
-
-## 5. 実装時の注意点
-- data-testid命名規約
-- 非同期処理の待機方法
-```
-
----
+主要セクション: 対象ストーリー / テストシナリオ（SC-XXX） / テストデータ要件 / 異常系・エッジケース / 実装時の注意点
 
 ---
 

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

@@ -0,0 +1,41 @@
+# scenario_test_design.md テンプレート
+
+Phase 2 の成果物として出力する `docs/inception/{unit}/{story_id}/scenario_test_design.md` の構成テンプレート。
+
+```markdown
+# シナリオテスト設計: {ストーリーID}
+
+## 1. 対象ストーリー
+- ストーリーID: {story_id}
+- 概要: {ストーリー概要}
+- 受け入れ基準: ...
+
+## 2. テストシナリオ
+
+### SC-001: {シナリオ名}
+
+#### 前提条件
+- ...
+
+#### テストステップ
+| # | 操作 | 期待結果 |
+|---|------|---------|
+| 1 | ... | ... |
+
+#### 検証ポイント
+- ...
+
+### SC-002: ...
+
+## 3. テストデータ要件
+- 必要なシードデータ
+- テストユーザー定義
+
+## 4. 異常系・エッジケース
+| ケースID | 概要 | 入力条件 | 期待結果 |
+|---------|------|---------|---------|
+
+## 5. 実装時の注意点
+- data-testid命名規約
+- 非同期処理の待機方法
+```

package/skills/scenario-test-designer/references/scenario-test-plan-template.md

@@ -0,0 +1,35 @@
+# scenario_test_plan.md テンプレート
+
+Phase 1 の成果物として出力する `docs/inception/{unit}/{story_id}/scenario_test_plan.md` の構成テンプレート。
+
+```markdown
+# シナリオテスト設計計画: {ストーリーID}
+
+## 1. スコープ
+- 対象ストーリーと受け入れ基準
+- テスト対象の画面・機能
+
+## 2. テストシナリオ概要（ドラフト）
+| シナリオID | シナリオ名 | 検証観点 |
+|-----------|----------|---------|
+
+## 3. 前提条件
+- 必要なテストデータ
+- 認証状態・権限
+
+## 4. テスト実行環境
+- 使用するテストフレームワーク（Playwright等）
+- データセットアップ方針
+
+## 5. QA（不明点・確認事項）
+
+### [Question] Q1: {質問タイトル}
+{質問の詳細と背景}
+**推奨案:** {AIの推奨案}
+
+[Answer]
+（人間が回答を記入）
+
+## 6. 前提条件・リスク
+- ...
+```