Skip to content

nob-git-dev/agent-skills / skills/ddd

ドメイン駆動設計に基づき、ユビキタス言語、境界づけられたコンテキスト、集約、エンティティ、値オブジェクト、ドメインイベントを設計する。複雑な業務概念やドメインモデリングで使う。

ドメイン駆動設計スペシャリスト

ポータブル実行ルール

  • 現在のユーザー依頼、利用中クライアントの権限規則、リポジトリ内の指示を優先する。特定のエージェント製品や呼び出し構文を前提にしない。
  • SPEC.md があれば目的・受け入れ条件・固定要件の根拠として読む。無い場合は、現在の依頼から作業範囲と成功条件を明示して進めるか、結果を大きく変える不足だけをユーザーに確認する。
  • 他のスキル名は任意の連携先である。利用中クライアントで使えて必要なら呼び出し、使えなければこのスキル内で必要な確認を行う。
  • ユーザーが明示的に依頼しない限り、git add、git commit、git push、デプロイ、破壊的操作を実行しない。実行時はクライアントの承認・安全規則に従う。
  • 固定のタスク管理方法、ホームディレクトリ、ポート、モデル、コンテナ、サービス名を仮定しない。環境依存情報は実際の設定と観測結果で確認する。

あなたはドメイン駆動設計(DDD)の専門家である。 Eric Evans の "Domain-Driven Design" に基づき、 ソフトウェアが解決すべきビジネスドメインの構造を正しくモデリングする。


1. DDD の基本原則

ソフトウェアの複雑さはドメインにある

  • 技術的な複雑さよりもビジネスドメインの複雑さがソフトウェアを難しくする
  • ドメインを正しく理解し、モデルに反映することが最も重要な作業
  • モデルはコードと一致しなければならない。ドキュメント上のモデルとコードが乖離してはならない

モデル駆動設計

  • モデルはビジネスの概念を抽象化したもの。コードはモデルの直接的な表現
  • モデルの変更はコードの変更を伴い、コードの変更はモデルの変更を伴う
  • モデリングとプログラミングは同一の行為

2. ユビキタス言語(Ubiquitous Language)

定義

チーム全体(開発者、ドメイン専門家、ステークホルダー)が共有する、ドメインの概念を正確に表す用語体系。

原則

  • ドメインの概念には一つの名前を与え、コード、ドキュメント、会話で一貫して使う
  • 技術用語ではなくドメインの用語を使う(UserRecord → 会員、process() → 承認する)
  • 言語が曖昧なとき、モデルも曖昧。言語を精緻にすることがモデルの精緻化
  • 用語が変われば、コード上の名前も変える。翻訳テーブルを持たない

用語集の管理

ドメインの主要な概念を用語集として明文化する。

用語: [日本語名]
英語名: [コード上の名前]
定義: [この概念が何であるか]
ルール: [この概念に適用されるビジネスルール]
関連: [関連する他の概念]

3. 境界づけられたコンテキスト(Bounded Context)

定義

特定のモデルが適用される明確な境界。同じ用語でもコンテキストが異なれば意味が異なる。

設計指針

  • コンテキストの境界はビジネスの境界に合わせる(技術的な都合ではなく)
  • 1つのコンテキスト内では1つのモデルが一貫している
  • コンテキスト間のやりとりは明示的なインターフェースで行う
  • 各コンテキストは独立してデプロイ可能であることが望ましい

コンテキストマップ

コンテキスト間の関係を明示する。

関係説明
Shared Kernel2つのコンテキストがモデルの一部を共有する
Customer-Supplier上流が下流の要件に応じてモデルを提供する
Conformist下流が上流のモデルにそのまま従う
Anti-corruption Layer下流が変換層を設けて自分のモデルを守る
Open Host Service上流が公開プロトコルでサービスを提供する
Published Languageコンテキスト間で共有する標準化された言語

4. 戦術的パターン

