【やさしく解説 設計編・中級 #5】足すだけ、のはずだった ～ ボタンひとつの依頼から ～

【やさしく解説 設計編・中級 #5】足すだけ、のはずだった

「ボタンを一つ、足すだけなんですが」。
そう依頼されて、半日と見積もりました。

コードを開くと、既存の分岐を三箇所直すことになりました。
直した先のテストを読み直し、壊していないか不安で、結局まわりを全部読みました。
三日かかりました。

リリース後、誰かが言いました。「足しただけ、なのに、どうして時間がかかるのですか」。

---
その『どうして』につく名前が、開放閉鎖原則（OCP）。
　SOLIDの「O」ですが、答えは新しい原則の中ではなく、これまでの4回の中に、最初から置いてありました。
　SOLIDの5文字のうち、Oだけ、役割が違います。その種明かしの一枚も、用意しています。

持ち帰りは一問だけ。「それ、足すだけで足せますか？」

SOLIDを原則からではなく事例から読み直す、中級シリーズ（全6回）の第5回です。

---
※本編にて、「ドメイン」とは、「駆動」とは、を解説しています。中級編の前にどうぞ

【やさしく解説 設計編 #0】DDDのコード、読めるのに分からない人へ
https://speakerdeck.com/panda728/yasasikujie-shuo-she-ji-bian-number-0

ｰｰｰ
【やさしく解説 設計編・中級 】目次
#1 一つの車に、運転手は一人 ～ ある倉庫システムの事例から ～
　キーワード：`SOLID` `単一責任の原則（SRP）` `アクター`
https://speakerdeck.com/panda728/yasasiku-sekkei-2-number-1

#2 使わないボタンだらけのリモコン ～ となりの変更で、うちのビルドが赤くなる話 ～
　キーワード：`SOLID` `インターフェース分離の原則（ISP）`
https://speakerdeck.com/panda728/yasasiku-sekkei-2-number-2

#3 【やさしく解説 設計編・中級 #3】形はあっていたのに ～ 形に書けない約束の話 ～
　キーワード：`SOLID` `リスコフの置換原則（LSP）` `事前条件、事後条件、不変条件`
https://speakerdeck.com/panda728/yasasiku-sekkei-2-number-3

#4 ルールの寿命と、システムの年輪 ～ 月曜の朝の、一通の通知から ～
　キーワード：`SOLID` `依存性逆転の原則（DIP）` `安定依存`
https://speakerdeck.com/panda728/yasasiku-sekkei-2-number-4

#5 なぜ「足すだけ」が、「足すだけ」で済まないのか～ ボタンひとつの依頼から ～
　キーワード：`SOLID` `開放閉鎖の原則（OCP）`
https://speakerdeck.com/panda728/yasasiku-sekkei-2-number-5

#6 良いアーキテクチャとは ～ 一本の登り道の、行き先 ～
　キーワード：`SOLID` `クリーンアーキテクチャ`
https://speakerdeck.com/panda728/yasasiku-sekkei-2-number-6

※ 7/17 目次およびスライド間のリンクを調整

Transcript

