HN 日本語サマリー

← 一覧へ戻る
プログラミング

現時点での最良のシンプルなシステム

Best Simple System for Now (dannorth.net)

70 pointsby daan-k15 コメント

要約

本記事は、ソフトウェア開発における「完璧主義」と「実用主義」の二項対立に対し、第三の道として「現時点での最良のシンプルなシステム(BSSN)」という考え方を提案しています。BSSNは、現在の製品ニーズを満たす最もシンプルなシステムであり、将来を予測せず、必要最低限の堅牢性を持つコードで記述されます。このアプローチは、過剰な設計や技術的負債の蓄積を防ぎ、変化への適応性を高めることを目指しています。

全文翻訳

現時点での最良のシンプルシステム

目次

2025年2月3日 26分

ケーキは、丁寧に焼けば、食べながら持っておくことができる。

「手っ取り早く済ませて後で代償を払うか、丁寧に進めて今代償を払うか」これはソフトウェア開発における根本的な二分法、つまり「完璧主義」と「実用主義」の間のトレードオフのように見えますが、私はそれがまったくトレードオフである必要はないと考えています。

CTOの友人は、山を登るための2つの道を切り開くという比喩を使います。左側の道は、マチェットと力任せで切り開かれた、手っ取り早く汚い道です。誰もついてくることを期待せず、ただ道を切り開くだけですが、すぐに進歩します。右側の道は、より広く、より明確で、舗装された道であり、より堅牢ですが、進みながら時間をかけて建設する必要があります。左の道は、道の先に何があるかを確認するために、先行偵察に役立ちます。右の道は、道が安全であることを知って、皆を導く場所です。

私の友人は、左の道を進む人々(彼は取引会社に勤めているため、この議論は非常に重要です!)と、回復力があり持続可能な製品を構築したい右側の道の人々との間で、常に緊張状態にあります。

これは私が関わってきた多くの組織を説明しています。両側の緊張は、「反対の方法」が間違っているという考えに基づいています。右側の道 advocates は、左側の人々が後で自分たちを苦しめることになる技術的負債を積み上げているのではないかと心配しています。左側の人々は、右側の人々が「完璧主義者」であり、過剰に設計し、金を磨いている(そしてしばしば多くのビジネスマネージャーがそれに同意するために並んでいます)と考えています。

私は、両側が見落としている中間道があることを提案します。私はこの道を現時点での最良のシンプルシステム(Best Simple System for Now)、またはBSSNと呼びます。この考え方を形成するのに長い時間がかかりました。これは長年「公然の秘密」として隠されていました。これを示唆する、あるいは少なくともヒントを与えるいくつかのソースアイデアがありますが、私はここでそれを認識したいと思います。しかし、それは明示的に述べられたのを見たことがありません。それでは、ここにあります。

現時点での最良のシンプルシステムの特性 #

現時点での最良のシンプルシステムとは、現時点で製品のニーズを満たす最もシンプルなシステムであり、適切な基準で記述されたものです。余分なコードや過剰に設計されたコードはなく、存在するコードは必要なだけ堅牢で信頼性が高く、それ以上でもそれ以下でもありません。

「現時点での最良のシンプルシステム」というフレーズの各部分は意図的であり、各部分は相互に強化し合います。いずれかの部分に逸脱があれば、それはもはや現時点での最良のシンプルシステムではなく、厳密には弱いものになります。それぞれの部分を詳しく見ていきましょう。

現時点での #

システムは将来を一切予測すべきではありません。これは、私がプログラマーとして受けた、あるいは与えたほぼすべての助言に反します!

プログラマーが問題に手を出すと、私たちは一般的な解決策に偏ります。それに関するxkcdもありますので、真実であるはずです。

[画像: xkcd comic ‘The General Problem’]

私たちは「それはルールエンジンだ!」や「それはステートマシンだ!」から、ほんの少しの飛躍しか離れていません。そのため、効率的なエンジニアリングの精神は、時間を節約し、手戻りを減らすために、この解決策をすぐに採用することを決定します。この決定の一部は、各変更にはコストがかかるという知識であり、私たちが「必要だとわかっている」一つの大きなステップを踏むよりも、そこに至るためにいくつかの小さなステップを踏む方が常に非効率的であるということです。

