majiayu000 Test Architecture Skill
概要
このSkillは、ADR_020テストアーキテクチャ決定に基づくレイヤー×テストタイプ分離方式の自律的適用を提供します。新規テストプロジェクト作成時の必須確認事項・命名規則・参照関係原則・Issue #40再発防止策を組み込み、unit-test/integration-test Agent作業時の品質保証を実現します。
使用タイミング
Claudeは以下の状況でこのSkillを自律的に使用すべきです：
1. 新規テストプロジェクト作成時（最重要）
タイミング:
- unit-test/integration-test Agent選択時
- 新規テストプロジェクト作成指示を受けた時
- tests/配下に新規ディレクトリ・プロジェクトファイル作成前
必須確認事項:
- ADR_020テストアーキテクチャ決定確認
- テストアーキテクチャ設計書確認（プロジェクト構成図・命名規則・参照関係原則）
- 新規プロジェクト作成チェックリスト実行
- 命名規則厳守（
UbiquitousLanguageManager.{Layer}.{TestType}.Tests） - 参照関係原則遵守
2. unit-test/integration-test Agent作業開始時
タイミング:
- SubAgent組み合わせパターン選択時
- TDD Red-Green-Refactorサイクル開始時
- テスト実装作業開始時
必須確認事項:
- 既存テストプロジェクト構成確認
- テストタイプ別参照関係確認
- テストカバレッジ目標確認（97%）
3. テストアーキテクチャ違反検出時
タイミング:
- ビルドエラー発生時（参照関係違反）
- 命名規則違反検出時
- レイヤー混在・テストタイプ混在検出時
必須確認事項:
- Issue #40類似問題の再発防止チェック
- ADR_020準拠性確認
- テストアーキテクチャ設計書との整合性確認
ADR_020テストアーキテクチャ決定（重要ポイント）
レイヤー×テストタイプ分離方式
原則: 1プロジェクト = 1レイヤー × 1テストタイプ
テストプロジェクト命名規則（厳守）:
UbiquitousLanguageManager.{Layer}.{TestType}.Tests
例:
- UbiquitousLanguageManager.Domain.Unit.Tests
- UbiquitousLanguageManager.Application.Integration.Tests
- UbiquitousLanguageManager.Web.E2E.Tests
Layer選択:
- Domain: ドメインモデル・Value Objects・Domain Services
- Application: Use Cases・Application Services
- Contracts: DTOs・Type Converters（F#↔C#境界）
- Infrastructure: Repositories・EF Core・外部連携
- Web: Blazor Components・Pages・Web Services
TestType選択:
- Unit: 単体テスト（テスト対象レイヤーのみ参照）
- Integration: 統合テスト（複数レイヤー・DB・外部連携）
- UI: UIコンポーネントテスト（Blazor bUnit使用）
- E2E: エンドツーエンドテスト（Playwright使用）
参照関係原則（ADR_020準拠）
Unit Tests参照関係
原則: テスト対象レイヤーのみ参照（最小化原則）
Domain.Unit.Tests（F#）:
<ItemGroup>
<!-- ADR_020準拠: Unit Tests原則 - テスト対象レイヤーのみ参照 -->
<ProjectReference Include="..\..\src\UbiquitousLanguageManager.Domain\UbiquitousLanguageManager.Domain.fsproj" />
</ItemGroup>
Application.Unit.Tests（F#）:
<ItemGroup>
<!-- Application層はDomain層に依存するため、両方参照 -->
<ProjectReference Include="..\..\src\UbiquitousLanguageManager.Application\UbiquitousLanguageManager.Application.fsproj" />
<ProjectReference Include="..\..\src\UbiquitousLanguageManager.Domain\UbiquitousLanguageManager.Domain.fsproj" />
</ItemGroup>
Contracts.Unit.Tests（C#）:
<ItemGroup>
<!-- Contracts層はApplication・Domain層に依存するため、3層参照 -->
<ProjectReference Include="..\..\src\UbiquitousLanguageManager.Contracts\UbiquitousLanguageManager.Contracts.csproj" />
<ProjectReference Include="..\..\src\UbiquitousLanguageManager.Application\UbiquitousLanguageManager.Application.fsproj" />
<ProjectReference Include="..\..\src\UbiquitousLanguageManager.Domain\UbiquitousLanguageManager.Domain.fsproj" />
</ItemGroup>
Integration Tests参照関係
原則: 必要な依存層のみ参照（WebApplicationFactory使用時は全層参照）
Infrastructure.Integration.Tests（C#）:
<ItemGroup>
<!-- 統合テスト: 全層参照（WebApplicationFactory使用のため） -->
<ProjectReference Include="..\..\src\UbiquitousLanguageManager.Infrastructure\UbiquitousLanguageManager.Infrastructure.csproj" />
<ProjectReference Include="..\..\src\UbiquitousLanguageManager.Application\UbiquitousLanguageManager.Application.fsproj" />
<ProjectReference Include="..\..\src\UbiquitousLanguageManager.Domain\UbiquitousLanguageManager.Domain.fsproj" />
<ProjectReference Include="..\..\src\UbiquitousLanguageManager.Web\UbiquitousLanguageManager.Web.csproj" />
<ProjectReference Include="..\..\src\UbiquitousLanguageManager.Contracts\UbiquitousLanguageManager.Contracts.csproj" />
</ItemGroup>
E2E Tests参照関係
原則: 全層参照可・Playwright使用
Web.E2E.Tests（C#）:
<ItemGroup>
<!-- E2Eテスト: 全層参照 -->
<ProjectReference Include="..\..\src\UbiquitousLanguageManager.Web\UbiquitousLanguageManager.Web.csproj" />
<ProjectReference Include="..\..\src\UbiquitousLanguageManager.Infrastructure\UbiquitousLanguageManager.Infrastructure.csproj" />
<ProjectReference Include="..\..\src\UbiquitousLanguageManager.Application\UbiquitousLanguageManager.Application.fsproj" />
<ProjectReference Include="..\..\src\UbiquitousLanguageManager.Domain\UbiquitousLanguageManager.Domain.fsproj" />
<ProjectReference Include="..\..\src\UbiquitousLanguageManager.Contracts\UbiquitousLanguageManager.Contracts.csproj" />
</ItemGroup>
新規テストプロジェクト作成チェックリスト
事前確認チェックリスト
新規テストプロジェクト作成前に以下を必ず確認すること:
- ADR_020テストアーキテクチャ決定確認:
/Doc/07_Decisions/ADR_020_テストアーキテクチャ決定.md - テストアーキテクチャ設計書確認:
/Doc/02_Design/テストアーキテクチャ設計書.md - 新規プロジェクト作成ガイドライン確認:
/Doc/08_Organization/Rules/新規テストプロジェクト作成ガイドライン.md - 既存テストプロジェクトとの重複確認: 同一レイヤー・同一テストタイプのプロジェクト存在確認
- レイヤー・テストタイプの分類明確化: Layer（Domain/Application/Contracts/Infrastructure/Web）とTestType（Unit/Integration/UI/E2E）の明確化
プロジェクト作成チェックリスト
詳細: rules/new-test-project-checklist.md
- プロジェクト作成コマンド実行: F#（
dotnet new xunit -lang F#）またはC#（dotnet new xunit） - 命名規則確認:
UbiquitousLanguageManager.{Layer}.{TestType}.Tests - 言語・SDK選択確認: レイヤー別言語原則（Domain/Application=F#, Contracts/Infrastructure/Web=C#）
- 参照関係設定: ADR_020参照関係原則に準拠
- NuGetパッケージ追加: テストタイプ別標準パッケージ追加
ビルド・実行確認チェックリスト
- ソリューションファイル更新:
dotnet sln add tests/{ProjectName} - ソリューション一覧確認:
dotnet sln listで新規プロジェクト確認 - 新規プロジェクト個別ビルド成功:
dotnet build tests/{ProjectName}（0 Warning/0 Error） - ソリューション全体ビルド成功:
dotnet build（既存プロジェクトへの影響なし） - 新規プロジェクト個別テスト実行成功:
dotnet test tests/{ProjectName} - ソリューション全体テスト実行成功:
dotnet test（既存テスト100%維持）
Issue #40再発防止チェックリスト
Issue #40教訓: テストアーキテクチャ再構成（7プロジェクト分割）
- EnableDefaultCompileItems=false設定禁止: .csproj/.fsprojに存在しないこと確認
- F#/C#混在回避: F#プロジェクトにC#ファイルを含めない
- テストタイプ混在回避: 1プロジェクト内に複数テストタイプを混在させない
- レイヤー混在回避: 1プロジェクト内に複数レイヤーのテストを混在させない
- レイヤー別分離確認: 1プロジェクト = 1レイヤー × 1テストタイプ
- 参照関係最小化: Unit Testsはテスト対象レイヤーのみ参照
- 命名規則準拠:
{ProjectName}.{Layer}.{TestType}.Tests形式厳守
テストアーキテクチャ適用パターン
Pattern 1: Domain層Unit Tests作成
シナリオ: Domain層（F#）の単体テスト作成
Step-by-Step:
- 事前確認: ADR_020 + テストアーキテクチャ設計書確認
- プロジェクト作成:
dotnet new xunit -lang F# -n UbiquitousLanguageManager.Domain.Unit.Tests -o tests/UbiquitousLanguageManager.Domain.Unit.Tests - 命名規則確認:
UbiquitousLanguageManager.Domain.Unit.Tests - 参照関係設定: Domain層のみ参照
- NuGetパッケージ追加: xunit + FsUnit.xUnit + coverlet.collector
- ビルド確認:
dotnet build tests/UbiquitousLanguageManager.Domain.Unit.Tests - ソリューション追加:
dotnet sln add tests/UbiquitousLanguageManager.Domain.Unit.Tests
詳細: rules/test-project-naming-convention.md
Pattern 2: Infrastructure層Integration Tests作成
シナリオ: Infrastructure層（C#）の統合テスト作成
Step-by-Step:
- 事前確認: ADR_020 + テストアーキテクチャ設計書確認
- プロジェクト作成:
dotnet new xunit -n UbiquitousLanguageManager.Infrastructure.Integration.Tests -o tests/UbiquitousLanguageManager.Infrastructure.Integration.Tests - 命名規則確認:
UbiquitousLanguageManager.Infrastructure.Integration.Tests - 参照関係設定: 全層参照（WebApplicationFactory使用）
- NuGetパッケージ追加: xunit + Microsoft.AspNetCore.Mvc.Testing + Testcontainers.PostgreSql
- ビルド確認:
dotnet build tests/UbiquitousLanguageManager.Infrastructure.Integration.Tests - ソリューション追加:
dotnet sln add tests/UbiquitousLanguageManager.Infrastructure.Integration.Tests
詳細: rules/test-project-reference-rules.md
Pattern 3: Web層E2E Tests作成
シナリオ: Web層（C#）のE2Eテスト作成（Playwright使用）
Step-by-Step:
- 事前確認: ADR_020 + テストアーキテクチャ設計書 + Playwright MCP確認
- プロジェクト作成:
dotnet new xunit -n UbiquitousLanguageManager.Web.E2E.Tests -o tests/UbiquitousLanguageManager.Web.E2E.Tests - 命名規則確認:
UbiquitousLanguageManager.Web.E2E.Tests - 参照関係設定: 全層参照
- NuGetパッケージ追加: xunit + Microsoft.Playwright + Microsoft.AspNetCore.Mvc.Testing
- Playwright MCP統合: data-testid属性設計
- ビルド確認:
dotnet build tests/UbiquitousLanguageManager.Web.E2E.Tests - ソリューション追加:
dotnet sln add tests/UbiquitousLanguageManager.Web.E2E.Tests
詳細: rules/new-test-project-checklist.md
テストアーキテクチャ違反検出・修正パターン
違反例1: 命名規則違反
検出:
❌ UbiquitousLanguageManager.DomainTests
❌ UbiquitousLanguageManager.Tests
❌ Domain.Unit.Tests
修正:
✅ UbiquitousLanguageManager.Domain.Unit.Tests
理由: ADR_020命名規則 {ProjectName}.{Layer}.{TestType}.Tests 厳守
違反例2: 参照関係違反
検出:
<!-- Domain.Unit.Tests が Application層を参照（違反） -->
<ItemGroup>
<ProjectReference Include="..\..\src\UbiquitousLanguageManager.Domain\UbiquitousLanguageManager.Domain.fsproj" />
<ProjectReference Include="..\..\src\UbiquitousLanguageManager.Application\UbiquitousLanguageManager.Application.fsproj" />
</ItemGroup>
修正:
<!-- Domain.Unit.Tests は Domain層のみ参照 -->
<ItemGroup>
<ProjectReference Include="..\..\src\UbiquitousLanguageManager.Domain\UbiquitousLanguageManager.Domain.fsproj" />
</ItemGroup>
理由: ADR_020参照関係原則（Unit Testsはテスト対象レイヤーのみ参照）
違反例3: レイヤー混在
検出:
tests/UbiquitousLanguageManager.Domain.Unit.Tests/
├── DomainTests/ （Domain層テスト）
└── ApplicationTests/ （Application層テスト・混在）
修正:
tests/UbiquitousLanguageManager.Domain.Unit.Tests/
└── DomainTests/ （Domain層テストのみ）
tests/UbiquitousLanguageManager.Application.Unit.Tests/
└── ApplicationTests/ （Application層テスト）
理由: 1プロジェクト = 1レイヤー × 1テストタイプ原則
言語選択原則
レイヤー別言語選択
| Layer | 言語 | 理由 |
|---|---|---|
| Domain | F# | ドメインロジックはF#で実装 |
| Application | F# | ユースケースはF#で実装 |
| Contracts | C# | DTOs・Type ConvertersはC#で実装 |
| Infrastructure | C# | EF Core・RepositoriesはC#で実装 |
| Web | C# | Blazor ServerはC#で実装 |
SDK選択原則
| TestType | SDK | 理由 |
|---|---|---|
| Unit | Microsoft.NET.Sdk |
標準テスト（デフォルト） |
| Integration | Microsoft.NET.Sdk |
標準テスト |
| UI (bUnit) | Microsoft.NET.Sdk.Razor |
Blazor Componentテストのため必須 |
| E2E (Playwright) | Microsoft.NET.Sdk |
標準テスト |
NuGetパッケージ標準セット
F# Unit Tests標準パッケージ
dotnet add package xunit
dotnet add package xunit.runner.visualstudio
dotnet add package Microsoft.NET.Test.Sdk
dotnet add package FsUnit.xUnit
dotnet add package coverlet.collector
C# Unit Tests標準パッケージ
dotnet add package xunit
dotnet add package xunit.runner.visualstudio
dotnet add package Microsoft.NET.Test.Sdk
dotnet add package FluentAssertions
dotnet add package Moq
dotnet add package coverlet.collector
Integration Tests標準パッケージ
dotnet add package Microsoft.AspNetCore.Mvc.Testing
dotnet add package Microsoft.EntityFrameworkCore.InMemory
dotnet add package Testcontainers.PostgreSql
E2E Tests（Playwright）標準パッケージ
dotnet add package Microsoft.Playwright
dotnet add package Microsoft.AspNetCore.Mvc.Testing
品質目標
テストカバレッジ目標
目標カバレッジ:
- 単体テスト: 97%以上（Phase B1達成実績）
- 統合テスト: 85%以上（Phase B2達成実績）
測定方法:
- dotnet test --collect:"XPlat Code Coverage"
ビルド品質目標
目標品質:
- 0 Warning / 0 Error（厳守）
- ビルド時間最小化（不要な参照削除）
関連Skills
- tdd-red-green-refactor Skill: TDD実践パターン（unit-test Agent活用）
- playwright-e2e-patterns Skill: Playwright MCP活用E2Eテスト作成パターン
- subagent-patterns Skill: unit-test/integration-test Agent組み合わせパターン
- clean-architecture-guardian Skill: Clean Architecture準拠性チェック
参照元ADR・Rules
- ADR_020:
/Doc/07_Decisions/ADR_020_テストアーキテクチャ決定.md- レイヤー×テストタイプ分離方式決定 - 新規テストプロジェクト作成ガイドライン:
/Doc/08_Organization/Rules/新規テストプロジェクト作成ガイドライン.md- 詳細手順・チェックリスト - テストアーキテクチャ設計書:
/Doc/02_Design/テストアーキテクチャ設計書.md- プロジェクト構成図・参照関係
作成日: 2025-11-01 Phase B-F2 Step2: Agent Skills Phase 2展開 参照: ADR_020, 新規テストプロジェクト作成ガイドライン, Issue #40教訓