【やさしく解説 設計編・中級 #6】良いアーキテクチャとは ～ 一本の登り道の、行き先 ～

【やさしく解説 設計編・中級 #6・最終回】良いアーキテクチャとは

中級#1から#4で、質問が4つ揃いました。
　#5で、その4つが同じ方向を向いていたことまで分かりました。

最終回は、5回ぶんの道具をすべて並べて、この登り道の行き先を確かめます。

---
行き先は、原典に書いてありました。
　『クリーンアーキテクチャ』第1章の、アーキテクチャの目的の宣言です。
　費用でも、コードの行数でも、設計の美しさでもないものを、最小限に抑えること。

その宣言を、本編#3に出てきた「張り紙」の教訓と合わせて読むと、一枚の定義になります。
　その一枚が、この中級編がずっと目指していた場所です。

最後の宿題は、ひとつだけ。見つけるだけで、直さなくて大丈夫なものです。

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

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

【やさしく解説 設計編 #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. 良いアーキテクチャとは 【やさしく解説 設計編・中級 #6・最終回】一本の登り道の、行き先 2026.07 北尾　英之 (@kitaohx) 1
2. 今回は、事例も症状もありません そして、新しい原則も、新しい質問も出てきません。 かわりに、5回ぶんの道具をすべて並べて、 　この中級編がずっと目指していた場所を、一緒に確かめます。 他の回へのリンクは、末尾の目次にあります。 ま え お き 2
3. 中級の質問、揃いました 質問 出どころ・古典 運転席に、何人座っている？ 中級#1・SRP その操作盤、使わないスイッチは？ 中級#2・ISP 形は合っていても、約束を守っている？ 中級#3・LSP 寄りかかる先は、自分より長生き？ 中級#4・DIP それ、足すだけで足せる？ 中級#5・OCP 一行に、原則は一つ。五行で、SOLIDです。 道 具 箱 3
4. 5つの症状を、ふりかえります #1 営業の変更で、梱包が止まった。運転手が二人いた #2 帳票の変更で、隣のビルドが割れた。操作盤が太っていた #3 形は合っていたのに、燃えた。約束が書かれていなかった #4 画面フレームワークの更新で、業務ルールが道連れ。寄りかかる向きが逆だった #5 足すだけが、足すだけで済まなかった。4つの症状が、重なっていた どの回でも、間違っていた人はいませんでした。 　あったのは、構造だけです。 ふ り か え り 4
5. ばらばらの原則は、一本の登り道でした ここで、中級#5を振り返ります。 　S・L・I・Dが手段の名前で、Oは目的地の名前。 　目的地は、既存のコードに触らずに、足せる ことでした。 では、なぜ「触らずに足せる」と、嬉しいのでしょう。 合 流 5
6. 目的は、原典に書いてありました 『クリーンアーキテクチャ』 。ロバート・C・マーティンの 　あの有名な本が、第1章で、アーキテクチャの目的を宣言しています。 求められるシステムの構築・保守に 　必要な 人材 を、最小限に抑えること。 （第1章の宣言・要旨） ここで「人材」と言っています。 　費用でも、コードの行数でも、設計の美しさでもありません。 原 典 6
7. 「人材」は、毎日、何をしているのでしょう 形に書けない約束は、言葉で貼っておくしかありません。 　それが張り紙でした（本編#3・中級#3） 。 　張り紙は、読まれてはじめて働きます。読む係は、人です。 読み直す。覚えておく。心配になって確かめる。 「触らずに足せない」システムは、読む係を必要とします。 　そのシステムは「人材」の注意力が燃料です。つまり、人が必要です。 現 場 7
8. 宣言に、いまの一行を代入します 人材の量を決めていたのは、注意力の量でした。 　とすれば、宣言のこの一語は、置き換えられます。 必要な 人材 を、最小限に抑えること。 　　　　　↓ 必要な 注意力 を、最小限に抑えること。 「必要な注意力を、最小限に」 。つまり、次の一枚になります。 ※この代入は、本連載の読みです。 代 入 8
9. 良いアーキテクチャとは、 少ない注意力で回るシステム のこと。 読み直させない。覚えさせない。心配させない。 9
10. 冒頭の5つの質問は、この定義を 　質問のかたちにしたものでした 中級#5を、思い出してください。 　質問に引っかかる場所では、注意力が削られていました。 5つの質問は、ぜんぶ同じことを聞いています。 　「ここは、少ない注意力で回っていますか」 この問いで、アーキテクチャの良し悪しを、測っていたのです。 　質問してみてください。自分に。メンバーに。AIでも。 種 明 か し 10
11. 最後に、ひとつだけ 明日、 「ここ、注意力を燃やしてるな」と感じる場所を、 　一つ見つけてください。コードの中でも、会議の席でも。 読まないと守れない張り紙。触ると心配な場所。 　毎回説明が要る決まりごと。 見つけたその場所では、 　毎日、誰かが、燃料を燃やしてシステムを支えています。 明 日 11
12. 中級編は、ここまで。 　問いをもって目的地へ S・L・I・Dが手段の名前で、Oは目的地の名前。 この目的地は、頂上（終点）ではなく、峠と捉えています。 　峠を登り切れば、向こう側が見えてきます。 この先の道は、いま切り開いています。 12
13. この回が借りたもの アーキテクチャの目的（人材の最小化） ロバート・C・マーティン著、角征典・高木正弘訳 『Clean Architecture 達人に学ぶソフトウェアの構造と設計』KADOKAWA、2018年 https://www.kadokawa.co.jp/product/301806000678/ （第1章の目的宣言を、本連載が一行に縮めたものです。スライド上でも「要旨」と明記しています） 引 用 元 13
14. この回が借りたもの（つづき） 「人材 → 注意力」の代入 前掲の宣言と本編#3（人間の注意力＝いちばん短命な持ち主）を 　合わせた、本連載の読みです。原典が「人材」で語る量を、 　本連載は、その人材が燃やす「注意力」で読み替えています。 「良いアーキテクチャとは、少ない注意力で回るシステムのこと」 上記の代入から得た、本連載の言い換えです。 定義に添えた三句「読み直させない。覚えさせない。心配させない。 」は、 　中級#5 の内容から #6 用に整えたものです。 また、本編#2の言葉で言えば、 　いちばん短命な持ち主に、基礎を預けないシステムのことです。 引 用 元 14
15. 【やさしく解説 設計編・中級 】目次 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 15
16. 【やさしく解説 設計編・中級 】目次（つづき） 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 16
17. 【やさしく解説 設計編 】目次 本文中にある「本編」はこちらです。 (導入編) DDDのコード、読めるのに分からない人へ https://speakerdeck.com/panda728/yasasikujie-shuo-she-ji-bian-number-0 1 「ドメイン駆動」と「実装駆動」ってなに？ 　キーワード： 軽量DDD 設計判断の出発点 DDDの肯定形の対義語 https://speakerdeck.com/panda728/yasasikujie-shuo-domeinqu-dong-to-shi-zhuang-qu-dong-tutenani-she-ji- noxing-wojue-meru2tunochu-fa-dian 2 持ち主の寿命のはなし 　キーワード： 所有性 依存先の寿命 公共構造（SQL・HTTP）とベンダー製品 https://speakerdeck.com/panda728/yasasikujie-shuo-she-ji-bian-number-2-chi-tizhu-noshou-ming-nohanasi 17
18. 【やさしく解説 設計編 】目次（つづき） 3 規約による保護と、構造による保護 　キーワード： ポカヨケ 型と制約で守る 人依存の規約は最下位層 https://speakerdeck.com/panda728/yasasikujie-shuo-she-ji-bian-number-3-gui-yue-niyorubao-hu-to-gou-zao- niyorubao-hu 4 何があなたの手を動かすのか 　キーワード： 変更理由の出所 単一責任原則の「責任」 要求の駆動源 https://speakerdeck.com/panda728/yasasikujie-shuo-she-ji-bian-number-4ben-bian-zui-zhong-hui-he- gaanatanoshou-wodong-kasunoka 18