Strategic Programming · Reference 0003

深いモジュール 早見表

Depth / Interface design — 印刷して手元に。用語は GLOSSARY.md に従う。

📐 モジュール=インターフェース(使う側が知るべきこと)+実装(知らなくてよいこと)。良い設計は複雑さを実装側に閉じ込める。

深さ = 隠す複雑さ(機能) ÷ インターフェースの複雑さ → 大きいほど良い

深い vs 浅い

◎ 深いモジュール

  • 薄い窓口 × 厚い中身
  • 公開メソッドが少ない / 引数が素直
  • 暗黙の約束(呼ぶ順序・前提)がほぼない
  • 例: read_file(path) / Unix I/O open read write close

✕ 浅いモジュール

  • 窓口が実装と同じくらい複雑
  • 手順を使う側に露出(overexposure)
  • 暗黙の約束が多い(READMEで補う羽目)
  • 例: open→buffer→decode→close を毎回手で繋ぐ

設計の判断チェック(この順で自問)

問いYes なら
窓口は小さいか?公開メソッド・引数・暗黙の約束が最小 → ◎
中身は厚いか?その窓口の裏に、意味のある複雑さを隠せている → ◎
責務は1つに凝集?関係ない責務が混ざっていない(神クラス回避)→ ◎
分割で連結が増えすぎ?隠す複雑さ < 増える連結コスト なら分けない/統合する

classitis 警報(AI出力に多い)

兆候処方
小さなクラス/関数が大量に増殖「短い=単純」ではない。統合して1つの深いモジュールに
A→B→C を使う側が手で繋ぐ手順を1つの薄い窓口の内側へ隠す(X.do(input))
ラッパが素通しするだけ層を消すか、本当の抽象を足す(0002: shallow / pass-through)
「深く」を口実に全部詰め込む逆に神クラス化。窓口の薄さ+凝集とセットで初めて深い

🎯 合言葉: 窓口は小さく、中身は厚く、責務は1つに凝集。3つ揃って初めて「深い」。

出典: John Ousterhout, A Philosophy of Software Design(Ch.4 深いモジュール, Ch.9 special-general mixture)/ danlebrero book notes(classitis, short ≠ simple)。関連: reference/0002(レッドフラグ検査キット), GLOSSARY.md。