私たちは、意識的な処理のために、自動的かつ無意識的なパターンマッチングに依存します。ダニエル・カーネマンの『ファスト&スロー』では、これらをそれぞれシステム1とシステム2と呼んでいます。パターンマッチングは無意識のシステム1活動です。私たちはそれに長けており、自然にやってきます。「実際に見えているものを見る」ことはより難しく、意識的な思考と努力が必要です。

現時点での設計はこれの対極です。それは、あなたの脳が提示するパターンにもかかわらず、実際に見えているものを見る技術です。これがBSSNの核心です。これは「バイソン」と発音されるかもしれません。私たちが通常シェービングすることになる多くのヤクの仲間として。

シンプル #

何かを設計するとき、通常は対立する2つのバージョンの私がいます。「賢い」私、つまり数十年分の経験と大きなエゴを持つ私です。この部分は次に変更されるだろうと「知って」いるので、それをインターフェースにするべきです。あるいは、私たちは「ほぼ間違いなく」この量のデータを扱うだろうから、単純な逐次アルゴリズムではなく、この並列処理アルゴリズムを構築することにしましょう。より謙虚な私は、私の予測は常に少し間違っているだろうと知っています。以前何度もそうであったように。だから、今は保留にしておきましょう。より謙虚なバージョンは通常負けます。

だから、未来が起こると、私は2つのモードのいずれかになります。私の予測が次に起こったことと少し違っていたため、私が作った仮定の周りで作業するか、あるいは私が望む方法で柔軟にコードを変更できるように、コードを元に戻して変更します。しかし、心配しないでください、私の賢い自己は私に保証します、これは一度きりのことでした、そして次回は正確にそれを正しく行うでしょう!これは私に何度も起こります。私は30年以上お金のためにソフトウェアを書いてきましたが、もうこれでわかったはずだと思うでしょうが、いいえ。

これらの何年にもわたって多くのコードベースを見て、その中で作業してきた経験から、私はそれが他のすべての人にも起こっていると静かに確信しています。私が遭遇するほとんどのコードは、投機的な継ぎ目とインターフェースを持っており、それは何十年も前のものです。そして、それは決して利用されませんでした。アルゴリズムや技術の選択は、それが提供する12人のユーザーではなく、20,000人の同時ユーザーにとっては素晴らしかったでしょう。拡張性や柔軟性のためのフックや拡張ポイントは、私の想像を絶するもので、おそらくこれは彼らの代表作システム、彼らのキャリアを定義するシステムになるだろうという希望のもとに書かれました。そしてもちろん、このコードは、これらすべての複雑さの相互作用による微妙なバグで散乱しています。

私が繰り返し学んだことは、シンプルさは現在の関数であるということです。言い換えれば、私は現在の要件と制約、そしてそれ以外の何ものためにも、最小限の複雑さを常に探しています。これらの要件と制約が変更されると、「シンプル」の定義もそれに伴って必然的に変更されます。

完成は、付け加えるものがなくなったときではなく、取り除くものがなくなったときに達成される。

— アントワーヌ・ド・サン=テグジュペリ

この定義によれば、私たちは完成を求めています!現在のシステムから何かを取り除いても、それが現時点での必要とするものをまだ満たしているなら、それは決してそこにあるべきではありませんでした。

BSSNは、あらゆる可能な未来に対応することによって「将来性」、「スケーラビリティ」、または「柔軟性」を達成するのではなく、私たちが望むように柔軟にできるほどシンプルであることによって達成します。より高い負荷を処理する必要がある場合、それを達成できると確信しています。より広い範囲の入力を管理する必要がある場合、あるいは異なる検証を提供する場合、あるいは予期しない上流または下流のサービスと統合する必要がある場合、それもできると確信しています。まだ考慮すらしていない次元に沿って進化する必要がある場合でも、他のどのソリューションよりも少なくとも容易にそれを実行できるでしょう。

投機的なインターフェース、過度に広いデータ型、具体的なコードが適している場合に汎用的な機能はありません。代わりに、それは非常に意見が強く、意図的に狭い設計になっています。

逆に、私はギャルの法則1を、エンタープライズデータ辞書から汎用ワークフローソリューション、クリック操作で設定可能なルールエンジンまで、無数の回数実社会で経験してきました。そこには、失敗への避けられない3〜5年のサイクルがあります。

動作する複雑なシステムは、動作するシンプルなシステムから進化したものであることが常にわかっています。ゼロから設計された複雑なシステムは決して動作せず、動作するようにパッチを当てることもできません。動作するシンプルなシステムからやり直す必要があります。

