変更結合度:1行の修正がなぜ10ファイルに影響するのか
Change Coupling: Why One-Line Fixes Touch Ten Files (kb.buildingbetterteams.de)
要約
ソフトウェア開発における「変更結合度(Change Coupling)」という概念を解説する記事。これは、本来無関係に見えるコードが、ビジネスロジックや隠れた依存関係により、しばしば同時に変更される現象を指します。この結合度を理解することは、システムの構造を把握し、アーキテクチャ上の意思決定を行う上で重要であり、コードの変更履歴を分析することで、物理的な配置と実際の変更パターンとの乖離を発見し、保守性の向上につなげられると述べています。
全文翻訳
Change Coupling: なぜ一行の修正が10個のファイルに影響するのか
トレードオフを最優先に
Change Coupling は、意思決定者向けの理解を助けるツールであり、最適化すべき品質メトリクスではありません。完璧な結合度の整合を目指すのではなく、システムの実際の構造を理解することが目標です。あらゆるアーキテクチャ上の決定には、文脈を考慮して検討されるべきトレードオフが伴います。
散発的な変更の問題
苦痛の点
誰しも経験があるでしょう。一つの小さな機能を追加しようとしたのに、6つのディレクトリにまたがる12個のファイルを修正することになった、という状況です。単純なバグ修正であるはずが、予期しなかった変更に波及したり、あるいは最悪なことに、それを予期して嫌悪するようになるまでになります。Change Coupling は、コードレビューの半分が意図した変更とは全く関係ないはずのファイルに関わるようになると、明白になります。
悪いChange Coupling は、コードの読み書きの速度を低下させますが、さらに悪いことに、集合的な認知負荷が、変更を行おうとしている人々を圧倒してしまいます。
Change Coupling を無視すると、不快な驚きが生じます。二つのコード片がお互いを呼び出したり参照したりしないのであれば、それらは無関係であるはずだと期待するでしょう。しかし、Change Coupling は、無関係に見えるものが、システムを機能させるために、しばしば隠れた変更の必要性を持っていることを示しています。これは技術的な理由とビジネスロジックの両方で起こります。Xを変更すると、コードが直接示唆することに関わらず、Yを変更することになります。静的コード解析ではこれらの依存関係を直接検出できませんが、長期間コードベースで作業することで、その感覚を養うことができます。
プロジェクトの変更速度を向上させたいのであれば、自身のソフトウェアのChange Coupling を理解することが極めて重要です。
どのような種類の結合度か?
私たちが書くコードは、コードを書く際に考慮する必要があることの表面的な層に過ぎません。
多くの種類の結合度が存在する
- 物理的結合度 (Physical Coupling): ファイル構造の中でコードがどれだけ近いか
- 論理的結合度 (Logical Coupling): 概念的に互いに依存する関数
- 時間的結合度 (Temporal Coupling): シーケンスで発生しなければならないこと
- データ結合度 (Data Coupling): 共有データ構造とフォーマット
- 制御結合度 (Control Coupling): 一つのモジュールが他方の動作を制御すること
- 変更結合度 (Change Coupling): 頻繁に一緒に変更されるコード(この記事の焦点)
すべての結合度が悪いわけではありません。結合度は必要な構造を提供しますが、過剰な結合度は変更を妨げます。車のエンジンのように、一部の部品は結合されている必要がありますが、他の部品は独立している必要があります。フロントガラスのワイパーがブレーキと結合されていることを望まないでしょう。
最適化すべき理想的な結合度の比率はありません。結合度が0%でも100%でも問題があります。0%では何も機能せず、100%では巨大な泥団(big-ball-of-mud)よりも悪くなります。この分析は、あなたとあなたのチームがシステムの力を理解し、完全なメトリクスを追求したり、結合度を完全に排除したりするのではなく、アーキテクチャ上の決定を導くための理解を助けるツールです。
Change Coupling は興味深いのは、最新のコード行を読むだけでは検出できず、変更履歴が必要だからです。それは、システムがどのように配線されているかではなく、システムがどのように進化するかの現実を示しています。これは、一見無関係なコード間の驚くべきつながりを示すことができたり、見つけにくい場所(しばしば「/utils」のような、見つけるのが難しいものがすべて置かれるが、何が移動され、どこへ移動されるべきかが不明確な場所)を整理するのに役立ちます。
最後に、Change Coupling は「一緒に変更されるコード」に関連するものであり、「変更されるコード vs 変更されないコード」とは異なることを理解することが重要です。コードが変更されるとき、それは一緒に変更されるのか、それともそうでないのか?これは、「このコードは全く変更されないのか?」という、進化的な安定性を示す(それはそれ自体が深いトピックであり、この記事で探求するにはあまりにも広範すぎる)という問いとは全く異なる洞察を提供します。
一緒に変更されるもの
一緒に変更されるべきものは一緒に配置されるべきです
Change Coupling は、システムが分割・統合しようとする断層線を明らかにします。それは重力や磁力のようなものと考えてください。一緒に変更されるコードは、同じ場所に向かって引き合う概念的な重みを共有しています。
決して一緒に変更されないコード
近接しているにもかかわらず決して一緒に変更されないコードは、もはや目的を果たさない人工的な結合度を示唆しています。
物理的結合度 vs Change Coupling マトリックス
「物理的」をコードのファイル場所と考えると、コードの物理的結合度とChange Coupling を比較して、コードが陥る可能性のある様々な状況と、それが一般的に保守可能で認知負荷の低い状態にあるかどうかを考えることができます。この2x2マトリックスは、理解を助けるためのものであり、公式な完璧な判断基準ではありませんが、非常に役立ち、問題のある領域を示したり、問題の解決方法を示したりすることさえあります。また、他のいくつかの尺度では間違っているように見えても、Change Coupling に関しては問題なさそうなコードを示すこともあり、システムの概念的な書き直しを計画している場合に設計に情報を提供できます。既存のシステムが重要な何かを正しく行っている可能性があります。
MODIFY
🔴 集約を検討する
高い変更度、低い物理的配置
一緒に変更されるが、離れて配置されているコード。これらの関数は、隣接したいと語りかけています。
例:
認証ロジックが utils/、components/、services/ に散らばっており、定期的に一緒に変更される。
MONITOR
🟢 対称的に結合されている
高い変更度、高い物理的配置
一緒に変更され、一緒に配置されているコード。これはより理想的です。物理的なコード配置がコードの変更と対称的です。
例:
新しい機能のために一貫して一緒に進化する、同じモジュール内の支払い処理関数。
MONITOR
🟢 対称的に分離されている
低い変更度、低い物理的配置
一緒に変更されることが少なく、同じ場所に配置されていないコード。実際の独立性を反映したクリーンな分離。
例:
独立して進化し、別々のモジュールに留まるデータベース接続ユーティリティとUIコンポーネント。
MODIFY
🔴 分割を検討する
低い変更度、高い物理的配置
一緒に配置されているが、一緒に変更されることが少ないコード。過去の決定による人工的な結合度である可能性があります。
例:
チームがより良い場所を思いつかなかったときに、関連性のないヘルパー関数が含まれる utils モジュールに投げ込まれたもの。
例: 支払いシステム
この例では、あるチームは支払いシステムに明確な関心の分離があると信じています。彼らは実際の金銭取引を処理する一つのモジュール、手数料を計算する別のモジュール、そして手数料をこの特定の支払いシステムに調整する第三のモジュールを持っています。
設計意図は、チームが一度に一つのモジュールだけを変更すればよく、通常は手数料エンジンだけを変更すればよいというものでした。しかし、開発者は、手数料エンジンの変更ごとに、なぜか3つのモジュールすべてに変更が波及すると感じています。変更分析レポートは、それらが頻繁に3つのモジュールすべてを同時に変更していることを確認しました。概念レベルは健全ですが、モジュールがどのように変更結合されているかを見ると、コードを見る前に何かが間違っているという強力な兆候が得られます。
「一緒に変更されるものは一緒に配置されるべき」というのは、これら3つが一緒に変更されるからといって、すべてを一つのファイルに入れるべきだという意味ではありません。むしろ、それらが一緒に引き合う原因を問い直すための理解を助けるガイドです。
実際の実装がこのようになっているのには、無数の理由があります。以下に例を挙げます。
- 取引ログに関するコンプライアンスルールのロジックが、元の実装では考慮されていませんでした。永続化は取引プロセッサにありますが、理由コードのルックアップテーブルの更新が必要です。
- 一部の国での異なる手数料構造は、取引ブロックに特別なデータ構造を必要とします。この金融システムでは、単一のフラットな数値では済みません。
- 手数料の上限に関するマーチャント契約があるため、超過がないことを確認するために、取引プロセッサで手数料が上限設定されています。
- データベース構造が、目に見えない方法で3つのモジュールを結合しています。
- 取引モジュールに、実際の取引と内部の「顧客クレジットアカウント」の管理を負荷しています。
- ...そして、私たちは一日中状況を考え続けることができます。実際のシステムには実際の problemas があります。
3つのモジュールすべてを一つに統合することは魅力的ですが、それは他の貴重なコード品質とアーキテクチャ上の懸念を低下させるでしょう。それはおそらく、作業するのが同様に難しいモノリシックな混乱を生み出すでしょう。代わりに、変更が導入される理由を再構築し、共通の部分を抽出するか、共通の部分を注入する方法を探すべきです。良いアプローチの一つ(他にも数多くありますが、ここではすべてを議論しません)は、依存性逆転(Dependency Injectionとは異なるものですが、しばしばDependency Injectionを使用することがあります)を使用して、ビジネスルールを抽象的な仕組みから分離することです。様々な種類のネジに対して新しいドリルを購入するのではなく、交換可能なドリルビットを使用するようなものです。
あるいは、二つのコード片を一つにマージしたり、システムの С часть を置き換えたりすることが、絶対に正しいことである場合も多くあります。あなた固有の結合度の課題の文脈と、何を最適化しているかによって、多くの異なる解決策につながる可能性があります。トレードオフに見合うのであれば、変更結合されたコードを保持することさえも含まれます!環境とビジネスドメインの明確さが不安定であればあるほど、今日「真実」であることがすぐに「偽」に変わる可能性が高くなります。
しかし、Change Coupling とうまく付き合うための鍵は、毎日生の努力で正面から戦うことでも、モノリスを作ることでもありません。同様に、すべてを個別のモジュールやマイクロサービスに分割しても解決しません。Change Coupling は、ソフトウェアが同時に変更されたものであることを覚えておいてください。それはプログラミング言語、リポジトリ、デプロイメント、インターフェースの境界を超えて広がります。二つのものを同時に変更した場合、それらが何であるか、どこにあるかに関わらず、それらは変更結合されています。
Change Coupling 分析は解決策を指示するものではありません。それはあなたのシステムに作用する引力と斥力の力を明らかにします。これらの力を理解することは、完璧なデカップリングに到達することではなく、自然なコードベースの進化と戦うのではなく、情報に基づいたアーキテクチャ上の決定を下すのに役立ちます。
人々が間違えること
シルバーバレットの罠
チームがChange Coupling の課題に直面すると、しばしば次のようなものに手を伸ばします。
- イベント駆動アーキテクチャ: 「イベントでデカップルしよう!」(しかし、イベントは多くの形態の結合度を生み出す可能性があります。特に、「これらのものは一緒に変更する必要がある」という性質が解決されず、問題がさらに分散されたソリューションに焼き込まれている場合)
- マイクロサービス: 「個別のサービスがこれを解決してくれる!」(しかし、論理的結合度は残ります。イベントと同様に、一緒に変更する必要があるものは、たとえ異なるリポジトリにあり、ネットワーク経由でメッセージを送信し、異なるランタイムで実行されていても、まだ一緒に変更する必要があります)
- インターフェースの乱発: 「より多くのインターフェースとAPIが役立つはずだ!」(APIが壊れ続けるので正しく感じられるかもしれません。インターフェース分離の原則のような概念に従っても、方程式の両側が変更する必要がある場合、それらの間のコードに形式を追加しても、Change Coupling を打ち負かすことはできません)
- 理論的に純粋なドメイン境界: 「理想的なビジネス分離を設計しよう!」(ドメインモデリングはビジネスの複雑さについての重要な洞察を提供しますが、最終的な「正しい」ドメイン構造を追求することは、ビジネスの現実が絶えず変化することを無視しています。チームは再編成され、優先順位は進化し、Conwayの法則は、最も慎重に設計された境界でさえ、人々が実際に協力する方法の絶えず変化する現実に形作られることを保証します)
- アーキテクチャパターンの正統性: 「今回は正しくアーキテクトしよう!」(しかし、実際のChange Coupling とチームのダイナミクスに対してその有効性を測定することなく、パターンの処方を厳格に遵守することは、しばしばそれが防ぐことを意図していた問題よりも多くの調整オーバーヘッドを生み出します)
これらの技術はすべて役立つ可能性がありますが、それぞれに詳細が重要です。これらの技術はしばしば失敗した「大規模リファクタリング」イニシアチブになります。
しかし、これらの技術がプロジェクトを失敗させる理由ではありません。それらは、決定を導くために必要な重要な要素を無視するために失敗します。Change Coupling を無視することは、ほぼ常にプロジェクトが誰もが期待していた目標を達成できなくなることを保証します(そしてしばしば、これらのプロジェクトに多大な政治的資本が費やされているため、高レベルのリーダーは、Change Coupling のニュアンスなしに一般的な技術を選択した場合、失うものが多くなります)。
認知負荷
不十分なChange Coupling を持つシステムの性質は、開発者が必要とする変更がシステム全体にわたって広範囲に分散し、断片的であるか、あるいは変更のサイズが本来あるべきよりも大きいことです。これは開発者に巨大な認知負荷を生み出します。彼らは、複数の無関係なシステムを精神的に管理しながら、はるかに広い表面積にわたる変更をナビゲートしなければなりません。依存関係の絶えず成長するウェブを追跡するにつれて、複雑さは増大します。多くの領域がプログラマーにとって馴染みがなく、彼らは立ち止まって、そのシステムで行う必要がある小さな変更が、論理的に多くの他の予期しないシステムにどのように結合されているかを学ばなければならないことが容易に起こり得ます。
事実のこの絶えず広がるウェブが、どのファイルを変更する必要があり、どのように変更する必要があるかを正しく理解するために複雑すぎる変更の麻痺の一形態につながる可能性があります。厄介なコードのリファクタリング作業を支援する技術はありますが、それらは時間がかかり、そのような状況に最初から陥るのを避ける方がしばしば良いです。
不十分な結合度を持つシステムは、修正が必要なものを正しく理解するために必要な発見作業と、変更や修正を行うための労力に指数関数的な作業を強います。したがって、不十分な結合度を持つシステムは、開発者の生産性に課せられる大規模な不要な無駄であり、生産性を向上させる追求において真剣な注意を払う価値があります。
この問題をより具体的にするために、類似の論理的変更を行う2つの異なるプロジェクトを考えてみましょう。変更が凝集している一方では、変更領域は焦点を絞られ、論理的です。もう一方では、それらはプロジェクト全体に散らばっており、重要な部分は一見無関係なファイルの中にうまく隠されています。
凝集した変更
変更領域の統合
プロジェクト構造
user-profile/
├── profile.js
│ Modified
├── validation.js
│ Modified
├── api.js
│ Modified
└── tests/
components/
services/
utils/
変更されたファイル: 3
ディレクトリ: 1
コンテキストスイッチ: 1
見積もり時間: 2時間
非凝集な変更
プロジェクト全体に散らばっている
プロジェクト構造
auth/
├── session.js
│ Modified (多くの無関係なものの間に埋もれている)
└── validation.js
Modified
api/
├── users.js
│ Modified
├── middleware.js
│ Modified (多くの無関係なものの間に埋もれている)
└── serializers.js
Modified (多くの無関係なものの間に埋もれている)
database/
├── models.js
│ Modified
└── migrations.js
Modified
jobs/
├── email.js
│ Modified (多くの無関係なものの間に埋もれている)
└── notifications.js
Modified (多くの無関係なものの間に埋もれている)
frontend/
├── profile-form.js
│ Modified
├── state.js
│ Modified
└── validation.js
Modified (多くの無関係なものの間に埋もれている)
変更されたファイル: 12
ディレクトリ: 6
コンテキストスイッチ: 6+
見積もり時間: 2日
チームのダイナミクスを考慮すると、Change Coupling は役割を果たします。組織内のワークフローによっては、単純な変更に複数のチームの調整が必要になる場合があります。その悪さがどの程度になるかのアイデアを与えるために、私は個人的に、一つの単純な変更が12の異なるチームのリードの承認を必要としたモノリスを目撃しました。安全に言えば、私たちがチームの働き方を変えるまで、そのプロジェクトではほとんど何も出荷されませんでした。
時には、これはアプリの物理的な「スライス」を所有する各チームが、自身の計画サイクル(そしてそれをサイクルに入れるための政治的意志)で変更を調整する必要があるという形で現れます。他の時には、それらの承認が必要です。時には、影響を受けるコードを「所有」しているチームが知らないまま変更が行われ、将来的に予期せぬ驚きを発見したり、文脈を知らなかったために変更が壊れてバグを引き起こしたりします。
しばしば、この状況が十分に長く続くと、結合度が低いコード領域は岩のように石化します。ますます少数の人々がコードを正しく変更する方法を知っています。より多くの人々がそれを触ることを本当に心配し、恐れています。誰もそれに責任を取らず、所有権なしに放置されます。悲劇的なことに、これらはしばしばビジネスにとって最も重要な機能の一部です。そして一般的に、ビジネスの中心を効果的に変更できない開発チームは、ビジネス戦略を薄めたり、この石化した変更のボトルネックの周りに拡大したり、変更をより速く行える他の分野で収益を探したりすることを余儀なくされます。
Change Coupling のかくれんぼ
結合度の高いシステムと結合度の低いシステムの両方で作業する体験をしてください。
チケットに記載された機能を実装するために、一緒に変更する必要があるすべての関数を見つけてください。関数名とコメントは変更が必要な場所を理解するのに役立ちますが、時には変更は表面レベルを超えます。
- 正しい関数をクリックしてChange Points を獲得し、出荷に向けて進歩しましょう!
- 間違ったクリックは、余分な認知負荷(悪いこと!)を追加します。
チャレンジを選択してください:
👶
イージーモード
より明確で予測可能な変更パターン
🤬
ハードモード
散発的で予期しない変更パターン
Change Coupling はより深い繋がりを明らかにします
時には、Change Coupling が回避しにくい、あるいは他の利点のために意図的に選択されることもあり、この不利な点を正当化します。Change Coupling は、論理的、概念的、時間的、あるいはその他の結合度と並んで一般的に存在しますが、それらの存在がChange Coupling を保証するわけではありません。
以下に、Change Coupling が正しいトレードオフになり得るいくつかの簡単な例を挙げます。
- 概念的結合度: 無関係に見えるが、共通の抽象化を持たないシステム(あるいはドキュメントジェネレーターと計算機のように不可能かもしれない)の共有ビジネスルールにより、常に変更される関数。
- 時間的結合度: 物理的に分離されていても、シーケンスで更新されなければならない関数。例えば、起動とシャットダウン、クリーンアップコード、あるいは一連のデータベースマイグレーションなど。
- 規制上の結合度: コンプライアンス要件によって変更が束縛されているコード。例えば、GDPR要件により、多くの無関係なコード領域が異なる方法でデータを保存しなければならない場合があります。
Change Coupling は進化的な概念です。Change Coupling のための完璧なシステムを設計することは難しく、すべてのケースを網羅する時代を超越したシステムを設計することは不可能です。理想的な道は、チームが傾向があるほとんどの変更が、Change Coupling を最小限かつ論理的に保つように最適化されることを目指すことです。時間の経過とともに、変更されるものはドリフトし、時折個々の変更はソフトウェア設計を横断する必要があり、それは平均的な変更とは大きく異なります。しかし、あなたの典型的な変更がクロス・カッティング(横断的)である場合、あなたのチームがChange Coupling に苦労しているという明確なシグナルがあります。
Change Coupling をチームにとって実行可能にする
ルール1:すべてはトレードオフであり、目標は完璧なデカップリングに到達することではないことを覚えておいてください。
ルール2:これらのツールは、すべての思考を代行するのではなく、理解を助けるためのものであることを覚えておいてください。
ステップ1:機会を特定し、選択する
- 分析を読んで、コードのどの部分が最も優れており、最も悪い傾向にあるかを発見してください。それはあなたのチームのコードに対する直感と一致しますか?矛盾について議論してください。
- 今後3〜6ヶ月でプロジェクトで最も一般的になりそうな、共同変更パターンを探してください。最悪の変更パターンを追いかけるのではなく、チームの時間と脳細胞(集合的に)を奪うものを選んでください。
- 解決すべき最も重要なChange Coupling 問題のいくつかについて、短いリストを作成してください。私はしばしば、節約された時間を最適化することにしますが、あなたのチームは、変更リスクの軽減、新規チームメンバーのオンボーディング体験、あるいは全く異なる何かを最適化したいかもしれません。
ステップ2:変更を調整し、計画する
あなたのチームは、Change Coupling を回避するためにコード構造を変更する方法について技術戦略を形成する必要があります。これには、コードのマージ、コードの分割、またはコードの一部を新しい場所への移動といった戦術が含まれる場合があります。しばしば、依存性逆転(この記事の早い段階で言及)が良い選択肢であることに気づきます。
時には、製品発見の観点から、未知の深いドメインについて学ぶこととのトレードオフとして、変更結合されたコードを持つことは価値があります。この場合、より安定した理解に到達するために、顧客とドメインについて可能な限り迅速に学習を加速する方法を見る価値があるでしょう。
ここには無数の解決策があります。どれも完璧ではありません。いくつかは改善と呼ぶのに十分良いです。
ここでの多くの変更は、コード境界の変更についてチーム間の調整を必要とする場合があります。同僚にその理由を説明するのに苦労している場合は、Framing Change: Why Good Ideas Go Nowhere を読むと役立つでしょう。
ステップ3:定期的なレビューにコミットする
成熟した標準的なアーキテクチャプロセスがあれば、これは四半期ごとに通常の定期的な議題項目として組み込むことができます。そうでなければ、しばらくの間その役割を担うか、数ヶ月ごとにチェックインする非公式なチームを形成する必要があるかもしれません。
Change Coupling はトリッキーです。なぜなら、コードを読むだけでは分からないことが多く、しばしば後になって初めて明らかになるからです。これは、コードだけでなく、ビジネス戦略や人間の文化的規範とも関係がある、絶えず進化する種類の結合度だからです。一緒に変更されるものは、共通の変更理由を共有しているため、そうなり、人間がその理由を考え出したため、理由を共有しています。理由が変われば、結合度も変わります。人間の決定に関わらず、一部のコードは永遠に深くChange Coupled のままですが、多くはそうではありません。だからこそ、定期的にチェックすることが非常に重要です。