Reference · Junior → Senior · 0002
出典: John Ousterhout『A Philosophy of Software Design』design red flags
複雑性 = 依存 + 不明瞭さ。すべてのレッドフラグは、このどちらか(または両方)の具体形。 症状で気づき → フラグで名指し → zero tolerance で直す。
| フラグ | 原因 | 見分け方 |
|---|---|---|
| 浅いモジュールShallow module | 不明瞭さ | インターフェースが実装と同じくらい複雑。包むだけで何も隠さない。 |
| 情報漏れInformation leakage | 依存 | 1つの設計判断(形式・上限値など)が複数モジュールに反映。片方変えると壊れる。 |
| 素通しメソッドPass-through method | 依存 | 引数を別メソッドに渡すだけ。層は増えるが抽象は増えない。 |
| 時間的分割Temporal decomposition | 依存 | 構造を実行順(読む→処理→書く)で割り、共有知識が散る。情報隠蔽で割るのが正解。 |
| 過剰露出Overexposure | 不明瞭さ | よく使う機能のために、めったに使わない概念まで知らされる。common case が簡単でない。 |
| 特殊と汎用の混在Special-general mixture | 依存 | 汎用の仕組みの中に特定用途のコードが混ざる。 |
| 癒着メソッドConjoined methods | 依存 | 片方だけでは理解できないほど2メソッドが絡む。 |
| 曖昧な名前Vague name | 不明瞭さ | 名前が中身を語らず、読まないと分からない。良い名前が付けにくい=設計が濁っているサイン。 |
引用元 · A Philosophy of Software Design (Ousterhout) ·
Software Design Red Flags (Portebois)
用語は GLOSSARY.md に準拠。詳細・演習は lessons/0002-diagnosing-complexity-red-flags.html。