1. なぜ「足すだけ」が、 「足すだけ」で済まないのか 【やさしく解説 設計編・中級 #5】ボタンひとつの依頼から 2026.07 北尾　英之 (@kitaohx) 1
2. 今日は、痛みの話から 前回までで、質問が4つ揃いました。(各回へのリンクは末尾にて) 質問 出どころ・古典 運転席に、何人座っている？ 中級#1・SRP その操作盤、使わないスイッチは？ 中級#2・ISP 形は合っていても、約束を守っている？ 中級#3・LSP 寄りかかる先は、自分より長生き？ 中級#4・DIP ここから、ある痛みの話を始めます。 ま え お き 2
3. 「ボタンを一つ、足すだけなんですが」 そう依頼されて、半日と見積もりました。 コードを開きます。 既存の分岐を、三箇所直すことになりました 直した先のテストを、読み直すことになりました 壊していないか不安で、結局まわりを全部読みました 三日かかりました。 痛 み 3
4. リリース後、誰かが言いました。 足しただけ、なのに、どうして時間がかかるのですか。 痛 み 4
5. なぜ「足すだけ」が、 「足すだけ」で済まないのでしょうか 答えを見る前に、少しの間、想像してください。 （ヒントは、これまでの4回全部です。 ） 5
6. 答えは、これまでの4回の質問すべてです。 回 症状 伸びた手の先 #1 営業の変更で、梱包が止まった 現場の箱の組み立て #2 帳票の変更で、隣のビルドが割れた 使ってもいないコード #3 新しい会社の加盟で、待機中の車が消えた 呼び出し元の前提 #4 画面フレームワークの更新で、業務ルールが道連れ 在庫の計算式 ぜんぶ、足そう・変えようとした瞬間に、 　触らなくていいはずの場所へ手が伸びた話です。 解 剖 6
7. 見積もりは、間違っていません 「半日」は、足すものの大きさを、正しく読んでいました。 　狂わせたのは、構造が隠していた、手が伸びる先の数です。 三日と半日の差は、腕の差ではありません。 　構造の差です。 解 剖 7
8. もし、どの質問にも引っかからなければ 運転手が一人なら、他の運転手の車に手が伸びない 盤が自分専用なら、隣の変更に巻き込まれない 約束が守られていれば、置き換えても壊れない 寄りかかりの向きが正しければ、フレームワークの更新で道連れにならない つまり 既存のコードに触らずに、新しいものを足せる。 解 剖 8
9. この状況には、名前がついています 開放閉鎖原則（OCP） 。 SOLIDの「O」です。 ソフトウェアの構成要素は、 　拡張に対して開いていて、 　修正に対して閉じているべきである。 原型は、バートランド・メイヤー（1988年） 。 すべての変化に対して閉じることは、できません。 　どの変化に対して閉じるかを、選びます。 命 名 9
10. S・L・I・Dは、Oに至る道でした 4つの質問は、すべて同じ方向を向いていました。 既存のコードを触らずに足せること。 SOLIDの5文字のうち、Oだけ役割が違います。 　S・L・I・Dが手段の名前で、Oは目的地の名前です。 種 明 か し 10
11. 目的地（OCP）までの距離の測りかた この距離は、注意力の消費で測れます。 「足すだけ」のはずが、読み直しが増えて注意力が削られる。 触っていない場所のテストが、気になって注意力が削られる。 レビューで「影響は？」と聞かれて、注意力を削りながら調べる。 注意力が削られる痛みが強いほど、目的地は遠い。 ただし、この測りかたは、人にしか使えません。 検 出 器 11
12. 痛みを感じない開発者 AIは、何千行の読み直しも、一瞬でこなします。 人間なら、心配やつらさをヒントに立ち止まり 目的地（OCP）のほうへ引き返せます。 AIは、痛みを感じないまま走りきります。 AIは、目的地までの距離を、これから何で測るのか。 　答えはまだ出ていません。 これから面白くなります。追いかけてみてください。 検 出 器 12
13. それ、足すだけで 足せますか？ 今日の持ち帰りは、この一問だけです。 13
14. 今週、どこかで試してみて 次の「小さな機能追加」のとき、 　コミット前に、Gitの差分画面を開いてください。 　並んだファイルは、三つに仕分けられます。 差分に現れたもの 読みかた 新しいファイル 足すだけで足せた変更 はじめから触るつもりだった場所 正しい修正 つもりなく、手が伸びた場所 その数が、目的地までの距離 遠くても、それが現在地です。 や っ て み よ う 14
15. 次回、最終回 次回（中級 #6・最終回）：良いアーキテクチャとは https://speakerdeck.com/panda728/yasasiku-sekkei-2-number-6 5つの質問と5つの症状を一望して、 　この中級編がずっと目指していた場所を、確かめます。 15
16. この回が借りたもの 開放閉鎖原則（OCP） 原型はバートランド・メイヤー（Object-Oriented Software Construction, 1988） 。 本文の定式化は下記を参照しています。 ロバート・C・マーティン著、角征典・高木正弘訳 『Clean Architecture 達人に学ぶソフトウェアの構造と設計』KADOKAWA、2018年 https://www.kadokawa.co.jp/product/301806000678/ 本文の「開放閉鎖原則」は本連載の表記です。 「SOLID」という呼び名 頭文字をSOLIDと並べたのは、マイケル・フェザーズの発案と ロバート・C・マーティン自身が紹介しています。 引 用 元 16
17. この回が借りたもの（つづき） 「すべての変化に対して閉じることはできない」 ロバート・C・マーチン著、瀬谷啓介訳 『アジャイルソフトウェア開発の奥義 第2版 オブジェクト指向開発の神髄と匠の技』 ソフトバンククリエイティブ、2008年 （OCPの章にある、閉鎖は完全にはできず戦略的に選ぶ、という議論に基づきます。 　著者名の表記は同訳書に合わせています。 ） 引 用 元 17
18. この回が借りたもの（つづき） 「SOLIDの中でOだけ役割が違う」「痛みは違反のシグナル」 「AIは痛みを感じない」という視点 Podcast「リファクタリングとともに生きるラジオ」#103〜#105 （lacolaco氏・okunokentaro氏）に示唆を受けました。 S・L・I・Dを「Oへの手段」と括る整理は、本連載のものです。 https://refactoradio.com/episode/105 https://www.youtube.com/watch?v=Xq9m6672J0Q 四つの症状の再訪、「ボタンひとつ」の痛みの物語 本連載のたとえです。事例はフィクションです。 引 用 元 18
19. 【やさしく解説 設計編・中級 】目次 1 一つの車に、運転手は一人 　　～ ある倉庫システムの事例から ～ 　キーワード： SOLID 単一責任の原則（SRP） アクター https://speakerdeck.com/panda728/yasasiku-sekkei-2-number-1 2 使わないボタンだらけのリモコン 　　～ となりの変更で、うちのビルドが赤くなる話 ～ 　キーワード： SOLID インターフェース分離の原則（ISP） https://speakerdeck.com/panda728/yasasiku-sekkei-2-number-2 3 形は合っていたのに 　　～ 形に書けない約束の話 ～ 　キーワード： SOLID リスコフの置換原則（LSP） 事前条件、事後条件、不変条件 https://speakerdeck.com/panda728/yasasiku-sekkei-2-number-3 19
20. 【やさしく解説 設計編・中級 】目次（つづき） 4 ルールの寿命と、システムの年輪 　　～ 月曜の朝の、一通の通知から ～ 　キーワード： SOLID 依存性逆転の原則（DIP） 安定依存 https://speakerdeck.com/panda728/yasasiku-sekkei-2-number-4 5 なぜ「足すだけ」が、「足すだけ」で済まないのか 　　～ ボタンひとつの依頼から ～ 　キーワード： SOLID 開放閉鎖の原則（OCP） https://speakerdeck.com/panda728/yasasiku-sekkei-2-number-5 6 良いアーキテクチャとは 　　～ 一本の登り道の、行き先 ～ 　キーワード： SOLID クリーンアーキテクチャ https://speakerdeck.com/panda728/yasasiku-sekkei-2-number-6 20