技術的負債

どのようなものか

技術的負債は、システムの設計やコードで近道を選んだことによる、将来の
追加コストです。今日の時間は節約できても、その近道を解消するまで、後
の変更が遅く、危険になったり、不可能になったりします。英語の
technical
debtは、チーム内でtech
debtと略すこともあります。負債という言葉は比喩です。近道が借金のよう
に振る舞うため選ばれました。今何かを得る代わりに、それが残る限り、後
から費用を請求されます。

この考えは、Ward
Cunninghamが1992年のOOPSLAで発表した、Smalltalk製のポートフォリオ管
理システムWyCashについての経験報告に由来します。少人数のチームが約四
メガバイトのソース全体の概要を把握し、成熟した部分は何度も見直した
り、書き直したりしていました。報告は、その整理によって段階的な成長を
着実に続けられたと論じています。重大な落とし穴は、その整理をしないこ
と、つまり動作し、顧客も満足しているのに、整えられたことのないコード
です。Cunninghamは「最初に書いたままのコードを出荷することは、借金を
するようなものだ」と一行で表しました。報告自体は単に負債と、その類推
について述べています。後の研究が二語の名称を使い、Googleの2015年の論
文は、この比喩をWard
Cunninghamによる1992年のものとしています。

2016年4月にDagstuhlへ集まり、用語の範囲を合意しようとした研究者たち
は、作業上の定義を作りました。そこでは負債を、短期的な労力を節約する
一方で、将来の変更を高くつかせ、一部を不可能にする状態を残す、設計や
実装上の要素の集まりとしています。影響はシステム内部の品質、特に保守
や進化のしやすさに限定します。これにより、まだ作っていない機能とは区
別されます。負債のコストは、システムを変える人にかかり、その人たちを
通してのみ利用者へ届きます。同じ報告は、金融の語彙も使います。元本
は、近道で節約したもの、または今、よりよい解決策を作るのにかかる費用
です。利息には二種類あります。繰り返し発生する利息は、開発速度の低
下、誘発される不具合、品質の損失という形で支払い、累積する利息は、不
十分なコードの上に新たなソフトウェアを構築するたびに増える追加コスト
です。負債は主にコードにありますが、文書、テスト、既知の不具合にもあ
ります。

なぜ重要なのか

意図して負債を引き受けることが、よい判断になる場合もあります。
Cunninghamの報告は、少量ならチームを速く進められるが、コードを書き直
して早めに返すことが条件だと述べています。Googleの論文も、借り入れが
適切な戦略になることは多いとしています。両方が警告するのは、負債を残
すことです。報告では、不十分なコードのために失う一分一分という時間で
利息を払い、誰も整理しない実装は、技術組織全体を止めるほど重くなり得
るとします。その前に、プログラムは一人では把握できないものとなり、一
部分だけを知るプログラマーが生まれ、最後には方向転換できない製品にな
ります。

問題は、負債が選択の結果とは限らないことです。Dagstuhlの報告は、しば
しば意図せずに生じ、開発者が不意を突かれるため、原因となった判断から
ずっと後の保守作業で見つかることが多いと述べています。原因は日常的で
す。納期の圧力、重要な人の不在、判断時点で技術的な機能について十分な
情報がなかったことなどです。Googleの論文は、隠れた負債こそ、気付かな
いうちに複利で膨らむ危険なものだと付け加えています。

この比喩は、開発者と管理側に共通の言葉も与えます。Dagstuhlの報告は、
強力な意思疎通の仕組みと呼び、参加者が示す将来像には、不具合や新機能
と同じ慎重さで負債を管理し、開発者の懸念と管理側の判断を結び付ける方
法も含まれています。セミナーで紹介された研究は、そのチームへの効果を
示します。Graziela
Tonin、Alfredo Goldman、Carolyn
Seamanは、合計60人からなる複数の学生チームに、負債を明示的に特定し、
追跡するよう求めました。見える一覧によって、顧客とリファクタリングの
時間を交渉し、プロジェクト内の未成熟な部分を記録し、コード品質が改善
しているか確認できました。メンバーの多くは、意思疎通が増え、負債が本
当に必要かをよく考え、リファクタリングも増えたと答えています。著者た
ちは、負債を引き受ける判断を話し合った結果、ほかの人が代われない専門
家が減ったチームもあったと付け加えています。

実際の活用例

負債は、チームが仕事を計画する場所に書くことで管理できるようになりま
す。この記事のために作った台帳の項目なら、次の程度でも十分です。

```text
TD-14       請求書の合計を三か所で計算している
成果物:     billing/web, billing/export, reports/monthly
原因:       公開日が固定され、規則を共通モジュールへ移すより
            コピーするほうが早かった
元本:       テストも含め、規則を一つのモジュールへ移すのに約2日
利息:       税規則が変わるたび三回修正・テストし、直近五回の変更で
            一回、コピーの修正が漏れた
次の対応:   次の税規則変更時に返済する。電子請求書の出力は
            今四半期の予定だが、四つ目のコピーにしてはならない
担当:       請求処理チーム
```

