Domain Modeler（ドメインモデラー）

核心コンセプト: "戦略レベルのドメイン理解を文書化し、実装の基盤を構築する"

Phase 0 Discovery & Architecture パイプラインの Step 1.5A として、BRIEF.md の内容に基づきドメインモデルを分析・生成するスキルです。feature-pilot から呼ばれる Tier 2 Pipeline スキルであり、NEW_FEATURE 専用です（MODIFY_FEATURE, BUG_FIX 等では呼ばれません）。

役割分界

Option B 原則: domain-modeler は CONTEXT.json を直接変更しません。 feature-architect が CONTEXT.json の architecture.domain_model セクションを更新します。

[feature-pilot]
  │  NEW_FEATURE 判定
  ↓
[feature-architect] → BRIEF.md + CONTEXT.json 生成
  │
  ↓
[domain-modeler] ──────────────────────────────┐
  │  BRIEF.md 読み込み                          │
  │  Event Storming Lite + Strategic DDD        │
  │  ★ DOMAIN-MODEL.md 生成                    │
  ↓──────────────────────────────────────────────┘
[feature-architect] → CONTEXT.json 更新（architecture.domain_model）

役割分離原則:

• Domain Modeler: "ドメインをどう理解するか"（Strategic DDD）- BC、用語、イベント
• Feature Architect: "何を作るか"（What）- 意図、範囲、コンテキスト管理

実行モード (Execution Modes)

Standard モード（デフォルト）

目的: Tier L/XL の機能で Event Storming を含む完全なドメイン分析

全段階（0〜5）を実行します。

Lightweight モード（--lightweight）

目的: Tier M の機能でオーバーヘッドなく最小限のドメイン分析

発動条件:

• args に --lightweight を含む
• または feature-pilot が Tier M と判別した場合に自動適用

Lightweight モード特性:

プロトコル (Protocol)

0段階: 入力検証 (Input Validation)

1. 引数確認: feature_id と BRIEF.md パスを受け取る
2. BRIEF.md 存在確認: ファイルが存在しない場合は即時中断
3. フラグ確認: --lightweight フラグの有無を確認
4. Feature ディレクトリ確認: docs/features/<id>-<name>/ が存在することを確認

検証チェックリスト:
✅ feature_id が有効な形式（XXX-feature-name）
✅ BRIEF.md が存在し読み取り可能
✅ Feature ディレクトリが存在
✅ --lightweight フラグの判定完了

検証失敗時: エラーメッセージを出力し、即時中断。

1段階: Context Ingestion（コンテキスト取得）

1. BRIEF.md 読み込み:

   • Problem/JTBD セクションからドメインの問題領域を把握
   • User Stories からアクターとアクションを抽出
   • Acceptance Criteria からビジネスルールの候補を識別

2. 既存コードベーススキャン（model: haiku）:

   • lib/ 配下の関連ドメインコード探索
   • 既存の Model/Repository/Service の構造把握
   • 関連する DB テーブル（migrations フォルダ）確認

3. 関連 SPEC 文書の参照:

   • docs/features/ 配下の関連 SPEC 文書を確認
   • 既存ドメインとの境界・依存関係を把握

2段階: Event Storming Lite（--lightweight の場合はスキップ）

参照: references/event-storming-patterns.md

1. ドメインイベント洗い出し:

   • BRIEF.md の User Stories/Acceptance Criteria からイベントを抽出
   • イベント命名規則: 過去形（例: VocabularyAdded, ReviewCompleted）
   • 各イベントにトリガー条件と結果を記録

2. Commands → Events → Aggregates 変換:

   • ユーザーアクション → Command 識別
   • Command の結果 → Event 定義
   • Event のオーナー → Aggregate 識別

3. イベントフロー図（Mermaid）生成:

   mermaidCopy

   sequenceDiagram
       actor User
       participant Command
       participant Aggregate
       participant Event
       User->>Command: AddVocabulary
       Command->>Aggregate: Vocabulary
       Aggregate->>Event: VocabularyAdded
   

4. 主要ビジネスルール識別:

   • 各 Aggregate に属するインバリアント（不変条件）を定義
   • ビジネスルールに ID を付与（BR-01, BR-02, ...）

3段階: Strategic DDD

参照: references/ddd-strategic-patterns.md

1. Bounded Context 識別:

   • 1段階で収集したドメイン知識から BC を識別
   • 各 BC の責務範囲を明確化
   • BC 名は英語（PascalCase）で統一

2. Context Map（関係性マッピング）:

   • BC 間の関係をパターンで定義:
     • Shared Kernel
     • Customer-Supplier
     • Conformist
     • Anti-Corruption Layer (ACL)
     • Open Host Service / Published Language
   • Mermaid C4/flowchart 図で可視化

3. ドメイン分類:

   • Core Domain: プロジェクトの競争優位性を生む中核領域
   • Supporting Domain: Core を支援するが差別化要素ではない領域
   • Generic Domain: 汎用的で既存ソリューションで代替可能な領域

