1. readline.fm
  2. EP245 脳に収まるコードの書き..
2026-11-21 24:45

EP245 脳に収まるコードの書き方 PART2

おたよりを送る

## とりあげた本


Mark Seemann『脳に収まるコードの書き方 ―複雑さを避け持続可能にするための経験則とテクニック』オライリー・ジャパン、2024年


## mixi2

https://mixi.social/communities/513e0bc9-582b-4962-a9c1-c5c076175e08/about


## ShowNote

https://gennei.notion.site/EP245-PART2-41ac645d491181ac91c8f04ee9f0e1b6

感想

まだ感想はありません。最初の1件を書きましょう!

サマリー

Mark Seemann『脳に収まるコードの書き方』の第7章を中心に、コード分解とフラクタルアーキテクチャについて話す。人間の短期記憶は一度に約7項目までという前提から、ヘックスフラワーで関心事を整理し、詳細を適切な階層へ追いやる考え方を紹介する。抽象度を揃え、DB接続やHTTPなど本質でない要素を中心から外すことが、読みやすさにつながると議論する。後半ではAPI設計、利用者を想定した命名、抽象化、チームワーク、CI/CDやペアプログラミングにも触れる。

分解とヘックスフラワー
スピーカー 2
7章分解。ここは2人ともハイライトしてるというか、してますね。
スピーカー 1
そうですね。大体分解されてないコードを読むと辛いっていうのはありますからね。
どうやって分解したらいいの?って言われて、じゃあ全部一個一個、この文字列はこういう意味なんで、こういうオブジェクトを作ってみたいなことやって、
全部分解されると、逆に集まって何が出来上がるんだっけ?とかって、まあわかんなくなるので、じゃあどうやって分解するといいんですかね?みたいなヒントとかもあるって感じですかね。
スピーカー 1
どこら辺が面白かったですか?7章の中で言うと。 ここっていうのはなかなかちょっと言いづらいんですけど、
ここでフラクタルの話をしてますよね。フラクタルアーキテクチャーって話をしていて、フラクタルアーキテクチャーの話をする前には多分このヘッグスフラワーの話をしないといけないって感じですよね。
スピーカー 2
ヘッグスフラワーの話が出てくるのが7章の第2節ですね。7-2。ここが脳に収まるコードっていうタイトルになってて、タイトル回収ですね。
やっぱり最終回のサブタイトルがタイトルなのも好きですけど、この中盤でタイトル回収してくると、お、なるほどここからいよいよ本編が始まるのかみたいなワクワク感があって、これもこれで好きですね。
いやでも結局そういうふうにね、物語の構造にアクセントをつけるっていうのは大事っていうのはそういうことでもありますからね。
スピーカー 2
脳に収まるコード、前提として人間が1回で記憶できるというか、認知で収めておけるのは7つまでですよって話が出てきて、でもあらゆるレイヤーで7つ以上、7つより多いことするなっていう話の筋になって
くるんですけど、で出てくるのが今ゲイさんが言及してたヘッグスフラワーってやつですね。
スピーカー 1
まあヘッグスフラワーっていうのが7つのタイルが並んでいて、そこに1個テーマを決めてそこに関心ごとを埋めていくみたいな感じになっていて、だからそこに7つ以上のことがあるともうだんだんだんだんわか
んなくなっていくから、ちゃんとそこに収まるように作りましょうっていうのでヘッグスフラワーっていうのを導入してるって感じですね。
スピーカー 2
これ収録前にもねゲイさんと話したんですけど、あんまりこの図形には意味が特にないんじゃないかっていう話をしてましたが、まあ想像というか1回で扱えるのが7つまでだねっていうのはなんとなくすごい
わかりやすい図形だなっていう気はしますね。
スピーカー 1
うんうん。そうですね。
スピーカー 2
中心になるものがあって、それが6角形をしていて、その周辺、だから6辺にまた1個ずつ6角形が並んで、だから中心とそれに隣接する6つの6角形っていうことで、一発で能力を収められるのは7つだね
っていうようなお話と。
スピーカー 1
そうですね。で、ここがまあ最初に話してたワーキングメモリーが多い人とかになると、多分ここは7じゃなくて10とか、下手すると倍ぐらい頭に入るとこのタイルがもっともっと広く並ぶみたいな状態にな
って、いやちょっとそれは私には真似できませんみたいな感じになっていくっていうことがあるんだろうなって思いますね。
そうなんですよね。で、7つまでしか覚えられない人間は、それを超えてくるとやっぱりスワップが必要になってくるんで、メモリーの中身を入れ替え入れ替えして、非常にストレスがかかると。
スピーカー 1
そうそうそう。
スピーカー 2
メモリーリークもしたぞみたいなね、ありますから。
スピーカー 1
そうですね。ずっとここに残しておかないと言う、残しておくつもりじゃないのに、なんかあれそういえばあれって大丈夫だったんだっけとか言って、また戻ってこないといけなかったりとかして、っていうのがあ
って、でまあこれに対して、じゃあ言うてでもじゃあいっぱいリクエストのポストの値がいっぱいあるとか、そのポストの値の中のこと気にしないといけないとか、データベースが繋がってるのとか、外部サービスはどう
なんだとかって多分いっぱい出てくるんで、どうやるかって言ったら、
フラクタルアーキテクチャと抽象度
スピーカー 1
そこに対して関心事を減らせるように、業種度を上げていきましょうとか、そのタイミングで考えることを減らせるようにやっていきましょうとか、それで些細なことは、ここまで出てきたさっきのカプセル化の話だったり
とかもありますけど、
見なくてもいいようにするっていうようないろんなテクニックを使っていって、どんどんどんどん開けていくというか、その殻の部分を作っていく。で、より詳細なこと、その些細なことを気にしないといけないような
ことは、またそのもう一個下に深く入っていったときに、それがこのヘックスプラの中心に来て、またさらにその中で7つのことを考える。
まあ要はこれがフラクタルな構造になっていると、人間が理解しやすいよねっていうふうなことを書いていて、なんかここはやっぱり、自分はそういうふうに結構考えながら、そのディレクトリーだったりとかクラスだった
りとかソフトウェアのことだったりとかっていうのを考えてるから、なんかここはすごく共感できるなと思いながら結構読んでましたね。
スピーカー 2
分解していって詳細をどんどん奥にというか、それと一番深い関係があるオブジェクトとかクラスとか何でもいいと思うんですけど、そういうところに追いやって、なんか視界の外に出そうぜっていう話をしてますよね。
スピーカー 1
ちょっと誤解を恐れずに言うと、クリーンアーキテクチャとかで、あなたの大事なドメインの部分っていうのがあって、それの関係のないDB接続とかHTTPのリクエストの話とかっていうのは外側に追いやっていって、
真ん中が大事だから真ん中のその些細な部分は外に追い出して、中心的に必要なことを考えましょうっていうのはある種ちょっと似たような考え方でもあるよなって思いましたね。
スピーカー 2
ユースケースレイヤーなのにね、データベース接続がとか、ログはどうやって書くんだっけとかっていうのを中で扱ってるんじゃなくて、なんか抽象化したりね、疎結合にできるはずだから、なんかそれをやるべき人に押し
付けとこうぜっていう感じですよね。
スピーカー 1
それがなくて、あの形が大事だからとかって言って、レイヤーだけ作って、結局データベース接続してるやんけとか、JSONに変換すること知ってるやんけとか、いうことをやりだすと、結局旨味がないよねって、その大
事な構造が中心に来てるはずなのに大事じゃないものまで一緒についてきてるよねもあるし、結局人間の認知の問題としてもこの良くないよねっていう部分が一緒についてくるから、
そういうことも含めやっぱり、やっぱりより大事な言葉を中心にやって、些細なことは外に追いやるだったり、その下のもうちょっと愚症の方に寄せていくとかいうふうにソフトウェアを作っていけると、なんていうか読み
やすいソフトウェアになっていくんじゃないかなって気がしますね。
スピーカー 2
そうだからフラクタルって言ってるのが、ある視点から見たらこっちが愚症であっちが愚症だけど、そっちの、あっちって言ったのにそっちって言っちゃった、あっち側の愚症の中に一歩踏み込んで入ってみると、
今まで愚症に見なされていた自分自身がもう一個愚症だったりオーケストレーションの仕事をしてるし、
なんか自分よりさらに詳細とか愚症とかっていうのがまたあるよねーっていう意味で、フラクタルって言ってるような感じだし、関連オブジェクトは6つ、だから自分入れて7つまでしか覚えておけないからそこの上限
というか見やすとして7つにしましょうねっていう話をして、
エックスフラワーだしフラクタルだしっていうのを言ってるくだりですかねここら辺は
スピーカー 1
そうですねそうですね、またこの中心にあるものと周りにあるものの抽象度が全然違うと、なんかえらいこれは抽象度高いのにこっちはすごい愚症の話だなーとかなると、またそれはそれで辛かったりするんで、結局なんか
こう
なんていうかコンポーネント設計というか、その現実をどうやって捉えてそれをソフトウェアに変換してるのかっていうのがその人によって多分ものの見え方が違うんで、そこをどうやって上手に同じような抽象度で揃えら
れるかとかっていうことも結構大事だったりするんだろうなっていうのも思いますね
スピーカー 2
そうですねそうですね、なんかコントローラーの中にMとVが出てきてもいいかもしれないけど、なんか普通になんかデータベースドライバーみたいな話をコントローラーの中でできてきたら、あれなんか君はずいぶんと具
体的だねっていう感じがするよねとか、でもそこのあれですね君はなんか妙に具体的だねとか
っていう感覚ってだいぶ経験値によりそうですね
スピーカー 1
いや経験値によるし、今のその技術詳細の話だったら多分技術者としてはいろいろね、なんとなくこう経験を詰める分かるんだけども、それがドメインの話になった時に
なんかこれがお客さんとしてはこれの抽象でこれのサブタイプとしてこれがあるんだとか、こういう集合があってこれはその集合のサブセットなんですみたいなことがちゃんと理解できてないとなんかごちゃごちゃなコ
ードになってしまう、でもそれって技術が問題ではなくて対象のドメインの理解度の問題であり
それが結局ソフトウェアの読みにくさにつながっているってことに気づくってなかなか難しいんですよね
スピーカー 2
そうだよなぁ あれこのコードなんか読みづらいなーっていうのってめちゃくちゃ
スピーカー 1
躊躇の感覚ですよね多分 そうですねそうですね
スピーカー 2
それがあれば何でもやっていけるんだろう、要するに読みやすくすれば ok で結構いけると思うので
読みづらいってことは変に複雑だったりさっき言ってた抽象度、レイヤーが揃ってないとかっていうなんかいびつさがあるんだろうな
経験から学ぶ変更しやすい設計
スピーカー 2
っていう不吉なニオイがね感知できれば こんなの嫌だどうにかするんだって言えるから
スピーカー 1
だいたい気づかないよなぁ書いてる時って そうなんですよ
気づかなくて書いて動くものを見せて 次変更しようと思った時になんか変更しにくいなっていう時に
自分は今でこう捉えてたけどああそうじゃなかったんだ 自分のメンタルモデルと現実がずれてたんだってことに気づいて
あーなるほどなじゃあこうやって直すしかないんだなみたいなことがまあ経験上多々ありますね
スピーカー 2
そうだよなでも難しいなそうですよね 最初から取りができたら苦労はしねえんだっていうのと
そう まあでもここになんか落ちてきそうだなっていうところをスッと避けとくとか変えやすく
なんか切り込み入れとくじゃないですけど そういうのは上手くなってると思うんだよな年次を上がるにつれて
スピーカー 1
多分この行動を見た時に何があったら嫌かなみたいなことは多分想像がつくようになってくると思うんですよね
そのいっぱい経験してるとだから多分ここにこういうことが来たらもしこれを今1対1対応だけど
1対nにしないといけないことがあった時にはじゃあこういうような対応しようかとか ここが今は必ず
そのなんか1対1対応になってるけどなくなる可能性があるかもしれないとか今は必須になってるけど
えっとヌル許可したいみたいなことがあった時じゃあどうしようかとかいうこととかをこう
とかまぁなんかある条件を考えた時に今は 俺がじゃあトゥルーだったらだけど
なんかお客さんの話を聞いてるとどうやろう なんかこの後条件増えそうだなみたいな気配をなんとなく感じるとか
スピーカー 1
なんかそうなった時にじゃあこのルールっていうものを外側から入れられることにし とけば柔軟に対応できるようになるかもしれないしプライベートメソッドに切っておけば
このプライベートメソッドの中だけを直せばいいのねとか まあ条件に足りないものがあったら引数で増やして中でそれを渡すものを増やして
あげたらいいよねとか なんかいろんな多分対応の仕方をやる中で身につけていくから多分本当にソフトウェアを
ちゃんとソフトに作れるようになっていくんだろうけど まあでもなかなか最初にそれに気づくっていうのは
スピーカー 2
まあうまくいかないですからね うまくいかないしなんか本当に全く最初から思いも寄ってない変更
っていうのが入った時にまあどうにかするのは なんていうんですかね気合が入りますからね
気合が入りますね あんまり気合が入ることやりたくないんだよな
スピーカー 1
そうやりたくないから 多分
我々とか多分経験を積んでいく中でなんかどうやってAIっていうのをやると便利らしいぞとか
やっぱりちゃんとプライベートに切り出しておくといいぞとか やっぱクラスの設計とかその
事前条件事後条件の話とか あとインターフェースってやつはマーカーになって便利だなとか多分いろんなことを覚えて
スピーカー 2
たんだろうなって気がしますね すごいですよねなんかやっぱり流行るプログラミング言語って本当によくできてるな
みたいな 気がしますよねいさそうこの機能を使うわありがとうございますみたいな
スピーカー 1
そうそうそうそういやほんとそうなんですよ
スピーカー 2
ね自分が言語のデザインとかやって何も知らない状態で何も知らない状態でプログラミング言語を作るってなんだよって話なんですけど
インターフェースとか思いっけないと思うんだよな
スピーカー 1
実装を持たないものをわざわざ用意するってこれ何なんでしょうねって気持ちになりますからね
だってアブストラクトでいいじゃんみたいな話とかもできちゃうわけじゃないですかある意味では
スピーカー 2
そうそうそうそうアブストラクトとかだったらねまだのコードの再利用というか手続き
をプロシサブルーチみたいな感じ固めで外に出すみたいなところの延長でまだいけそう
クラスソースにひな形みたいなのがあってそこに再利用可能なものにしてみたいな
インターフェースはなぁ 追いつかないよな
スピーカー 1
インターフェースをちゃんと使えるようになってきたなって思ったときに こんなレベルになるもんだこれって思ったことは本当に
本当にいやすごいなぁと思いましたねしかも なんか php ってまぁある種こうインターフェースなしでもできるっちゃできるわけじゃないですかその
お決まりとしてこのメソッドを持っていてこういう会議所を持つってことを強制させ なくても
まあやろうと前は動くっちゃ動くのでなくてもできるんだけど なんかそれっていつも不安だなぁとか思ってたら
なるほどこれ使うと強制できるんだみたいなことを持った時にあれつまりこれも あれもできるじゃんみたい思っていくと便利ってすごい思いましたね
うーん そうすよねだって自分でインターフェースを初めて作ったのとプログラミング初めて
スピーカー 1
5,6年目ぐらいな気するからな うーん
スピーカー 2
あーでも凄かったですよでもそのインターフェースはまるで インターフェースとして機能してないなっていうのにその2ヶ月後ぐらいに
設計が破綻したんで まだ動いてるのかな申し訳ないな
スピーカー 1
まあねやっぱりそのインターフェースの切り方1個取っても結局またそこにはこういろんな経験値が必要なんやなぁみたいなとか
そうですね 昔ソリッドの話を聞いた時とかに
カンファレンスで会場から質問でそのインターフェースの切り方をうまくできなかった時にはどうするんですかとかどうやったらうまく切れますかみたいな質問に対して
まあ経験度感ですみたいなでダメだった時はもう一回書き直しましょうって答えてて まあでもやっぱそういうそういうもんかってちょっと思っちゃったことありますね
スピーカー 2
そうなんか困ったり行き詰ったなって感じたら書き換えようっていうのを
なんかね湾力ついてくると言われちゃうから そんなもんだなーって思いながら仕事してるからな
しかも今その湾力がね増幅器がいっぱいありますからね ああまあそうですねそうですね
スピーカー 1
なのでこのどうやって分解していくか 分解することの大事さとどういう方針で分解するかみたいなのはこの書はやっぱり
なんていうかすごい助けになるというかヒントになるものはたくさんあるし やっぱフラクタールみたいなものを知ってると知らないとではまあなんかとりあえず分解
しましたって言ってこう関数に切り出したものだけをこう なんかとりあえず分解したけどなんかこれでどうやって全部スタティックで呼び出すんだっけ
みたいなことになっちゃったりとかもするし
相互に関係ないというか領収してないけど そう
スピーカー 2
なんか同じクラスに 兄弟めそっといるなぁみたいな
スピーカー 1
そうそうそうそう
ブーブー 辛い辛くなるから
でまぁまぁトレートにするとか多分色いろんなやり方はあると思うんだけどまぁ ここに書いてあるのことを読みながらどうやったらその
まあいろんなことを気にしなくて済むかとかどうやったら中小度が揃うかとかがそう いうようなことを考えながら
スピーカー 2
まあここのショートカー4メールとすごくいいんだろうなっていうのはやっぱ覚えましたね なんかこう7章のね最後の
文章もいい結構いいんですよね 8フラクタルアーキテクチャは自然発生するものではありませんが実現できれば高度はレガシー
コードと比べて遥かに理解しやすくなります ほとんどが短期記憶で済むからですって書いてあって
そうなんですよ いいですよね今目の前で今まさに目撃したものだけで話が成り立つぐらい
まあシンプルって言うとまたいろいろあるんでしょうけど 話が単純にされてて
それが何でかっていうとなんかまあさっき言ったレイヤーが違ったり ちょっと君がわざわざ表舞台に出てくる必要ないんじゃないのみたいな
どうぞうぞうぞうが恥に追いやられているから 何が言いたいかが分かりやすい短期記憶で済むって
スピーカー 1
良いですよね 良いですね
まあだからそう考えるとマイクロサービスとかってやっぱ大変だなって気持ちにもなるし
出てくるプレイヤーが少ないマイクロサービス設計ができるといいけど 結局なんかあれもこれも繋がないとってやると
辛くなるし
スピーカー 2
ある種ソフトウェア設計のなんてか肝ってここかもしれないなって気もしますね 構造化ですからねやっぱりね
スピーカー 1
そうですねなんかこう近所さんから構造化って聞くと構造化プログラミングのことを思い出してしまう
スピーカー 2
まあまあまあでも大工さんが言ってる通りだと思うので
人間がわかるぐらい抽象化しろっていう話じゃないですか あの人だって物に収まるコードの書き方の話をしてるんだから
スピーカー 1
そうそうそうソフトウェア機器でこれ以上複雑なもの作れないんじゃないかって言って出てきたんですね 構造化プログラミングだったりするわけだから
スピーカー 2
まあいいですね そうだなそうですね7章な面白いな
いいですねいいですね じゃあまた次というか別の話に
スピーカー 1
いきますか いきますか
API設計と抽象化
スピーカー 2
どこらへん8章API設計でアフォーダンスの話が 出てきましたねでもなんかゲインさんがここメモ入れてないから
このホットトーストアフォーダンス触れなくていいんだっけって思って
スピーカー 1
アフォーダンスなのかシグニファイアーなのかどっちかなーとかっていうのは思ってたんですけど多分なんかそういうことを突っ込む本じゃないよなって思いながら
そうですね あんまり用語法が危ういなーって思いながら読んでたけど
スピーカー 1
まあいっか そうですねまあポカイオ系の話があったりとか
だからこのAPIっていうのはあれですよねなんかウェブのAPIっていう話っていうよりはもうちょっとその本当にプログラミングインターフェイスですよねアプリケーションプログラミングインターフェイス
スピーカー 2
そうですねパブリックメソッドとかもうちょい広めにとってるかもしれないですね
スピーカー 1
使われどういうふうにシグネチャーみたいな話かな 使う側がどういうことが
早期するかとかどういうふうに使われるかってことをちゃんと想定しておきましょうねっていう話っちゃ話な気がしますね
スピーカー 2
読む人のために書くとか コメントよりもわかりやすい名前のコードをとか
スピーカー 1
そこらへんの話がねちゃんと書いてありますね 最後のまとめのところでもう1回
僕はあのさっきのアンケルボブの抽象化とは無関係なことを排除して本質的なことを増幅するものであるが
惹かれたりとかしててやっぱりこの本すごい好きなんだなっていうのは思いますね
これこの後もまた引用されてますよね 知ってた
いやーでも究極ですよねこれ そうなんですよそうなんですよ
スピーカー 2
だってVMとかだって同じことですよね言ってみたら
そうですねそうですね 物理CPUみたいな話は一旦後でどうにかするからみたいな
スピーカー 1
そうそうそう そうなんですよねだから結局なんか
プログラミングって抽象化のどれぐらい抽象化できるかっていうことをずっと繰り返してるというか
CPUのレイヤーからねだんだん抽象の方に行くにつれて
でまぁ究極的にはそのローコードノーコードとかAIがみたいな話に行くわけですもんね抽象度が上がってって
そうでマシンパワーがね上がってますからねやっぱり そうですね
スピーカー 2
我々はこの前ねコボルとかフォートラムが生まれる時の話を読んだわけじゃないですか
スピーカー 1
あれだってスピードコーリングの話だったし ありましたね
スピーカー 2
いやずっと同じ話をしてるんだよなだから多分
スピーカー 1
でもまぁある種それが本質だから同じ話をしてるっていう部分もあると思うんですよね
スピーカー 2
うんだと思います
チームワークとXPプラクティス
スピーカー 1
っていうのがAPIの話であとはチームワークですかね
スピーカー 2
チームワークねまぁチームワークもね書くことよりもコミュニケーションに注力せよとかそういう話がされてたり
あとあのめちゃくちゃXPの技術サイドというかプログラミング
えっとプラクティスっぽい話あのCICDとかコードの相動所有とかペアプログラミングとか
話が出てきたり
スピーカー 1
そうっすね
スピーカー 2
つつですけど
まぁでも第二部入っていきますか
スピーカー 1
いきますかちょうど1時間で折り返しって感じですね
あ、すごい
スピーカー 1
すごい
スピーカー 2
めちゃくちゃすごいな
スピーカー 1
こんなに順調にいってるエピソードがあるなって
これは盛大なフラグですみたいな感じ
スピーカー 2
あの別に2時間撮らなくていいんですか
スピーカー 1
そうそうそう
24:45

コメント

スクロール