Imported from majiayu000/claude-skill-registry (skills/testing/test-architecture-d-kishi-ubiquitous-lang-mng-960bcb52/SKILL.md). Install upstream with npx skills add majiayu000/claude-skill-registry --skill test-architecture-d-kishi-ubiquitous-lang-mng-960bcb52. Copyright stays with the author.

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（厳守）
  - ビルド時間最小化（不要な参照削除）

参照元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教訓

About

Test Architecture Skill

概要

使用タイミング

1. 新規テストプロジェクト作成時（最重要）

2. unit-test/integration-test Agent作業開始時

3. テストアーキテクチャ違反検出時

ADR_020テストアーキテクチャ決定（重要ポイント）

レイヤー×テストタイプ分離方式

参照関係原則（ADR_020準拠）

Unit Tests参照関係

Integration Tests参照関係

E2E Tests参照関係

新規テストプロジェクト作成チェックリスト

事前確認チェックリスト

プロジェクト作成チェックリスト

ビルド・実行確認チェックリスト

Issue #40再発防止チェックリスト

テストアーキテクチャ適用パターン

Pattern 1: Domain層Unit Tests作成

Pattern 2: Infrastructure層Integration Tests作成

Pattern 3: Web層E2E Tests作成

テストアーキテクチャ違反検出・修正パターン

違反例1: 命名規則違反

違反例2: 参照関係違反

違反例3: レイヤー混在

言語選択原則

レイヤー別言語選択

SDK選択原則

NuGetパッケージ標準セット

F# Unit Tests標準パッケージ

C# Unit Tests標準パッケージ

Integration Tests標準パッケージ

E2E Tests（Playwright）標準パッケージ

品質目標

テストカバレッジ目標

ビルド品質目標

関連Skills

参照元ADR・Rules

Use it

Manifest

Reviews