項目は、Dagstuhlの報告のモデルに従っています。具体的な成果物に結び付
け、原因、元本、利息を持ちます。利息を書くと、請求コードが乱雑だとい
う感覚が、比較して判断できるコストに変わり、台帳が役立ちます。税規則
が年四回変わり、変更ごとに作業とテストが一日余計にかかるなら、元本の
二日分は六か月以内に回収できます。予定する出力機能は、Dagstuhlのいう
累積する利息です。重複したルールの上に新しいものを作るたび、後で直す
費用が増えます。逆に、コードを凍結し、もう誰も触らない見込みなら、同
じ項目が、負債を残す判断の根拠になります。

負債はコードだけの問題ではありません。このサイトの社内プロセスの刷新
で8,000時間を節約した実績記事は、創業者が以前Mappitallで行った仕事の
記録です。技術的負債が読者の作業を遅らせていないかと問い、仕事の進め
方に積み重なる負債を説明しています。設計ではなく継ぎ足しで成長したソ
フトウェア構成、動いてはいるが効率の悪いシステム、人が待つか過負荷に
なる日程管理です。緊急事態ではなかったため、そのままにされていまし
た。2015年から2022年の仕事で、構成、システム、日程管理を作り直し、約
8,000時間を節約しました。記事は、その一部を、チームの運営方法に変更
を定着させた効果だとしています。恒久化しない改善は、次第に以前のやり
方へ戻ってしまうためです。

問題が起きるところ

何もかもが技術的負債と呼ばれる。
言葉が広まると、古いライブラリーから未実装の機能、同僚の書き方まで、
あらゆる不満に同じラベルが付きます。Dagstuhlの報告は、この危険を明示
し、明確な定義で対処するよう求めています。将来の変更に費用がかかる近
道に限定し、不具合は不具合、要望は機能として記録します。原因と利息を
示せない台帳項目は受け付けません。

負債が、人の頭の中にしかない。
書き残さなかった負債は、次にコードを触る人が、なぜ時間がかかるのかも
分からず払うことになります。バックログのそばに台帳を置き、システムの
一部を変える前に、Toninの研究の学生チームが行ったように確認します。
時間配分を決める人に見えるのは、その人が見る場所に書いた項目だけで
す。

利息がかからない場所の元本を返している。
誰も変更しないモジュールを整理すると、働いた気にはなりますが見返りは
なく、毎週変わるコードは請求し続けます。利息は人が作業する場所でだけ
増えるので、各部分の変更頻度と、その上にこれから何を作るかで台帳を並
べ、負担の大きい項目から返します。

返済を、大規模な書き直しまで待つ。
何年も残した負債には、システム全体の置き換えで対処しがちですが、古い
ものが費用を請求し続ける間に、新しいプロジェクトも自分の負債を抱えま
す。Cunninghamは早期の返済を勧め、Googleの論文は、リファクタリング、
単体テストの強化、未使用コードの削除、依存関係の削減、APIの絞り込
み、文書の改善という一般的な方法を挙げています。どれも機能の追加では
なく、次の変更を安くするためのものです。それを必要とする変更の近く
で、通常業務の一部として予定します。

実験が本番に残る。
本番コード内の条件分岐で代案を試すことは、個々の実験としては安く済み
ます。Googleの論文は、その分岐が積み上がり、全組み合わせのテストが困
難または不可能になる様子を説明しています。Knight
Capitalも挙げ、古い実験用コードの経路が想定外の動作をしたためとみら
れる問題で、システムが45分間に4億6,500万ドルを失ったと述べています。
実験用の分岐とフラグを定期的に見直し、使わないものは削除し、コードを
増やすのと同じだけ減らすことも評価します。

ツールの点数を、そのまま負債と考える。
静的解析は重複行や長い関数を数えられ、ダッシュボードはその数を残高の
ように見せます。しかしGoogleの論文は、比喩から継続的に追える厳密な指
標は得られず、チームがまだ速く進めることも負債が少ない証拠にはならな
いと明言しています。DagstuhlでForrest
Shullは、変更コストの上昇や開発速度の低下などの症状と、プロジェクト
をまたいで一貫した相関を持つ、単一の検出ルール群はなかったと報告して
います。ツールの指摘は、自分たちの変更と不具合の履歴に照らし、費用を
予測できるルールだけを残します。新メンバーをどれほど速く戦力にできる
かなど、論文自体が示す問いのほうが、よい判断材料になります。

参考資料

  * The WyCash Portfolio Management System — 負債の比喩が最初に登場
する、Ward
CunninghamのOOPSLA '92経験報告です。

  * ソフトウェア工学における技術的負債の管理 — Dagstuhl Seminar
16162の報告で、作業上の定義、元本、利息、明示的な負債一覧の研究を含
みます。

  * 機械学習システムに潜む技術的負債 —
GoogleのSculleyらによる2015年の論文で、負債の蓄積、返済方法、測定の
難しさを論じています。

  * Refactoring — Googleの論文が返済方法の最初に挙げる、小さく、振る
舞いを変えない変更についてのMartin
Fowlerのサイトです。

hこのページのウェブ版	URL:https://engineer.company/ja/glossary/technical-debt/	engineer.company	70
