メインコンテンツへスキップ
見出し画像

「小さな関数を書け」と「間違った抽象化より重複」は何が違うのか~ルール型と判断型のソフトウェア助言~

    【発端】 経験で別の意味になる同じ助言

    画像
    従いやすい助言は広まる。価値が高い助言は従いにくいことがある。

    最近、Remo H. Jansen(@remojansen)さんの「Why the Best Software Advice Is the Hardest to Follow」(DEV Community、2026年9月22日公開)を読みました。ソフトウェアの助言には従いやすいものと従いにくいものがあり、価値が高いのは従いにくいほうに多い、という内容です。

    同じ助言が、経験の段階ごとに別の意味に読める点が面白いです。「同じことを繰り返すな」を覚えたばかりの人は、似たコードを見るたびにまとめたくなります。

    数年後に「間違った抽象化より、重複のほうがましだ」という助言に出会うと、最初の助言の見え方が変わります。

    この記事では、助言をルール型と判断型に分けます。なぜ判断型は従いにくいのかを、仕組みから説明します。

    重複と抽象化の例、Scrumとアジャイルの関係まで進みます。最後に、自分の仕事で試せる小さな一歩を置きます。

    【基礎】 答えを渡す型と、解釈を求める型

    助言には、やることが決まるものと、読み手が解釈するものがあります。

    ルール型は、小さな関数を書く、マジックナンバーを定数にする、意味のある名前を付ける、のような助言です。コードを見て「この関数は大きすぎるか」と確認でき、答えはほぼ決まります。

    判断型は、レシピではなく原則として渡されます。読み手が状況に合わせて解釈し、別の原則と矛盾することもあります。

    「間違った抽象化は、重複よりコストが高い」がその例です。

    ルール型は理解しやすく、教えやすく、確認しやすい助言です。そのため、コーディング規約やリンター、コードレビューに組み込まれて広まります。

    元記事は、『Clean Code』が広く読まれた理由の一つも、実行に移しやすい助言が多いことだと見ています。

    【違い】 規約にできるルールと、人に残る判断

    画像
    五つの軸で見ると、差は答えの置き場所に集まる。

    ルールと判断の差は、助言そのものよりも、答えがどこに置かれるかにあります。ルール型は答えが助言の中にあり、判断型は答えが読み手の中にあります。

    次の一覧は、元記事の記述を軸ごとに並べ直したものです。

    答えの形

    • ルール型:ほぼ一つに決まる

    • 判断型:状況によって変わる

    確認の方法

    • ルール型:コードを見て確認でき、リンターで強制できる

    • 判断型:確認する仕組みが無い

    教える時間

    • ルール型:小さな関数のルールなら5分で教えられる

    • 判断型:経験が必要

    組織での扱い

    • ルール型:コーディング規約にできる

    • 判断型:判断できる人が必要

    責任の置き場

    • ルール型:チェックリストに預けられる

    • 判断型:決めた本人が引き受ける

    判断型が難しい理由は、良い助言どうしが衝突するところにもあります。「シンプルに保て」「コードを重複させるな」「早すぎる抽象化を避けろ」「変わるものはカプセル化せよ」は、どれも良い助言です。

    一つに従うと別の一つに従いにくくなったとき、どちらを優先するかを教えるコンパイラ警告やリンターはありません。経験のあるエンジニアどうしが同じコードで意見を分けるのも、ルールの知識の差ではなく、将来や変更コストについての判断が違うためだと元記事は説明しています。

    ルールの数を増やせば判断力がつく、とは限りません。ルールをどれだけ集めても、この状況でどのルールを優先するかを決める力は別に育てる必要があります。

    【仕組み】 経験が作り替える助言の読み方

    画像
    判断型の助言は、読み手の事例の数で意味が決まる。

    判断型の助言は、読み手の経験が助言の解釈を決めるため、従いにくくなります。助言の文面は同じでも、読み手が持つ事例の数で意味が変わります。

    元記事は、経験の積み重ねを三段階で描いています。最初は「そう言われたからやる」です。

    次に「普通はなぜ役に立つか」を理解します。最後に「トレードオフを理解し、ここで使うかどうかを自分で決める」に至ります。

    事例が十分に溜まると、言葉にする前にパターンが見えるようになります。抽象化を見て「まだ早い」と感じるのは、似た状況の結果を何度も見てきたからです。

    元記事は、この直感を魔法ではなく、経験の蓄積の結果だと位置づけています。

    この見方は、技能習得の研究とも重なります。Dreyfusモデルは、技能の習得を初心者、新人、一人前、中堅、熟練者の五段階で捉えます。

    初心者は文脈に依存しない規則に従い、中堅になると直感を使って判断するようになります。

    これは元記事とは別の資料に基づく補足です。

    私の整理では、ルール型の助言は初心者が最初に持つ足場です。判断型の助言は、その足場の使い方を読み替える段階で役に立ち始めます。

    判断を人に渡すのが難しいのは、そのためです。理由と状況を言葉にして添えない限り、結論だけが残り、ルールに戻ってしまいます。

    【具体例】 DRYを学んだ人が、重複を選ぶまで

    画像
    助言の文面は変わらず、助言を解釈する力が変わる。

    DRY(Don't Repeat Yourself)は「同じことを繰り返すな」という原則です。元記事は、この一つの原則の読み方が変わる過程を、具体例として描いています。

    DRYを学んだ直後は、似たコードがあれば抽象化します。パラメータが重なれば共通のオブジェクトを作り、複数のクラスが似た動きをすれば基底クラスを作ります。

    助言には従っているので、間違ってはいません。

    数年後に、「間違った抽象化より重複を選べ」という助言に出会います。重複は、二つの概念を独立させておくための代価になることがあります。

    抽象化のほうが、重複より強い結合を生むこともあります。ドメインが抽象化の形を教えてくれるまで、あえて繰り返して待つ選択もあります。

    元記事の言い方を借りると、助言は変わらず、解釈する力が変わったのです。

    この考え方を広めた一人がSandi Metzさんです。彼女のブログ「The Wrong Abstraction」は、重複は間違った抽象化よりずっと安い、と述べています。

    抽象化が合わなくなったときの対処として、抽象化したコードを各呼び出し元へ戻して重複を復活させる方法も示しています。

    【関連概念】 判断を一部ルールにする三つの工夫

    画像
    ルールにした部分と、判断が残る部分を分けて読む。

    判断型の助言を、人は何もせず放置してきたわけではありません。判断の一部をルールに近づけたり、判断の余地を意図して残したりする工夫があります。

    ここでは三つの概念を取り上げます。

    一つ目は、Martin Fowlerさんの『リファクタリング』で広まった3回目で整理する目安)です。似たコードが2回なら整理を急がず、3回目で共通化します。

    早すぎる共通化が間違った抽象化を招くことを避ける狙いがあります。私の整理では、これは判断型の助言を持ち運べるルールに圧縮した近似です。

    二つ目は、DRYの元の定義です。

    Andy HuntさんとDave Thomasさんの書籍『The Pragmatic Programmer』は、「あらゆる知識は、システム内で単一かつ曖昧でない権威ある表現を持つべきだ」と述べています。対象は同じ文字列のコードではなく知識です(DRYの定義)。

    三つ目は、Scrumの位置づけです。Scrumガイドは、Scrumを意図的に不完全なフレームワークと説明しています。

    Scrumの理論を実践するのに必要な部分だけを定め、それ以外は現場に委ねる設計です。

    元記事は、Scrumの役割、イベント、成果物は学んですぐ始められる一方で、アジャイルソフトウェア開発宣言の価値や原則には解釈が必要だと対比します。たとえば、プロセスより個人と対話を重んじるという価値は、プロセスが不要という意味ではありません。

    形式を整えることと、背後の原則を理解することは別のことです。

    3回目の整理

    • ルールにした部分:3回目で共通化する

    • 判断が残る部分:どの重複を同じ知識と見るか

    DRY

    • ルールにした部分:知識の表現を一箇所にする

    • 判断が残る部分:何を同じ知識と数えるか

    Scrumとアジャイル

    • ルールにした部分:役割、イベント、成果物

    • 判断が残る部分:状況に合わせた原則の適用

    参考情報・参考書籍(PR)

    本記事をより深く理解するために、概念マップスライドを作成しました。こちらをみることで理解の補助になるはずです。

    Martin Fowlerさんの『リファクタリング 既存のコードを安全に改善する(第2版)』は、3回目で共通化する目安を広めた書籍です。重複をいつ整理するかを考える手がかりになります。

    Andrew HuntさんとDavid Thomasさんの『新装版 達人プログラマー 職人から名匠への道』は、DRYの元の定義が載っている書籍です。DRYの対象が知識であることを、原典で確認できます。

    関連記事

    【まとめ】 手元のルールに書き添える理由と例外

    ここまでの話を、自分の仕事で試す小さな一歩にします。最近従ったルールを一つ選び、次の三つを書き出してみてください。

    1. □ そのルールを、普通は役に立つ理由を一文で書く。

    2. □ そのルールが当てはまらない状況を一つ考える。

    3. □ 迷ったコードが手元にあれば、似て見える二つの部分が同じ理由で変わるのか、別の理由で変わるのかを書く。

    元記事の著者は、記事の最後で二つの問いを読者に投げかけています。いちばん意味のなかった実用的な助言は何か。

    ルールではなく、ソフトウェアの見方そのものを変えた判断型の助言は何か。チームで、この二つを持ち寄ってみるのもよいと思います。

    なお、ここで述べた整理は元記事と関連資料に基づく読み方であり、私が現場で効果を検証したものではありません。

    参考情報

     
     
    海外でバズった最新テック関連情報をわかりやすく整理します! スキの数やページビューが多いなどの反響が多いものがあれば、実際の環境で操作した結果や手順などを共有する記事も作成したいとも思ってます! とりあえずこれを見ておけばディープな最新情報もキャッチアップ!できるものを目指します

    あなたへのおすすめ