Subagent Patterns

SubAgent Patterns Skill

概要

このSkillは、Phase・Step特性に応じた最適なSubAgent組み合わせを選択するためのパターン・判断基準・責務境界を提供します。ADR_013 SubAgentプール方式に基づく14種類のAgentの効果的な活用方法を定義します。

使用タイミング

Claudeは以下の状況でこのSkillを自律的に使用すべきです：

1. Step開始時（最重要）

   • step-start Command実行時
   • SubAgent組み合わせ選択時
   • 並列実行可能性判断時

2. SubAgent選択迷い時

   • 複数のAgentが候補になる時
   • 責務境界が不明確な時
   • 並列実行判断が必要な時

3. エラー修正時

   • Fix-Mode活用時のSubAgent選択
   • 責務に応じたAgent委託判断

4. Phase計画時

   • Phase開始時のSubAgent構成検討
   • Step間のAgent引継ぎ計画

SubAgentプール（14種類）

調査分析系（4Agent）

詳細: patterns/research-agents-selection.md

1. tech-research: 技術調査・最新情報収集・ベストプラクティス調査
2. spec-analysis: 仕様分析・要件抽出・仕様準拠マトリックス作成
3. design-review: 設計整合性確認・Clean Architecture準拠確認
4. dependency-analysis: 依存関係特定・実装順序決定・制約リスク分析

実装系（5Agent）

詳細: patterns/implementation-agents-selection.md

1. fsharp-domain: F#ドメインモデル・ビジネスロジック実装
2. fsharp-application: F#アプリケーションサービス・ユースケース実装
3. contracts-bridge: F#↔C#型変換・TypeConverter実装（境界重要）
4. csharp-infrastructure: Repository・Entity Framework・外部サービス連携
5. csharp-web-ui: Blazor Server・Razor・フロントエンドUI実装

品質保証系（5Agent）

詳細: patterns/qa-agents-selection.md

1. unit-test: TDD実践・単体テスト設計実装・Red-Green-Refactorサイクル
2. integration-test: WebApplicationFactory統合テスト・データベース統合テスト（Infrastructure.Integration.Tests専任）
3. e2e-test: Playwright E2Eテスト実装・UIインタラクション・エンドツーエンドシナリオテスト（E2E.Tests専任・playwright-e2e-patterns Skill活用・Playwright MCP 21ツール）
   • Playwright Test Agents統合: MainAgentオーケストレーション型（パターンA/B）
   • パターンA: MainAgent → playwright-test-generator → e2e-test → playwright-test-healer（該当時）
   • パターンB: MainAgent → e2e-test（既存テストメンテナンス）
4. code-review: コード品質・保守性・Clean Architecture準拠・パフォーマンス・セキュリティレビュー
5. spec-compliance: 仕様準拠監査・受け入れ基準確認・仕様準拠マトリックス検証

SubAgent責務境界判定

詳細: rules/agent-responsibility-boundary.md

実装系Agent責務境界（重要）

fsharp-domain

✅ 実行範囲:

• src/UbiquitousLanguageManager.Domain/ 配下のみ
• ValueObjects.fs, Entities.fs, DomainServices.fs 実装
• F#ドメインモデル・ビジネスロジック実装

❌ 禁止範囲:

• tests/ 配下のファイル読み込み・参照
• テスト実装・TDD実践（unit-testの責務）
• Contracts層・Infrastructure層・Web層への言及

fsharp-application

✅ 実行範囲:

• src/UbiquitousLanguageManager.Application/ 配下のみ
• UseCase・ApplicationService実装

❌ 禁止範囲:

• tests/ 配下のファイル読み込み・参照
• Domain層・Infrastructure層の実装修正

contracts-bridge

✅ 実行範囲:

• src/UbiquitousLanguageManager.Contracts/ 配下のみ
• DTO・TypeConverter・F#↔C#境界実装

❌ 禁止範囲:

• Domain層・Application層の実装修正
• テストプロジェクトへの参照

csharp-infrastructure

✅ 実行範囲:

• src/UbiquitousLanguageManager.Infrastructure/ 配下のみ
• Repository・Entity Framework・外部サービス連携

❌ 禁止範囲:

• Domain層・Application層の実装修正

csharp-web-ui

✅ 実行範囲:

• src/UbiquitousLanguageManager.Web/ 配下のみ
• Blazor Server・Razor・フロントエンドUI

❌ 禁止範囲:

• 他層の実装修正

品質保証系Agent責務境界

unit-test

✅ 実行範囲:

• tests/ 配下のすべてのテストプロジェクト
• TDD実践・Red-Green-Refactorサイクル
• テスト実装・既存テスト修正

❌ 禁止範囲:

• src/ 配下の実装コード修正（テスト対象の修正禁止）

integration-test

✅ 実行範囲:

• tests/Infrastructure.Integration.Tests/ 専任
• WebApplicationFactory統合テスト・データベース統合テスト
• Testcontainers.PostgreSql使用テスト

❌ 禁止範囲:

• src/ 配下の実装コード修正
• tests/E2E.Tests/ 配下の実装（e2e-test Agentの責務）

e2e-test

✅ 実行範囲:

