Lesson 0003 · Phase 1 — 複雑性とコードベース設計
0002ではレッドフラグで汚さを名指しできるようになった。今回はその裏返し。「良い設計」を1つの物差し ── 深さ(depth) ── で測り、自分で設計できるようにする。
どんなモジュール(関数・クラス・サービス)も、2つの部分でできてる1。ここを分けて見るのが、今日の全ての土台だよ。
キモは非形式的インターフェース。型に出ない「先に◯◯を呼んでおくこと」「例外時はこうなる」みたいな暗黙の約束が多いほど、使う側の認知負荷が上がる ── これが 0002 の「不明瞭さ」の正体だったね。
Ousterhout の中核テーゼ: モジュールは深くあれ(modules should be deep)1。深さは、次の比で決まる。
窓口は小さいのに、大量の複雑さを飲み込む。コスト<利益。
窓口が実装と同じくらい複雑。包んだ意味がない。コスト≒利益。
古典的な"深い"例が Unix のファイルI/O1。窓口は open / read / write / close / lseek の実質5個だけ。その裏で、ディスクブロック割り当て・ディレクトリ探索・権限・キャッシュ・並行アクセスといった膨大な複雑さを隠してる。薄い窓口 × 厚い中身=深いモジュールの手本。
2つの設計を比べて、より深い方を選んで。押すと即フィードバック。
「クラス/関数は小さく分けるほど良い」── よく聞くよね。でもこれを突き詰めると、浅いモジュールが大量に増える。Ousterhout はこの症候群を classitis と呼ぶ2。
なぜダメか: モジュールを1個増やすたびに、新しいインターフェース=新しい学習コスト=新しい依存が生まれる。細かく割りすぎると、部品同士の連結を理解するコストが、隠したはずの複雑さを上回る。「短い」と「単純」は違う2。
だから設計判断はいつも「この線引きは、隠す複雑さ > 増える連結コスト か?」。答えが No なら、その分割はしない方がいい。2つの浅いクラスを1つの深いクラスに統合するのも立派な設計判断だよ。
場面: AIが「設定読み込み」をこう分けてきた。使う側はA→B→Cを正しい順序で自分で呼ぶ必要がある。あなたの最も"深い"直し方は?
class ConfigFileOpener: # A: ファイルを開くだけ class ConfigParser: # B: 文字列→dict にするだけ class ConfigValidator: # C: dict を検証するだけ # 呼ぶ側: open→parse→validate を毎回手で繋ぐ
逆張りの罠も1つ。「深くしろ」を「1クラスに全部入れろ」と勘違いすると、神クラスができる。深さの条件は薄い窓口とセット。機能が凝集していて、かつ窓口が小さいときだけ深い。関係ない責務を同じモジュールに混ぜたら、それは 0002 の special-general mixture に逆戻りだよ1。
用語は ../GLOSSARY.md、早見表は ../reference/0003-depth-card.html。
次回 0004: 深さを支える技術=情報隠蔽と「漏れる抽象」。何を窓口に出し、何を中に隠すかの線引き。