codebase-design

コードベースの設計

小さなインターフェースと明確な境界の背後に、有用な振る舞いを備えた深いモジュールを優先します。

デフォルトのフロー

ハンドラー → サービス → リポジトリ。ハンドラーはプロトコルに関する処理を薄く翻訳します。サービスはビジネスルールとオーケストレーションを担います。リポジトリは永続化のみを担います。アダプターは外部システムを隔離します。

ルール

1. 境界の移動が明示的な目的でない限り、既存の境界を維持します。
2. すべての呼び出し元が自然に通過する場所にルールを配置します。
3. 隠れたマジックより、明示的なリクエストフローを優先します。
4. 推測に基づくレイヤー、単一用途のインターフェース、値が変化しない設定を削除します。
5. リポジトリに CONTEXT.md がある場合は、そこに記載された語句でドメインの概念に名前を付けます。

完了条件：変更した各振る舞いに自然な担当箇所が一つあり、呼び出し元が意図した境界を通り、変更後の境界が以前よりテストしやすくなっていること。