— ジョン・ギャル

最良 #

物事をシンプルに保つことは、手抜きを意味しません。どのような状況でも、物事を正しく行う方法があり、私たちはそれを実行することを選択できます。完璧主義者と実用主義者の両方にとっての課題は、「正しい方法」は文脈依存であるということです。コアビジネス機能を支えるコードは、実験的な機能のスケッチよりも高い品質基準を持つべきです。一方に投資不足であることは、他方に投資しすぎるのと同じくらいリスクです。前者の場合、リスクは安定性と回復力です。後者の場合、機会費用であり、これは以下で議論します。

さらに、コードを「スケッチ」する能力は、堅牢で回復力のあるソリューションをエンジニアリングするのと同じくらい重要なスキルです。スケッチはハッキングを意味しません!私は、うまくスケッチできる人よりも、「まともな」コードが得意なエンジニアをはるかに多く知っています。スケッチとは、後で空白を埋めることができる(または最小限の投資でスケッチを捨てる)ことを知って、方向性を維持するのに十分な品質を提供することです。ハッキングされたコードはすぐに管理不能になります。うまくスケッチされたコードは、実際のものの軽量版にすぎません。

ウォード・カニンガムが「可能な限り最もシンプルなもの」について語ったとき、彼はこれを意味していました。彼は単純さのプラトン的な理想を呼び起こしていたのではなく、彼の理解を進めるために試すことができるどんな小さなステップをも意味していました。2004年のビル・ヴェナーとの素晴らしいインタビューで、彼は「それを書くという行為そのものが私たちの考えを整理した」と述べています。

最良のコードは意図を明らかにするものです。それは凝集性と結合度のバランスを取り、ナビゲートしやすく、推論しやすく、変更しやすいものにします。

