Reference · Junior → Senior · 0002

複雑性 検査キット — Red Flags 早見表

出典: John Ousterhout『A Philosophy of Software Design』design red flags

複雑性 = 依存 + 不明瞭さ。すべてのレッドフラグは、このどちらか(または両方)の具体形。 症状で気づき → フラグで名指し → zero tolerance で直す。

症状(気づきのトリガー)

Change amplification — 1変更が多数の修正を呼ぶ Cognitive load — 知るべき量が多すぎる Unknown unknowns — どこを直すか分からない(最悪)

レッドフラグ・カタログ

フラグ原因見分け方
浅いモジュールShallow module不明瞭さインターフェースが実装と同じくらい複雑。包むだけで何も隠さない。
情報漏れInformation leakage依存1つの設計判断(形式・上限値など)が複数モジュールに反映。片方変えると壊れる。
素通しメソッドPass-through method依存引数を別メソッドに渡すだけ。層は増えるが抽象は増えない。
時間的分割Temporal decomposition依存構造を実行順(読む→処理→書く)で割り、共有知識が散る。情報隠蔽で割るのが正解。
過剰露出Overexposure不明瞭さよく使う機能のために、めったに使わない概念まで知らされる。common case が簡単でない。
特殊と汎用の混在Special-general mixture依存汎用の仕組みの中に特定用途のコードが混ざる。
癒着メソッドConjoined methods依存片方だけでは理解できないほど2メソッドが絡む。
曖昧な名前Vague name不明瞭さ名前が中身を語らず、読まないと分からない。良い名前が付けにくい=設計が濁っているサイン。

直し方

zero tolerance(ゼロ容認)

  • 複雑性は漸進的に積もる。一撃では死なないが沼になる。
  • 小さな複雑性をその都度潰す。
  • 開発時間の ~10–20% を設計に投資する習慣。

運用3原則

  • ① 触れたら設計を良くして去る(さもなくば悪くしている)。
  • ② でも全面リライトはしない。一貫性も設計価値。触れた範囲だけ小さく。
  • ③ 新規 / AI出力はマージ前にこの表でスキャン。

引用元 · A Philosophy of Software Design (Ousterhout) · Software Design Red Flags (Portebois)
用語は GLOSSARY.md に準拠。詳細・演習は lessons/0002-diagnosing-complexity-red-flags.html。