Strategic Programming · Reference 0003
Depth / Interface design — 印刷して手元に。用語は GLOSSARY.md に従う。
📐 モジュール=インターフェース(使う側が知るべきこと)+実装(知らなくてよいこと)。良い設計は複雑さを実装側に閉じ込める。
深さ = 隠す複雑さ(機能) ÷ インターフェースの複雑さ → 大きいほど良い
read_file(path) / Unix I/O open read write closeopen→buffer→decode→close を毎回手で繋ぐ| 問い | Yes なら |
|---|---|
| 窓口は小さいか? | 公開メソッド・引数・暗黙の約束が最小 → ◎ |
| 中身は厚いか? | その窓口の裏に、意味のある複雑さを隠せている → ◎ |
| 責務は1つに凝集? | 関係ない責務が混ざっていない(神クラス回避)→ ◎ |
| 分割で連結が増えすぎ? | 隠す複雑さ < 増える連結コスト なら分けない/統合する |
| 兆候 | 処方 |
|---|---|
| 小さなクラス/関数が大量に増殖 | 「短い=単純」ではない。統合して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。