重複、あるいはそれ以上に、コード内のアイデアのニア重複がある場合、それは最良のコードではありません。逆に、コードが執拗にDRY(Don't Repeat Yourself)であり、2つの場所のコードが似て見えたという理由だけで結合度が高くなっている場合、それは最良のコードではありません。コードがドメイン用語を前面に押し出さず、実際のユースケースに直接マッピングされていない場合、それは最良のコードではありません。

私は、私が良いコード、楽しいコードと考えるものについて書きました。それは私がCUPIDとして定式化したものです。

  • Composable(構成可能): 他のコードと仲良く機能する;最小限の依存関係を持つ
  • Unix philosophy(Unix哲学): 1つのことだけを、明白かつ包括的に行う
  • Predictable(予測可能): 動作、観測可能性、実行時特性、障害モードにおいて;変更したときに何が起こるかにおいても
  • Idiomatic(慣用的): この技術に経験のある開発者にとって馴染みのあるパターンとイディオムを使用する
  • Domain-based(ドメインベース): 名前、動作、コード構造において意図を明らかにする

重要なのは、ハッキーで「実用的」なコードと同じくらい、あるいはそれ以上に速く、楽しいコードを書くことができるということです。CUPIDは、リチャード・ガブリエルの「コードの居住性」のアイデアに基づいています。彼はそれを、コードベースで作業する際に快適で自信があると感じることだと説明しています。

最良のコードを書くために、数日または数週間の深い熟考は必要ありませんが、素晴らしい習慣は必要です。これらの習慣は時間をかけて開発され、理想的にはこれらの価値観を持ち、それを共有するのに十分な関心を持つ人々と一緒に働くことによって開発されます。私は、時間と知識を惜しみなく提供してくれる人々と一緒に働く幸運に恵まれました。時々それらについて話します。

ペアプログラミングやテスト駆動開発のようなXPテクニックは、良いコードの前提条件としてよく言及されますが、熱狂者やイデオロギーに惑わされないでください。これらのテクニックは単なるツールであり、必要でも十分でもありませんが、しばしば役立ちます。

私はこれらのテクニックの熱烈なファンですが、テスト駆動開発を使用しない巨大なCおよびC++コードベースで、よく構造化され、意図を明らかにし、ナビゲート可能なコードを扱ったことがあります。逆に、凝集性がまったくなく、ドメイン理解が悪く、変更するのが苦痛な、テスト駆動コードに苦しんだことがあります。まるで複式簿記のようなコードを通り抜ける必要がありました。それどころか、私もそのようなコードを自分で書いたことがあります。今思い出すと身震いがします。

BSSNに対する反論 #

現時点での最良のシンプルシステムを書くことに対するいくつかの反論を見てみましょう。

プロトタイプには過剰である #

目的を果たしたらすぐに捨てるコードに、「最良」のコードとして投資する意味は何ですか?

多くのプロトタイプは本番環境に移行します。その時点で、私たちはそれを新しいことに適応させたいと考えます。プロトタイプは単なるハックだったので、新しい機能を追加する良い方法がなく、どこにでも押し込みます。成功したプロトタイプはリリース前に書き直されるのではなく、リリースされてから構築されます。

else-if の分岐が2つか3つしかない場合、もう1つ追加しても大きな違いはありません。20〜30の分岐がある頃には、もう1つ追加しても大きな違いはありません。この混乱全体をクリーンアップすることが、エッジケースや条件をもう1つ追加するよりも効率的になる適切なタイミングは決してありません。ただし、私たちがそれを選択しない限りは。

したがって、私たちの選択肢は、混乱を受け入れるか、書き直すか、あるいはそもそもこの状況に陥らないかのいずれかです。私の好きな技術者の1人であるランディ・ショウプは、デジタルビジネスがスケールアップする際にスタック全体を書き直さない場合、おそらく最初に過剰に設計したのだろうと言っています。ほとんどの場合、これは真実だと信じていますが、現時点での最良のシンプルシステムを維持した数少ないケースでは、彼らは単に書き直す必要がありませんでした。

Metaに買収される前、WhatsAppは13人程度のエンジニアによって構築・管理されたErlangコードベースで5億人以上のアクティブユーザーにスケールしました。同様に、SQLiteリレーショナルデータベースは、歴史上最も広く展開されているソフトウェアの1つであり、事実上すべてのブラウザ、デスクトップ、ラップトップ、モバイルデバイス、サーバー、およびその他の多くのコンテキストにインストールされています。そのコアチームは3人で構成されており、コードの提出は受け付けていません。

不完全である #

製品が何をすべきかわかっているのに、なぜユーザーは中途半端なバージョンを許容しなければならないのですか?

一言で言えば、顧客のニーズの一部をより早く満たすことは、Win-Winだからです。ほとんどの顧客のニーズはパワー曲線のような形をしています。主なメリットは機能の一部にあり、残りは減少する利得です。ATMから現金を引き出すことは、印刷されたレシートを受け取り、残高を確認し、PINを変更することなどよりも優れています。

最初のiPhone(2007年発売)は、3Gの世界における2Gデバイスでした。他のスマートフォンとのネットワークパリティに到達するにはさらに1年かかり、メッセージやメール間でコピー&ペーストできるようになるまでにはさらに1年かかりました!それでも、iPhoneはNokiaやBlackBerryのような「揺るぎない」既存企業から市場を奪い、後続バージョンにこれらの機能を追加していきました。

一部の製品は、小規模ながらも意見のある機能セットで差別化を図っています。Googleドキュメントは、設計上、Microsoft Wordができることのほんの一部しか行いません。GoogleスプレッドシートもExcelと同様です。Google Workspaceは、この小さなサブセットがほとんどの人々のユースケースのほとんどの時間をカバーしており、ブラウザ以外のソフトウェアのインストール、更新、パッチ適用、セキュリティ保護、監査の必要がないという利点があるため、Microsoft Officeの競合となっています。これにより、企業にとって調達とライフサイクル管理が魅力的になり、新しいユーザーにとっては学習曲線が緩やかになります。

小規模で頻繁なデリバリー、早期の顧客成功、豊富なフィードバックの議論は何度も行われてきました。BSSNは、不完全な製品を出荷することが、コード品質、デリバリー速度、またはユーザーエクスペリエンスを犠牲にすることを意味しないという観察を追加します。

リチャード・ガブリエル(居住可能なコードの提唱者)は、このアイデアを「悪い方が良い(worse is better)」と説明しています。1990年代初頭、彼はLispよりもC言語が普及していることに失望しましたが、驚きませんでした。なぜなら、彼の考えではLispの方が優れていたからです。不完全で、一貫性がなく、過度に複雑な言語であるCが、シンプルで、正しく、一貫性があり、完全な言語であるLispよりも好まれたのはなぜでしょうか?彼は、CとUnixが完璧なコンピュータウイルスである理由と、「悪い方が良い」理由について、面白い長文で論じています。不完全な製品を出荷してそれを反復することは、すべてが準備できるまで待つことよりも良いのです。たとえ反復バージョンが「完全」にならなくてもです。

余談ですが、Common LispとSchemeを比較して、彼は設計と構築に多大な労力を要し、運用に複雑なツールを必要とするビッグで複雑なシステムと、設計には永遠にかかるが、常に非常に小さいダイヤモンドのような宝石との間の別の二分法を説明しています。後者は現時点での最良のシンプルシステムに非常に似ていますが、BSSNとの違いは、各ステップで機能的で使いやすいシステムが存在することです。

非効率である #

なぜ絶えずコードをリファクタリングし、やり直すのですか?なぜ最初から正しくできないのですか?

製品開発に時間とお金を費やすことを選択するとき、あなたは投資リスクに基づいた決定を下しています。期待される収益は、期待される支出を超える必要があり、あなたが快適に開始できるだけの十分なマージンが必要です。これは投資収益率(ROI)または資本収益率(ROC)として知られています。製品構築に費やす金額が少ないほど、同じ収益を前提とすれば、より多くの利益が得られます。では、なぜ製品を継続的にやり直したいと思うのでしょうか?確かに、これは利益率を侵食するでしょう。

答えは、いつそのお金を稼ぐかを見ることです。金融用語では、今日のお金は明日のお金よりも価値があります。あるいは、明日のお金は今日のお金よりもリスクが高いです。ペイオフが遠いほど、不確実性は大きくなります。将来の収益を期待して何かを構築するために費やすお金は、リスク資産価値(Value at Risk、VAR)と呼ばれます。

グランドリリースを最後に持つビッグバンプロジェクトは、プロジェクトのライフサイクル全体でVARを積み上げています。リリースがキャンセルされた場合、またはリリース後に製品が失敗した場合、そのすべての投資は失われます。製品のバージョンを早期かつ頻繁にリリースすることで、収益を早く開始できるようになります。あるいは、製品が失敗したことを早く知ることができます。どちらも勝利です。前者の場合、プログラムは早期に自己資金調達され、投資リスクが低くなります。製品が失敗した場合、それを学ぶためにそれほど多くを費やしませんでした。顧客は、私たちができるだけ早く不完全な製品を出荷したことに満足しているだけでなく、そのすべての収益が次の開発トランチに充てられています。

現時点での最良のシンプルシステムを維持することは、それが何であれ、そのフィードバックに基づいて行動できることを意味します。あなたは、一貫性があり信頼性の高いベースラインから始めていることを知り、現時点での最もシンプルで最良のソリューションを維持することを約束しながら、システムを必要な方向に拡張できます。

VARを考慮に入れると、リスク調整後資本収益率(RAROC)が得られます。基本的に、投資をリスク値でスケーリングし、よりリスクの高いタイムラインを、おそらくより悪い投資として露出させます。私はこの概念を、元同僚の取引およびリスクの達人であるクリス・マットから紹介されました。

要するに、イテレーティブデリバリーはROIは悪い傾向があります(すべてのリリースと継続的な計画活動、そしてコードの切り替えを考慮に入れると)。しかし、RAROCは優れており、結局のところ重要なのはそれです。

ドナルド・ラインシュタインの画期的な著書『プロダクト開発フローの原則』では、追加の視点を提供しています。顧客のニーズが満たされ、問題が解決されたと指を鳴らすことができると想像してください。あなたはすぐに顧客を幸せにし、すぐに支払いを受けるでしょう。次に、顧客にソリューションを提示し、ニーズを満たし、顧客があなたの製品を購入することを選択する前に、かかるすべての時間、すべての1日、すべての週、すべての月を考えてください。これは、あなたが決して持てないデッドマネーです。これは遅延コストと呼ばれます。

これと並行して、機会費用があります。これは、代わりにできていた最も価値のあることの価値です。あなたのチームが何ヶ月も何かに費やしている場合、彼らは同時に他のすべてを行っていません!

ラインシュタインはプロダクト開発の経済学を探求し、「価値コスト」(遅延コストや機会費用など)が「労力コスト」(プロジェクトの燃焼率、賃金、ライセンスなど)をはるかに上回ることを示しています。私たちは後者を気にしますが、より大きな賞は公然の秘密として隠されています。私たちのプロジェクトメトリクスはすべて、活動と労力(利用率、生産性、タイムシート)に関するものであり、リードタイムやスループットに関するものではありません。ラインシュタインは、「労働者ではなく、作業項目を測定する」ことを推奨しています。

活動や労力を削減しようとするのではなく、私は遅延と手渡しを減らし、作業を小さなリリースにスライスすることに焦点を当てています。私はこれをアクションがない場所を見ると呼んでいます。

なぜ我々はこれを行わないのか? #

ヴォルテールからスティーブン・コヴィーまでの思想家が観察しているように、常識は一般的な実践ではありません。人々は群れに従う傾向があります。私たちは限定的な信念や受け継がれた知恵を持っています。これは、実用主義と完璧主義の間の仮定された二分法から始まり、上記の議論によって強化されます。

コンピューティングのパイオニアであるグレース・ホッパーは、「私たちはいつもこうやってきた」という態度のことを、最も危険なフレーズと表現しました。私たちはそれを見つけるところならどこでもそれに挑戦すべきです。

スティーブン・コヴィーは、その著書『効果的な人の7つの習慣』で、希少マインドセットを、人生はゼロサムゲームであり、すべてがトレードオフであるという信念として定義しています。これが私たちのデフォルトの状態です。対照的に、彼は豊富マインドセットを採用することを提案しています。これは、すべての状況でWin-Winを探します。一方は「パイの分け前」のために戦い、もう一方はより大きなパイを作る方法を考えています。

希少性の観点からは、仕事を正しく行うことと何かを世に出すことの間には、確かに葛藤があります。両方のことが真実であり、相互に強化されるように、自分自身を豊富マインドセットに訓練するには、努力と規律が必要です。

ケント・ベックは、「変更を容易にし、それから簡単な変更を加えよ」と私たちに促します。私は、コードをシンプルに保つために、良い習慣、勇気、そして謙虚さが必要だと信じています。そうすれば、どんな変更も容易になります。将来を予測する必要はありません。もし私たちがそれに自由に適応できるなら。

良い習慣 #

現時点での最良のシンプルシステムを維持するために、秘術的または深い知識は必要ありません。それは日々の決意と良い習慣を必要とします。「一般的なケースを見ない」ように訓練するには、努力と意図的な練習が必要です。ライブラリを最初に手に取らないように(「単一の依存関係を追加するだけだから」);理由もなく、時期尚早に抽象化したりDRYコードにしたりしないように;任意規則(テストカバレッジのパーセンテージなど)を持つ包括的なコーディング標準があるからといって、コンポーネントに過剰に投資しないように;それが機能したかどうかを確認するためにスケッチしたコンポーネントを安定させるために戻ること;うまくいかなかったスケッチしたコンポーネントを削除すること。

私がこれを学んだ方法は、この美学をすでに持っている人々とペアを組むこと、そして粘り強い忍耐でした。私は、アイデアを過剰に働かせているとき、または堅牢である必要があるものに投資不足であるときを認識することを学びました。私はまだそれに長けておらず、しばしば深い穴にかなり入り込んでからでないと気づかないこともありますが、少なくとも十分な筋肉を発達させたので、他の人と一緒に働き、この中間道を示すことができます。

勇気 #

これはどうすればうまくいく可能性があるのですか?もしそれがそんなに良いアイデアなら、なぜ他の誰もそれをやっていないのですか?未知への飛躍はトリッキーです。勇気とは恐れがないことではなく、それでも前進することを決めることです。私は「一度私を信頼してください」という原則を奨励します。もし私たちがこれを試してみてうまくいかなかったら、いつでも元に戻して別のことをすることができます。それはただのコードであり、バージョン管理システムがありますよね?しかし、もしそれがうまくいったら…まあ、どれほどクールでしょう?

謙虚さ #

ブルース・リーはかつて生徒に「水のようにあれ」と教えていました。水をカップに注ぐと、カップの形になります。川に流れ込むと、川の形になります。柔軟性は予測から来るのではなく、シンプルさから来ます。水のようにシンプルなものはありません!

新しい要求に応じてシステムを変更するとき、私たちはそれを新しい「現時点」の文脈における新しい現時点での最良のシンプルシステムへと進化させます。あの2つの私を覚えていますか?開発すべき習慣は、次に何が起こるべきかを「知っている」人に振り回されるのではなく、自分が知らないことを知っている方を信頼することを学ぶことです。

どこから始めるか? #

BSSNを採用する最良の方法は、ただ始めることです™。新しいスキルと同様に、最初はうまくいかず、一方に過度に傾くかもしれませんが、慣れてくれば大丈夫になります。だから、自分に優しくして、少し余裕を持たせてください。安全地帯と快適ゾーンから抜け出すことが学習の場ですが、少し bumpy かもしれません。

私が難しいと感じたこと、そして今でも感じていることは、「現時点での」を見ることです。インターフェースを定義したり、その「再利用可能な」コンポーネントを抽出したりすること(念のため、なぜなら私は賢いからです!)は非常に魅力的です。あるいは逆に、マイクロ投資の品質と労力がどれほど早く報われるかを過小評価したり(そして、テストや一貫したドメイン言語は必要ない、なぜなら私は賢いからです!)、手抜きをしたりすることです。

良いニュースは、これらの習慣を実践すればするほど、現時点での最良のシンプルシステムを構築することが容易になるということです。私は「ただコードを書く」のと同じくらい速くTDDに頼ることができ、常に良い結果が得られます。逆に、スケッチしている間は、コマンドライン(REPLまたはRead-Eval-Print loopとして知られる)でコードを実行して観察することがあります。フィードバックを得ている限り、そのフィードバックが再現可能か自動化されているかはまだ重要ではありません。

REPLの例として、最近PyTestのカスタムフィクスチャを書いていました。テストフレームワークをテストするのは難しいです!そして、それらの一部には、一時ファイルやディレクトリの作成と操作が含まれていました。フィクスチャがどのように機能してほしいかをスケッチして探求している間、ファイルの書き込み場所を確認するためにテストを書くよりも、いくつかのtreeとgrepコマンドを実行する方がはるかに簡単でした。さらに、これらの種類のテストは「複式簿記」になり、テスト対象の実装を再現します。これは壊れやすく、あまり役に立ちません。PyTestが一時ファイルの扱いを変更した場合でも、私が望む動作が得られる限り、気にする必要はありません。

現時点で何に取り組んでいますか?このサブセットの一部を現時点での最良のシンプルシステムとして再構築するにはどうすればよいでしょうか?そこから始めて、何が起こるか見てみましょう。これが難しい場合は、それを「変更を容易にする」ために努力が必要な場所を示す指標として受け取ってください。一度にすべてをやろうとしないでください。早期にペイオフがあるものを選んで、これがどのように機能し、どのように違うのかについて、チームメイトや自分自身との信頼を築きましょう。

いくつかの例を挙げます。

例:JSONライブラリ #

ある取引クライアントは、Javaで書かれたビジネス上重要な取引アプリケーションで使用するJSONライブラリについて私の助言を求めていました。彼らのシニアエンジニア2人が異なるソリューションを支持して対立しており、妥協の兆候は見られませんでした。スケーラビリティ、回復力、推移的依存関係、コミュニティサポートなど、さまざまな特性が議論されていました。彼らは外部コンサルタントに仲裁役を求めていました。

どちらかの側を選ぶ代わりに、ワイヤーで送信する予定のエンティティタイプの数を聞きました。いくつかの議論の後、9種類であることがわかりました。9種類です。私は、彼らには「JSONライブラリ」とそのすべての実行時特有の動作、推移的依存関係、複雑さが必要ないかもしれないと提案しました。おそらく、9種類のオブジェクトをマーシャルおよびアンマーシャルする必要があっただけです。

実験として、9つのタイプTそれぞれが実装するインターフェースを定義しました。

interface Jsonable<T> {
  String toJson(T obj);
}

そして、次のような静的メソッドを持つことを要求しました(他の言語ではこのペアリングをより対称的にすることができるかもしれません)。

class SomeT {
  public static SomeT fromJson(String json) {
    // ...
  }
}

彼らは9つの場所にテストとともにこれらを実装しました。9つの1行メソッドのペア、依存関係ゼロ、驚異的なパフォーマンス、最小限の攻撃対象領域;現時点での最良のシンプルシステムです。もし10番目のタイプを追加した場合、ソリューションを拡張する方法と、それがどのように動作するかを正確に知っているでしょう。もしいつでも任意のタイプのフォーマットを変更したい場合、それを簡単に実行できます。そして、そのように。

例:XMLストリーマー #

もう一つJavaの例です。今回は2000年代初頭のものです。奇妙に似た状況で、Javaオブジェクトをあちこちにストリーミングする必要がありました。今回は事前にそれが何になるかわかりませんでしたが、既存のソリューションが私たちが望んでいたものには過剰であることはわかっていました。

これはエンタープライズJavaの全盛期であり、世界はXMLで動いており、XMLからXMLへ、または他のXMLへとXMLを使用していました。

私たちは、次のようなオブジェクトをレンダリングしたかっただけです。

class Boat {
  String name;
  int length;
  boolean isSubmersible;
}

new Boat("Boaty McBoatface", 5, true);

次のように表示します。

<Boat>
  <name>Boaty McBoatface</name>
  <length>5</length>
  <isSubmersible>true</isSubmersible>
</Boat>

そこで、私の友人は、それだけを行うための小さなライブラリを書きました。その唯一のセールスポイントは、装飾や機能がなかったことです。時間とともに、自己参照やその他のポインタなど、より多くの、そして異なるエッジケースを処理できるようになりましたが、データをXMLとしてレンダリングする方法、またはXMLから解析してロードする方法は、常に1つの退屈で予測可能な方法しかありませんでした。

オープンソースソフトウェアの早期採用者として、彼はこのライブラリ、XStreamと呼ばれるものを、GitHubの古代の前身であるOSSホスティングサイトに提出しました。それは「単純すぎる」という理由で却下され、ホスティングする価値がないとされました。20年以上経った今でも、XStreamは健在であり、Javaが存在するほぼすべての場所、国際宇宙ステーションでも使用されています!それは依然としてシンプルで明白です。

これらの例は、BSSNが常に自作であるべきだとか、ノットインベンテッドヒア(未開発)の文化を奨励するためではありません。XStreamの場合、私の友人はコミュニティを構築することに満足していたので、それについて考える必要がなくなりました!

代わりに、それらは「実際に見えているものを見る」ことと、そのユースケースだけを解決することについてです。サードパーティのライブラリやツールが現時点での最良のソリューションである場合、それを使用すべきです。しかし、採用コスト、学習コスト、特異な動作、推移的依存関係、目標に合わない場合の制限の回避、そして数行のコードを書く必要がないという短期的な利便性だけでなく、後でそれを削除するコストと労力を全体的に見てください。そして、自分で何かを書くことを決定した場合でも、現時点で必要なものだけを書いてください。

tl; dr #

職人技を装った金メッキや完璧主義と、実用主義や現実主義を装った手抜きとの間で選択する必要はありません。前者の品質を、後者のスピードとフォーカスで実現できます。私はこれを現時点での最良のシンプルシステムと呼びます。

現時点では、コードベースを意図的に進化させることを選択できます。これにより、常に「可能な限りシンプルだが、それ以上でもそれ以下でもない」状態を保ちつつ、CUPIDの特性を持つ楽しいコンポーネント(アラン・ケイがオブジェクト指向プログラミングを説明したように、細胞がメッセージをやり取りするようなもの)で構成される、小さなコンポーネントを持つことができます。もちろん、OOPがこれを達成する唯一の方法、あるいは最良の方法であるとは限りません。それは私が交換可能なコンポーネントアーキテクチャと呼ぶものの単なる一例です。

開発すべきスキルは、「実際に見えているもの」を見て、それをうまく解決することです。一般的なケースを解決するように誘惑されたり、速く動く唯一の方法はハッキングだと信じたりするのではなく。

ソフトウェアは、それが「スケッチ」であれ、堅牢で回復力のあるコードであれ、文脈に応じたものとして記述してください。より多くを学んだら、それを進化させたり、置き換えたり、削除したりできるという知識に自信を持ってください。


  1. 複雑性の専門家であるデイブ・スノーデンがすぐに指摘するように、ギャルの「法則」は特定の文脈でのみ適用されます。私がリンクしたWikipediaのエントリでは、それは経験則として説明されています。私が働く多くの大企業では、それは有効な観察であるようです。また、私はそれが、すべての基盤を事前にカバーする必要があると感じるのではなく、進化的な設計を理解するのに役立つツールであることも発見しました。↩︎

Goalwards®、当社の新しいビジネスアジリティ実践をご覧ください!