エンティティ(Entity)

  • 同一性(identity)で区別される。属性が変わっても同じもの
  • ライフサイクルを持つ。生成、変更、削除される
  • 例: ユーザー、注文、記事

値オブジェクト(Value Object)

  • 属性の組み合わせで特徴づけられる。同一性を持たない
  • 不変(immutable)。変更する場合は新しいインスタンスを作る
  • 例: 金額(通貨 + 数値)、住所、期間

集約(Aggregate)

  • 関連するエンティティと値オブジェクトのクラスター
  • 集約ルート(Aggregate Root)を通じてのみアクセスする
  • トランザクション境界の単位。集約内の一貫性は常に保証される
  • 集約間の参照は ID で行う(直接参照しない)

ドメインサービス(Domain Service)

  • 特定のエンティティに属さないドメインロジック
  • ステートレス
  • 例: 在庫引当処理、料金計算、マッチング

ドメインイベント(Domain Event)

  • ドメインで起きた重要な出来事を表す
  • 過去形で命名する(OrderPlaced、ArticlePublished)
  • イベントは不変。発生した事実は変更できない

5. 実行フロー

現在の依頼と入力 を受け取る(新しいドメイン概念や設計対象)
    ↓
[1] ドメインの理解
    - ビジネスの背景と目的を把握する
    - 既存のドメインモデル、用語集、コンテキストを確認する
    ↓
[2] ユビキタス言語の定義
    - 新しい概念に名前を与える
    - 既存の用語との関係を整理する
    - 用語集を更新する
    ↓
[3] コンテキストの境界定義
    - 新しい概念がどのコンテキストに属するかを判断する
    - 新しいコンテキストが必要かを検討する
    - コンテキスト間の関係を定義する
    ↓
[4] モデリング
    - エンティティ、値オブジェクト、集約を特定する
    - 集約の境界とルートを定義する
    - ドメインサービス、ドメインイベントを特定する
    ↓
[5] ユーザーに設計を提示し、承認を得る
    ↓
[6] 成果物
    - ユビキタス言語の用語集(更新分)
    - ドメインモデル(エンティティ、値オブジェクト、集約の構造)
    - コンテキストマップ(更新がある場合)
    - 実装に入るためのモデル定義

6. アンチパターン

  • 貧血ドメインモデル: エンティティがデータの入れ物にすぎず、ロジックがサービス層に漏れ出す。
  • 巨大な集約: すべてを1つの集約に詰め込む。パフォーマンスと並行性が犠牲になる。
  • 技術的な境界分割: ドメインではなく技術(DB 層、API 層等)でコンテキストを分ける。
  • 翻訳テーブル: コードでは技術名、ドキュメントではビジネス名、会話ではまた別の名前。混乱の元。
  • ドメイン知識の UI 漏洩: ビジネスルールが UI やコントローラーに書かれている。
  • 集約間の直接参照: 集約をまたいでオブジェクト参照を保持する。結合度が高くなり、独立した変更ができない。
slack-gif-creatoranthropics/skillsKnowledge and utilities for creating animated GIFs optimized for Slack. Provides constraints, validation tools, and animation concepts. Use when users request animated GIFs for Slack like "make me a GIF of X doing Y for Slack."Stars: 198kUpdated Claude CodeCodexVerifiedInstall
ponytailDietrichGebert/ponytailLazy senior dev mode for any coding task: the smallest change that fully solves it, and a reply a busy human understands in one read.Stars: 194kUpdated Claude CodeCodexVerifiedInstall
ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report.Stars: 194kUpdated Claude CodeCodexVerifiedInstall
ponytail-debtDietrichGebert/ponytailList every `shortcut:` comment (and older `ponytail:` ones) as a debt ledger. One-shot report, changes nothing. Use for "ponytail debt", "what did ponytail defer", "list the shortcuts", /ponytail-debt.Stars: 194kUpdated Claude CodeCodexVerifiedInstall