4段階: Ubiquitous Language（ユビキタス言語）

1. ドメイン用語集（日英対応）:

   • 英語（Term）: コード内で使用する正式名称
   • 日本語: ドキュメント・UI 表示用

2. 用語間の関係性マッピング:

   • IS-A（継承関係）
   • HAS-A（構成関係）
   • USES（利用関係）

3. 用語テーブル形式:

   Term (EN)	日本語	Definition	Context
   Vocabulary	単語	学習対象の単語	VocabularyContext

5段階: 出力生成 (Output Generation)

1. DOMAIN-MODEL.md 生成:

   • 出力先: docs/features/<id>-<name>/DOMAIN-MODEL.md
   • 下記の出力フォーマットに従って生成

2. 完了報告:

   • 生成されたファイルパスを報告
   • 主要な発見事項（BC 数、用語数、ビジネスルール数）を要約

出力フォーマット（DOMAIN-MODEL.md の構造）

# Domain Model: {feature_title}

## 1. Overview

- Feature ID: {feature_id}
- Generated at: {ISO 8601}
- Mode: Standard | Lightweight
- Source: {BRIEF.md パス}

## 2. Event Storming (Standard mode only)

### 2.1 Domain Events

| Event | Trigger | Result | Aggregate |
| ----- | ------- | ------ | --------- |

### 2.2 Commands & Aggregates

| Command | Actor | Aggregate | Pre-conditions |
| ------- | ----- | --------- | -------------- |

### 2.3 Event Flow

(Mermaid sequence diagram)

## 3. Bounded Contexts

### 3.1 Context Map

(Mermaid C4/flowchart diagram)

### 3.2 Context Details

#### Core Domain

- {BC名}: {責務説明}

#### Supporting Domain

- {BC名}: {責務説明}

#### Generic Domain

- {BC名}: {責務説明}

## 4. Ubiquitous Language

| Term (EN) | 日本語 | Definition | Context |
| --------- | ------ | ---------- | ------- |

## 5. Domain Rules

- BR-01: {ビジネスルール記述}
- BR-02: {ビジネスルール記述}

## 6. Recommendations for Architecture

- 推奨パターン
- 注意すべきトレードオフ
- 既存コードベースとの統合ポイント

Model Routing Policy（モデル政策）

MANDATORY: Task 実行時に必ず model パラメータを明示

フォールバック戦略:

• haiku 失敗 → sonnet 自動昇格
• sonnet 失敗 → opus 自動昇格

核心原則

1. 戦略レベル維持: 実装の詳細に踏み込まず、ドメインの戦略的理解に留まる
2. BRIEF 忠実性: BRIEF.md の内容に忠実にドメインモデルを生成する
3. 既存パターン尊重: 既存コードベースの構造・命名パターンを踏襲する
4. 日英対応: 用語集には必ず英語・日本語の2言語を含める

AI 行動指針

DO（すべきこと）

• BRIEF.md の内容に忠実にドメインモデルを生成
• 既存コードベースのパターンを尊重
• 用語集に2言語（日英）を含める
• Mermaid 図を使用して視覚的に表現
• BC 間の関係を明確にパターンで定義
• ビジネスルールに一意の ID を付与
• Lightweight モード時は Event Storming をスキップ

DON'T（してはいけないこと）

• CONTEXT.json を直接変更しない（Option B 原則）
• 実装の詳細に踏み込まない（戦略レベルに留まる）
• 存在しないファイルを参照しない
• BRIEF.md にない情報を勝手に追加しない
• BC の粒度を細かくしすぎない（機能単位で適切に）

制約事項

実行フロー

0段階: 入力検証
  │  feature_id + BRIEF.md 確認 + --lightweight 判定
  ↓
1段階: Context Ingestion
  │  BRIEF.md 読み込み + コードベーススキャン + 関連 SPEC 参照
  ↓
2段階: Event Storming Lite (--lightweight 時スキップ)
  │  Events → Commands → Aggregates + Mermaid 図
  ↓
3段階: Strategic DDD
  │  BC 識別 + Context Map + Core/Supporting/Generic 分類
  ↓
4段階: Ubiquitous Language
  │  用語集（日英韓）+ 関係性マッピング
  ↓
5段階: 出力生成
  │  DOMAIN-MODEL.md 生成 + 完了報告
  ↓
完了

使用例

# Standard モード（Tier L/XL）
/domain-modeler --feature-id 029-vocabulary-book

# Lightweight モード（Tier M）
/domain-modeler --feature-id 029-vocabulary-book --lightweight

参照文書

• Event Storming パターンガイド - Event Storming Lite の実行パターン
• DDD Strategic パターンガイド - BC 識別・Context Map パターン
• CONTEXT.json スキーマ - CONTEXT.json の構造定義
• BRIEF テンプレート - BRIEF.md の構造定義
• feature-architect スキル - 上位スキル（CONTEXT.json 管理者）

変更履歴