仕様が曖昧な開発こそ、変わりにくいコアを探す──『ライティングソフトウェア』5章までの学び

『ライティングソフトウェア』を5章まで読んだ。特に印象に残ったのは、変わりにくいビジネスの本質を見極め、変わる部分を切り分けて設計するという考え方だ。

これを読んで、仕様が定まらない開発のやりづらさも、少し説明できる気がした。何をつくるかだけでなく、何を前提として残せるかがわからないから、変更のたびに広い範囲を考え直すことになる。

ここでは、5章までの読書メモをもとに、自分なりの理解と開発への気づきを整理する。

目次

仕様が曖昧だと、設計のどこを残せるか判断しづらい

仕様が定まっていないと、実装を進めても、後から大きく変わるかもしれない。どこまでつくり込んでよいか迷う。

この難しさの一部は、コアとなるユースケースが明確でなく、変わるところと変わりにくいところを分けられていないことにありそうだ。

コアのユースケースとは、個別の操作や機能の背後にある、ビジネスとして共通して実現したいこと。これが見えていれば、細かな仕様が変わっても、設計の軸を持てる。

仕様の不確かさをすべてなくすのは難しい。それでも、何が変わっても残りそうかを言葉にすることはできる。

変わりにくい処理を抽象化し、変わる部分を部品に閉じ込める

目の前の機能ごとに実装すると、その機能に必要な処理を一か所にまとめたくなる。すると、仕様が変わったときに、本来は共通で使える処理まで一緒に変更することになりかねない。

そこで、共通する責務を抽象化し、変動する部分をそれぞれの部品に閉じ込める。呼び出す側が、部品の内部の事情まで知らなくても使えるようにする。

たとえば、説明用に注文処理を考えてみる。「注文を受け付け、成立させる」という目的は共通でも、支払い方法や通知先は変わるかもしれない。

この場合、支払い方法ごとの違いを独立した部品に閉じ込められれば、支払い方法の追加が注文処理全体の書き換えにつながりにくくなる。

自分が「変化する部分の対応が、コアを呼び出すだけになる」と感じたのは、このことだと思う。より正確には、コアを使いながら、必要な部品の追加や差し替えで対応できる範囲が増えるということだ。

処理の中身と、呼び出す順序を分ける

コアの処理を担うエンジンと、それらを呼び出して流れを調整する役割を分ける、という話もここにつながる。

自分の理解では、責務は次のように整理できる。

  • エンジン:まとまった処理や判断を担う。
  • 調整する側:必要な処理を選び、呼び出す順序を決める。
  • リソースにアクセスする側:データベースなどとのやり取りを担う。

この分担ができていれば、処理の中身を保ったまま、組み合わせ方を変えられる。

また、タスク同士の不要な順序依存を減らせば、別の流れでも使いやすくなる。業務上必要な順序は残しつつ、実装の都合で生まれた依存を増やさないことが大切だと感じた。

全体の構造を考えてから、少しずつつくる

家づくりで考えると、全体を見据えて設計する意味がイメージしやすい。

将来2階を増築するなら、それを支えられる土台や構造が必要になる。台所や部屋を別々につくってからつなぐだけでは、建物全体として成立するとは限らない。

ソフトウェアでも、全体の構造を考えながら、少しずつ実装していく必要がある。

将来の機能をすべて先につくる必要はない。ただ、想定する変更が来たときに、どの部品で受け止めるかは考えておきたい。

構造の対称性は、責務の偏りを見つける手がかりになる

優れたアーキテクチャには対称性がある、という話も印象に残った。

自分はこれを、似た役割の部品が似た構造を持ち、部品のつなぎ方に一貫性があることだと受け取った。

たとえば、一つの部品だけが多くの役割を抱えていたり、一か所だけ特別な呼び出し方をしていたりする。その違いに理由があるのかを確かめることで、責務の分け方を見直せそうだ。

見た目を無理に揃えるのではなく、構造の違いを設計上の問いとして扱いたい。

個別の要件の背後にある、共通のユースケースを探す

要件に合わせてデザインしてはならない、という考え方は、最初は少し不思議に感じた。

自分はこれを、個別の要件をそのまま設計の分割単位にせず、その背後にある共通のユースケースを捉える、という意味で理解した。

機能が増えるたびに専用の処理を増やしていくと、似た処理が散らばり、変更の影響も追いにくくなる。先に共通する責務と変化の境界を考えれば、新しい機能を既存の部品の組み合わせとして捉えやすくなる。

機能をインテグレーションの問題として考える、という学びもここにつながった。個々の部品を実装する力に加えて、組み合わせて使える形に分ける力が必要なのだと思う。

コアも仮説として確かめながら、設計の軸にする

もちろん、すべての仕様変更が、部品の差し替えや呼び出す順序の変更だけで済むわけではない。

ビジネスへの理解が進めば、コアだと思っていたものを見直すこともある。変わりにくい部分も、最初は仮説として置き、具体的なユースケースに照らして確かめたい。

これから仕様が曖昧な開発に向き合うときは、まず次の三つを言葉にしてみようと思う。

  • このシステムは、何を実現するためのものか。
  • 個別の仕様が変わっても、残りそうな責務は何か。
  • 変わりそうな部分を、どの部品に閉じ込めるか。

5章まで読んで、仕様の不確かさに対して、設計からできることが少し見えてきた。