ai-engineer-teams: Skill for Kiro

Clean Architecture + DDD + Hexagonal

DDD戦術パターン、Clean Architectureの依存ルール、Hexagonalのポート/アダプターを組み合わせた、保守性・テスト容易性の高いバックエンドアーキテクチャ。

使うべき時（使わないべき時）

使うべき時	スキップすべき時
多くのルールを持つ複雑なビジネスドメイン	シンプルなCRUD、ビジネスルールが少ない
長期運用システム（年単位の保守）	プロトタイプ、MVP、使い捨てコード
5人以上の開発チーム	ソロ開発者や小チーム（1-2人）
複数のエントリポイント（API, CLI, イベント）	単一エントリポイント、シンプルなAPI
インフラ交換の必要性（DB、ブローカー）	固定インフラ、変更の可能性が低い
高テストカバレッジが必要	クイックスクリプト、内部ツール

シンプルに始める。必要な時にのみ複雑さを進化させる。 ほとんどのシステムは完全なCQRSやEvent Sourcingを必要としない。

重要: 依存ルール

依存は内側にのみ向く。外側のレイヤーは内側に依存し、逆は絶対にない。

Infrastructure → Application → Domain
   (アダプター)    (ユースケース)   (コア)

検出すべき違反:

• ドメインがDB/HTTPライブラリをインポート
• コントローラーがリポジトリを直接呼び出し（ユースケースをバイパス）
• エンティティがアプリケーションサービスに依存

設計の検証: 「UIもデータベースもなしでアプリケーションが動作するように作れ」— Alistair Cockburn。テストからインフラなしでドメインロジックを実行できれば、境界は正しい。

クイック判断ツリー

「このコードはどこに置く？」

どこに置く？
├─ 純粋なビジネスロジック、I/Oなし      → domain/
├─ ドメインを調整 + 副作用あり          → application/
├─ 外部システムと通信                   → infrastructure/
├─ インタラクション方法を定義（インターフェース） → port（domain or application）
└─ ポートを実装                        → adapter（infrastructure）

「エンティティか値オブジェクトか？」

エンティティ or 値オブジェクト？
├─ 永続する一意のIDを持つ        → エンティティ
├─ 属性のみで定義される          → 値オブジェクト
├─ 「これは同じモノか？」        → エンティティ（ID比較）
└─ 「これは同じ値か？」          → 値オブジェクト（構造的等価性）

「独立したアグリゲートにすべきか？」

アグリゲート境界？
├─ トランザクション内で一貫性が必要  → 同じアグリゲート
├─ 結果整合性で良い              → 別アグリゲート
├─ IDのみで参照                 → 別アグリゲート
└─ アグリゲート内に10以上のエンティティ → 分割する

ルール: トランザクションごとに1アグリゲート。アグリゲート間の整合性はドメインイベント（結果整合性）で。

ディレクトリ構成

src/
├── domain/                    # コアビジネスロジック（外部依存なし）
│   ├── {aggregate}/
│   │   ├── entity              # アグリゲートルート + 子エンティティ
│   │   ├── value_objects       # 不変の値型
│   │   ├── events              # ドメインイベント
│   │   ├── repository          # リポジトリインターフェース（DRIVEN PORT）
│   │   └── services            # ドメインサービス（ステートレスロジック）
│   └── shared/
│       └── errors              # ドメインエラー
├── application/               # ユースケース / アプリケーションサービス
│   ├── {use-case}/
│   │   ├── command             # コマンド/クエリDTO
│   │   ├── handler             # ユースケース実装
│   │   └── port                # ドライバーポートインターフェース
│   └── shared/
│       └── unit_of_work        # トランザクション抽象化
├── infrastructure/            # アダプター（外部関心事）
│   ├── persistence/           # データベースアダプター
│   ├── messaging/             # メッセージブローカーアダプター
│   ├── http/                  # REST/GraphQLアダプター（DRIVER）
│   └── config/
│       └── di                  # 依存性注入 / コンポジションルート
└── main                        # ブートストラップ / エントリポイント