• tests/E2E.Tests/ 専任
• Playwright E2Eテスト実装・実行・検証
• UIインタラクション・エンドツーエンドシナリオテスト
• playwright-e2e-patterns Skill活用（data-testid/MCP/SignalR）
• Playwright MCP 21ツール直接使用
• 重要: Playwright Test Agents統合はMainAgentが調整（本Agentは実行・検証担当）

❌ 禁止範囲:

• src/ 配下の実装コード修正（テスト対象の修正禁止）
• tests/Infrastructure.Integration.Tests/ 配下の実装（integration-test Agentの責務）
• Playwright Test Agentsの直接呼び出し（SubAgent間呼び出し不可・MainAgent責務）

code-review

✅ 実行範囲:

• 全プロジェクトの読み込み・品質評価
• Clean Architecture準拠・コード品質確認

❌ 禁止範囲:

• 実装コードの直接修正（改善提案のみ）

spec-compliance

✅ 実行範囲:

• 仕様書・実装コードの照合確認
• 仕様準拠マトリックス検証

❌ 禁止範囲:

• 実装コードの直接修正（準拠度評価のみ）

Phase特性別組み合わせパターン

詳細: patterns/phase-specific-combinations.md

Pattern A: 新機能実装Phase

特徴: 新規ドメインモデル・ユースケース実装

推奨組み合わせ:

Step1: spec-analysis (仕様分析)
Step2: design-review (設計確認)
Step3: fsharp-domain + unit-test (並列)
Step4: fsharp-application + unit-test (並列)
Step5: contracts-bridge (F#↔C#境界)
Step6: csharp-infrastructure + integration-test (並列)
Step7: csharp-web-ui + integration-test (並列)
Step8: code-review + spec-compliance (並列)

Pattern B: 技術基盤整備Phase

特徴: アーキテクチャ改善・技術負債解決

推奨組み合わせ:

Step1: tech-research + dependency-analysis (並列)
Step2: design-review (設計確認)
Step3: 該当層Agent + unit-test (並列)
Step4: integration-test (統合テスト)
Step5: code-review (品質確認)

Pattern C: テスト強化Phase

特徴: テストカバレッジ向上・E2Eテスト実装

推奨組み合わせ:

Step1: spec-analysis (テスト要件分析)
Step2: unit-test (単体テスト拡充)
Step3: integration-test (統合テスト拡充)
Step4: e2e-test (E2Eテスト実装・playwright-e2e-patterns Skill活用)
Step5: code-review (テスト品質確認)

並列実行判断ロジック

並列実行可能な組み合わせ

実装系 + テスト系:

✅ fsharp-domain + unit-test (並列可能)
✅ fsharp-application + unit-test (並列可能)
✅ csharp-infrastructure + integration-test (並列可能)
✅ csharp-web-ui + integration-test (並列可能)

理由: テスト系Agentは tests/ 配下、実装系Agentは src/ 配下で責務が分離

品質保証系同士:

✅ code-review + spec-compliance (並列可能)

理由: 両方とも読み取り専用（実装修正なし）

並列実行不可能な組み合わせ

実装系同士（同一ファイル操作可能性）:

❌ fsharp-domain + fsharp-application (並列不可)
❌ contracts-bridge + csharp-infrastructure (並列不可)

理由: 同一ファイルへの同時書き込みリスク

テスト系同士（同一テストプロジェクト操作可能性）:

❌ unit-test + integration-test (並列不可・推奨しない)

理由: テストプロジェクト参照関係の競合リスク

SubAgent選択チェックリスト

Step開始時

• Step特性を判定した（調査分析・実装・テスト・品質保証）
• 必要なSubAgentをリスト化した
• 責務境界を確認した
• 並列実行可能性を判断した
• SubAgent実行計画を作成した

SubAgent選択迷い時

• 責務境界を確認した（rules/agent-responsibility-boundary.md）
• 該当AgentのSubtypeがあるか確認した
• 並列実行判断ロジックを適用した

エラー修正時（Fix-Mode）

• エラー内容で責務判定した
• 責務マッピングでSubAgent選定した
• Fix-Mode指示テンプレート使用した

参照元ADR・Rules

• ADR_013: SubAgentプール方式採用
• ADR_018: SubAgent指示改善とFix-Mode活用
• SubAgent組み合わせパターン.md: Step特性別推奨パターン
• SubAgent実行ガイドライン.md: SubAgent起動・実行手順

関連Skills

• fsharp-csharp-bridge Skill: F#↔C#境界の型変換パターン
• clean-architecture-guardian Skill: Clean Architecture準拠性チェック
• tdd-red-green-refactor Skill: unit-test Agent活用パターン
• playwright-e2e-patterns Skill: e2e-test Agent専用・3つのE2Eテストパターン（data-testid/MCP/SignalR）・93.3%効率化実証済み

作成日: 2025-11-01 Phase B-F2 Step2: Agent Skills Phase 2展開 Phase B-F2 Step3: E2E専用SubAgent新設（13種類→14種類） 参照: SubAgent組み合わせパターン.md、ADR_013, ADR_018, ADR_024 最終更新: 2025-11-02