VSA Pattern Selector

このスキルは、Blazor VSA パターンカタログからの適切なパターン選択を支援する。

機能の設計・実装時に、適切なパターンを自動的に提案する。

パターン選択フローチャート

ユーザーの要求を分析
    ↓
【STEP 1】カテゴリを特定

├─「〇〇機能を作って」「〇〇画面を追加」
│   → Feature Slices（垂直スライス）
│
├─「すべての Command に〇〇」「システム全体で〇〇」
│   → Pipeline Behaviors（横断的関心事）
│
├─「一覧を取得」「検索」「レポート」
│   → Query Patterns
│
├─「状態遷移」「操作可否」「型安全 ID」
│   → Domain Patterns
│
├─「同時実行制御」「トランザクション保証」
│   → Infrastructure Patterns
│
└─「UI 状態管理」「リアルタイム更新」
    → UI Patterns

【STEP 2】具体的なパターンを選択（下記テーブル参照）

【STEP 3】パターン YAML を読む
    → catalog/features/*.yaml または catalog/patterns/*.yaml

迷った場合: feature-slice をデフォルトで選択

Feature Slices（垂直スライス）

完全な機能を縦に実装するパターン。最も頻繁に使用。

| パターン ID | 用途 | トリガーフレーズ | |------------|------|-----------------| | feature-create-entity | エンティティ作成 | 「〇〇を作成」「新規登録」「追加」 | | feature-search-entity | 検索・一覧表示 | 「〇〇を検索」「一覧画面」「フィルタ」 | | feature-update-entity | エンティティ更新 | 「〇〇を編集」「更新」「変更」 | | feature-delete-entity | エンティティ削除 | 「〇〇を削除」「消す」「除去」 | | feature-import-csv | CSV インポート | 「CSV を取り込む」「一括登録」 | | feature-export-csv | CSV エクスポート | 「CSV に出力」「ダウンロード」 | | feature-approval-workflow | 承認ワークフロー | 「承認」「稟議」「ワークフロー」 |

Query Patterns（データ取得）

| パターン ID | 用途 | トリガーフレーズ | |------------|------|-----------------| | query-get-list | 全件/一覧取得 | 「一覧を取得」「リスト」 | | query-get-by-id | ID 指定取得 | 「ID で取得」「詳細表示」 | | query-get-by-period | 期間指定取得 | 「今日/今週/期間」「日付範囲」 | | complex-query-service | 複合条件クエリ | 「空き検索」「NOT EXISTS」「未割当」 |

Domain Patterns（ドメインモデル）

| パターン ID | 用途 | トリガーフレーズ | |------------|------|-----------------| | boundary-pattern | 操作可否判定 | 「〇〇できるか」「権限チェック」「優先権」 | | domain-state-machine | 状態遷移 | 「ステータス」「状態遷移」 | | domain-validation-service | 業務ルール検証 | 「重複チェック」「〜のみ可能」「前提条件」 | | domain-typed-id | 型安全 ID | 「強い型付け」「ProductId」 | | domain-timeslot | 時間枠管理 | 「予約時間」「タイムスロット」 | | domain-ordered-queue | 順序付きキュー | 「順番」「キュー」「Position」「Ready 状態」 |

Pipeline Behaviors（横断的関心事）

| 順序 | パターン ID | 用途 | トリガーフレーズ | |:---:|------------|------|-----------------| | 100 | validation-behavior | 入力検証 | 「バリデーション」 | | 200 | authorization-behavior | 認可チェック | 「権限」「ロール」 | | 350 | caching-behavior | キャッシュ | 「キャッシュ」「高速化」 | | 400 | transaction-behavior | トランザクション | 「トランザクション」 | | 550 | audit-log-behavior | 監査ログ | 「監査」「履歴」「証跡」 |

Infrastructure Patterns

| パターン ID | 用途 | トリガーフレーズ | |------------|------|-----------------| | concurrency-control | 同時実行制御 | 「楽観ロック」「悲観ロック」「ダブルブッキング」 |

条件付き必読パターン

特定の条件下で 必ず読むべき パターン。

| 条件 | 必読パターン | 理由 | |------|-------------|------| | UI がある | boundary-pattern | AI バイアスで忘却されやすい | | 状態遷移がある | domain-state-machine | 遷移制約の明確化 | | 重複チェックがある | domain-validation-service | 複数エンティティの検証 | | 予約/ダブルブッキング | concurrency-control | 同時実行制御が必須 | | 順番管理がある | domain-ordered-queue | Position 管理（FR-018 対策） | | 「〜のみ可能」 | domain-validation-service | 複合前提条件（FR-017 対策） | | 優先権のある操作 | boundary-pattern | Ready 状態の優先権（FR-021 対策） |

ドメイン別推奨パターン

図書館・貸出管理

audit-log-behavior（貸出・返却履歴）
concurrency-control（同時貸出防止）
domain-ordered-queue（予約順番管理）★FR-018
domain-validation-service（全コピー貸出中のみ予約可能）★FR-017
boundary-pattern（Ready 予約者の優先権）★FR-021

金融・決済

audit-log-behavior（決済履歴）
idempotency-behavior（重複決済防止）
concurrency-control（残高更新）

予約システム

domain-timeslot（予約時間枠）
complex-query-service（空き検索）
concurrency-control（ダブルブッキング防止）

承認ワークフロー

feature-approval-workflow（承認機能）
domain-state-machine（承認状態遷移）
domain-approval-history（承認履歴）

パターン YAML の読み方

各パターン YAML には以下のセクションがある：

| セクション | 内容 | |-----------|------| | ai_selection_hints | トリガーフレーズ、決定ロジック | | implementation.template | コードテンプレート | | ai_guidance.common_mistakes | 頻出ミス | | evidence.implementation_file | 実装例ファイルパス |

参照

詳細は以下を参照：

catalog/LLM_PATTERN_INDEX.md - パターン選択早見表
catalog/index.json - ai_decision_matrix
catalog/DECISION_FLOWCHART.md - パターン選択アルゴリズム