技術的負債と既知のエラー
既知のエラーと技術的負債を、先送りされた修正の、一つの見える台帳として扱い、各項目が開いたままの月ごとにいくらかかるかを測り、能力の保護された割合を、最も利息の高い項目に使ってください。
概要と動機
すべてのチームは、いくらかの修理を先送りします。欠陥は理解されているのに直されず、日付に間に合わせるために近道が取られ、コンポーネントは古びるままにされ、回避策がランブックに書き込まれます。先送りは、その時点では、それぞれが賢明な判断です。問題が始まるのは、先送りが目に見えないところで積み重なるときです。それを抱えるコストは、のちにインシデント、遅いデリバリー、疲れた人々として現れ、コストを原因に結びつける行は、どのレポートにもありません。
二つの語彙が、同じパターンを記述します。ITILでは、既知のエラーは、根本原因が理解されており、回避策、またはまだ適用されていない恒久的な修正が存在する問題です。既知のエラーは、サービスデスクと運用の担当者が繰り返されるインシデントを素早く解決できるよう記録され、その記録は修正がリリースされるまで開いたままです。アジャイルのソフトウェア作業では、技術的負債が、将来の変更をより難しくする設計と実装の選択を指す比喩で、1992年にウォード・カニンガムが作った言葉です。この比喩は、測定にとって大切な二つの考えを運びます。負債を取り除くのに必要な労力である元本と、負債が残っている間、各期間に支払う追加の労力またはリスクである利息です。
二つの見方は、どこを見るかで異なります。既知のエラーは、運用を通して見つかります。インシデントまたは問題の調査が、原因を見つけます。技術的負債は、たいていデリバリーを通して見つかります。開発者が、変更が本来より難しいことに気づきます。既知のエラーは、すでに顧客を傷つけ始めた技術的負債であることがよくあります。技術的負債は、起きるのを待っている既知のエラーであることがよくあります。ITSMのツールに一つ、バックログやWikiにもう一つと、別々の一覧を持つことは、つながりを隠し、同じ乏しい能力をめぐる二つの競合する議論を生みます。
このトピックは、統合された台帳のための、小さな尺度の組を与えます。組織全体の負債についての単一の金額は避けます。それを確実に出す方法はないからです。代わりに、観測できるものを測ります。開いている項目、待った時間、引き起こしたインシデント、加えられた作業、修理に費やした能力です。台帳は、プロダクトと運用の間の優先順位付けの会話に反映されます(問題の記録と恒久的な修正はトピック4.1「問題管理のメトリクス」を、負債が生む割り込みの負荷はトピック2.9「運用作業と計画外作業」を参照)。
このトピックで使う用語です。
- 回避策は、原因を取り除かずに、サービスを復旧させる、または失敗を避ける方法です。
- 恒久的な修正は、原因を取り除きます。根本原因分析は、それを見つける作業です。
- コードのリファクタリングは、外部の振る舞いを変えずに、コードを再構成します。設計の負債を返済する通常の方法です。
- コードの臭いは、コードの表面にあるサインで、より深い問題を示すことがよくあります。見てみるきっかけであり、評決ではありません。
- 機会費用は、時間の一つの使い方を選ぶことで諦める、最良の代替案の価値です。すべての修正は機能と競合し、その比較こそが本当の判断です。
- 遅延のコストは、ある作業を先送りすることによる経済的な損失です。負債の項目の利息に値付けする考えの背後にあります。
- ソフトウェアのバグは、ソフトウェアの欠陥です。既知のエラーは、バグ、設定の弱点、設計の限界、供給者の欠陥のいずれでもありえます。
- 静的プログラム解析は、実行せずにコードを調べます。その警告と複雑さのスコアは、負債の可能性の指標であり、インシデントの履歴より弱い証拠です。
すべての負債が間違いなのではありません。マーティン・ファウラーの四象限は、意図的な負債と不注意な負債、無謀な負債と慎重な負債を区別します(参考文献の一覧を参照)。返済計画のある慎重な近道は、健全な借入であり、防ぐべきは無謀な負債です。ここでのメトリクスは、出どころを判断しません。残高を示します。
重要な原則
- 一つの台帳、二つの入口。 運用からの既知のエラーと、デリバリーからの負債の項目は、同じ見える一覧に入り、同じ原因を記述する記録の間にリンクを張ります。
- 利息を測り、元本も測る。 修理の大きさは、開いている項目が毎月、インシデント、回避策、遅くなった変更で、いくらかかるかほど大切ではありません。修理の労力の単位あたりの利息で順位付けしてください。
- 先送りを、オーナーのいる判断にする。 すべての項目に、オーナー、待つ理由、レビューの日付があります。誰も先送りを選ばなかった項目は放置であり、そう数えます。
- 必要になる前に能力を守る。 事前に合意した、各チームの能力の、修理作業のための決まった割合は、悪い四半期のあとの英雄的な掃除に勝ります。
- 回避策を誠実に保つ。 回避策は、独自のコスト、オーナー、失敗の様式を持つサービスです。どれくらいの頻度で使われ、どれくらいの頻度で失敗するかを測ってください。
- システムを記述し、決して人を記述しない。 負債は、サービスまたはコンポーネントのものです。作者に帰してはならず、触った負債でエンジニアを順位付けしてもなりません。
- 粗く見積もる。 「時間」「日」「週」の大きさで十分です。それ以上の精度は作り物です。
メトリクスの定義
以下のメトリクスは、先送りされた修理の台帳を記述します。時計と境界は、各計算式に述べます。時間の尺度は、単一の平均ではなく、分布(中央値と85または95パーセンタイル)として報告します。
| メトリクス | 定義 | 計算式 | 単位 | データソース | ITIL プラクティス | アジャイルの対応物 | 頻度 |
|---|---|---|---|---|---|---|---|
| 既知のエラーのバックログの経過時間 | 開いている既知のエラーが、恒久的な修正を待った時間 | 時計は、問題の記録が「既知のエラー」とされたときに始まり、恒久的な修正が本番にリリースされたときに止まる。「受容されたリスク」として閉じられた項目は別に報告し、除く。件数、経過時間の中央値、85パーセンタイルの経過時間を、サービスごとに報告する | 日(分布) | ITSMツールの問題と既知のエラーの記録、リリースの記録 | 問題管理 | 滞留している作業項目のチャート、バグのバックログの経過時間 | 月次 |
| 回避策のカバレッジ | 開いている既知のエラーのうち、担当者が従える、文書化され、テストされた回避策があるものの割合 | 過去6か月以内にレビューされた回避策を持つ開いている既知のエラー ÷ 開いている既知のエラー。閉じられた項目と受容されたリスクの項目は除く | パーセント | 既知のエラーの記録に紐づくナレッジベース | 問題管理、ナレッジ管理 | ランブック、または運用性についての完了の定義 | 月次 |
| 開いている既知のエラーに紐づくインシデント | 原因が、開いている既知のエラーであるインシデント。サービスの中断で支払われた利息の直接の尺度 | インシデントが始まったときに開いていた既知のエラーに紐づく、期間内のインシデント ÷ 期間内のすべてのインシデント。原因のリンクのないインシデントは、数えずに、リンクなしとして報告する | パーセントと件数 | ITSMツールのインシデントと問題のリンク | インシデント管理、問題管理 | 見逃された欠陥、本番のバグの流入 | 月次 |
| 負債の残高 | 開いたままの、登録された技術的負債の項目の数と、見積もった大きさ | 期間末時点の負債台帳の開いている項目。大きさは、登録時に割り当てた粗い労力の帯(時間、日、週)の合計。登録されていない、または疑われる負債は除く | 件数と労力の帯 | トラッカーの、サービスでタグ付けされた負債の台帳 | 継続的改善、サービス設計 | 負債とラベル付けされたプロダクトバックログの項目 | 月次 |
| 負債の利息 | 開いている負債と既知のエラーによって引き起こされる、チームの時間での追加の作業 | 負債または既知のエラーの参照でタグ付けされた作業項目に記録された期間内の時間(回避策、手作業の手順、手戻り、影響を受けた変更への追加の労力)÷ 期間内のチームの総労働時間。修理の作業自体は除き、能力の割合の下で数える | 労働時間のパーセント | チームの水準で保たれる、作業項目の時間または労力のタグ | 継続的改善、問題管理 | 計画外の作業と手戻りの割合 | 月次 |
| 負債への能力の割合 | 負債と既知のエラーの解消に費やされた、デリバリーの能力の割合 | 負債の修理または既知のエラーの修正としてタグ付けされた、完了した作業項目の能力(項目数または労力)÷ 期間内に完了したすべての作業項目。タグのない項目は除く | パーセント | トラッカー、タグ別の完了した項目 | 継続的改善、変更実現 | 能力の配分 | 計画期間ごと、月次でレビュー |
| 負債の純増減 | 台帳が増えているか、縮んでいるか | 期間内に登録された負債と既知のエラーの項目 − 期間内に解決された項目。解決とは、修正がリリースされたことであり、マージされたことではない。「修正しない」として閉じられた項目は、別の行で数える | 件数(符号付き) | 負債の台帳と既知のエラーの記録 | 継続的改善 | カテゴリ別のバックログの変化 | 月次 |
受容されたリスクは、既知のエラーを閉じる正当な方法です。修正する価値のない問題もあるからです。項目を閉じても経過時間の数字が静かに改善しないよう、別に列挙します。回避策のカバレッジの6か月というレビューの窓は、一例です。チームは、システムの変化の速さに合わせて窓を設定し、メトリクス台帳に書きます。
推奨事項
台帳を作る
1. 既知のエラーの一覧と負債の一覧を、一つの台帳に統合する。 出どころ(運用またはデリバリー)、サービス、オーナー、大きさの帯、関連する記録へのリンクの項目を持つ、一つの台帳を保ってください。ITSMのツールが保持しても、トラッカーが保持してもかまいませんが、各システムが他方にリンクしている必要があります。単一の見方がないと、運用の既知のエラーは、デリバリーの見えない負債の項目と、同じエンジニアをめぐって競合します。
2. 負債を、作られたとき、または見つかったときに登録する。 意図的に取られた近道は、同じプルリクエストまたは変更記録の中で、述べられた理由とレビューの日付とともに台帳に入ります。のちに見つかった負債は、見つけた人が登録します。定期的な監査より、安上がりな一行の記録のルールのほうがうまく機能します。人は、前の四半期に知っていたことを忘れるからです。
利息を測る
3. インシデントを、毎回既知のエラーに結びつける。 インシデントとその既知のエラーとの間のリンクは、利息についての最も強いデータで、解決時の数秒しかかかりません。原因が分かっているときは、リンクを必須の項目にし、リンクのない割合を報告して、欠落が良い知らせに見えないようにしてください(トピック3.3「インシデントの対応時間と解決時間」を参照)。同じ原因が複数のインシデントに現れるとき、問題の記録が、修正の証拠を運びます。
4. 負債が生む作業にタグを付ける。 エンジニアが、既知の弱点のために回避策、手作業の手順、追加の手戻りが必要だったときに、作業項目に印を付け、台帳の項目にリンクできるようにします。タグはほとんどコストがかからず、チームの水準での負債の利息の数字を与えてくれます。結果を、誤差の大きい見積もりとして扱ってください。項目の順位付けと傾向を見るのには役立ちますが、会計には向きません。
5. 各項目を、二つの数字で値付けする。修理の労力と、毎月の利息。 労力には、時間、日、週のような粗い帯を、毎月のコストには、紐づくインシデント、タグ付けされた作業、組織がすでに見積もっているダウンタイムのコストから引いた、おおまかな値を使ってください。利息を労力で割ると、単純な回収期間が得られます。精度を作り出さないでください。帯と述べられた前提で、明らかな勝ちと、待てる項目を分けるのに十分です。
能力を守り、決める
6. 常設の能力の割合を確保し、報告する。 各サイクルの割合を、修理作業のためにプロダクトオーナーと合意し、台帳の傾向で設定し、四半期ごとに見直してください。負債への能力の割合を、計画された作業の数字の隣に報告し、リーダーが、修理の作業を意図的な投資として見られるようにします。確保された割合は、毎回の計画の会話でのトレードオフの議論からもチームを守ります。そこでは、たいてい機能のバックログが勝つからです。
7. 修理を機能と、一つの共通の通貨で順位付けする。 既知のエラーと負債の項目を、遅延のコストと回収期間で表して、機能と同じ優先順位付けの会話に入れてください。毎週のインシデントを取り除き、四半期でその労力を取り戻す修正は、それ自体の価値で競合します。声の大きさ、年功、登録の日付による順位付けは、悪い結果を生みます(トピック4.4「変更の失敗と手戻り」を参照)。
8. 先送りの判断のループを閉じる。 意識的に開いたままにされた各項目について、誰がリスクを受け入れたか、レビューの日付、二回目のインシデントや、その領域での計画された変更のように、それを優先順位の上に動かす引き金を記録してください。受容された一覧を、それ自身の頻度でレビューします。引き金なしに三回先送りされた項目は、それを無視するという決定であり、台帳はそう述べるべきです。
数字を誠実に保つ
9. 記録を閉じる前に、修正をリリースする。 既知のエラーは、恒久的な修正が本番にあり、定めた窓にわたって再発が確かめられるまで、開いたままです。「マージ済み」や「チケット完了」で閉じると、経過時間と純増減の数字を良く見せ、のちにインシデントを再び開きます(トピック4.5「リリースとデプロイのメトリクス」を参照)。既知のエラーの再開率を、閉じるルールの品質チェックとして追ってください。
10. 合計を超えて、台帳の形を見る。 横ばいの件数は、とても古い項目の長い尾、一つのサービスで増えている項目の割合、すべてを「修正しない」として閉じて小さく保たれた台帳を、隠すことがあります。経過時間の分布、サービスごとの内訳、受容されたリスクの一覧を、一ページに示してください。サービスを所有する人々と、次の四半期の作業を計画するのと同じ会議でレビューします。
ゲーミングの手口と防護柵
| メトリクス | ゲーミングされ方 | 組にする防護柵のメトリクスまたはプラクティス |
|---|---|---|
| 既知のエラーのバックログの経過時間 | 古い記録を「受容されたリスク」や「修正しない」として閉じる、一つの古い記録を新しく若い記録に分割する、再登録で時計をリセットする | 受容されたリスクの件数と経過時間を同じページで報告する、所有するチームの外の人による閉じた記録のレビュー、記録の系譜を保つ |
| 回避策のカバレッジ | 項目を満たすために曖昧な回避策を書く、どの担当者も試したことのない回避策を数える | 紐づくインシデントでの回避策の使用と失敗の率、回避策の標本の定期的なテスト |
| 開いている既知のエラーに紐づくインシデント | 割合が下がるよう、インシデントをリンクなしのままにする、または別の原因に結びつける | その隣で報告するリンクのないインシデントの割合、見逃されたリンクについての閉じたインシデントの標本レビュー |
| 負債の残高 | 残高が小さく見えるよう負債を登録しない、多くの項目を一つの大きな項目にまとめる、熱心に見せるために些細なことを登録する | コードレビューとインシデントのポストモーテムの標本に対する台帳のレビュー、項目の大きさと具体性のチェック |
| 負債の利息 | 精査を避けるために作業へのタグ付けを少なくする、修理の予算を勝ち取るために多くする、数字をチームの格付けとして読む | タグ付けされた項目とされていない項目の標本監査、チーム間の比較なしの、チームの水準の見方のみ、インシデントのリンクと合わせて読む利息 |
| 負債への能力の割合 | 通常の機能の作業を修理としてタグ付けする、割合を満たすために、簡単で見た目だけの項目を選ぶ | 成果のチェック:最も利息の高い古い項目の経過時間とインシデントのリンクが下がっているか、順位付けに照らして何が直されたかのレビュー |
| 負債の純増減 | 少数の大きなものを相殺するために多くの些細な項目を解決する、件数を下げるために項目を「修正しない」として閉じる | 大きさの帯と利息で示す純増減、「修正しない」の行の報告、解決した項目の再発チェック |
健全な読み取りは、見え、具体的で、チームが選んだ方向に動いている台帳を示します。最も利息の高い古い項目は、数が減っています。開いている既知のエラーに紐づくインシデントは下降傾向で、リンクのない割合は小さいです。負債への能力の割合は、危機のあとに急上昇してその後消えるのではなく、合意した水準で安定しています。受容されたリスクの一覧は短く、レビューされています。ほかが動かないのに、一つの数字だけが優れて見えるときは、祝う前に定義を疑ってください。
トレードオフ:長所と短所
| アプローチ | 長所 | 短所 |
|---|---|---|
| 既知のエラーと負債の、一つの統合された台帳 | 単一の優先順位付け。運用とデリバリーが同じコストを見る | 共有のツールまたはリンクが要る。二つの機能にまたがるオーナーシップを決めなければならない |
| 修理のための常設の能力の割合 | 予測しやすい。修理の作業を機能の圧力から守る | 順位付けが弱いと、価値の低い項目に使われうる |
| 優先順位の議論に勝ったときだけスケジュールされる修理の作業 | 柔軟。今の優先順位に応える | 機能がほぼ常に勝つ。台帳は危機まで増える |
| インシデントとタグ付けされた作業から見積もる利息 | 負債を観測できるコストに結びつける。順位付けを支える | おおまかな数字。誠実なタグ付けとインシデントのリンクに依存する |
| 専用の修理の集中投入、または「負債の週」 | 焦点と目に見える進捗 | 断続的。イベントの間に台帳が満ちる。計画されたコミットメントを中断する |
最も古い利息の高い項目を動かし続ける、最も軽い取り決めを選んでください。小さなチームは、一つのボードにラベルと月次のレビューで台帳を運用できます。より大きな組織には、ツール間のリンクと、合意した順位付けの方法が要ります。目指すのは、各項目についての意図的な判断であり、空の一覧ではありません。
チームで話し合う問い
1. 毎月、私たちに最もコストがかかっている、開いている三つの項目はどれで、どうやってそれを知っているか。 人々に、記憶から候補を挙げてもらい、次にインシデントのリンクとタグ付けされた作業と照合してください。記憶された一覧と測られた一覧を比べ、差を書き留めます。これからは順位付けの証拠をどう集めるかを合意してください。
2. 修正を先送りするとき、誰が決め、いつもう一度見るのか。 直近の五つの先送りをたどり、誰がリスクを受け入れ、どんなレビューの日付が設定されたかを問います。誰も決めていなければ、その項目は先送りされたのではなく、放置されたのです。すべての先送りに、オーナー、理由、引き金を持たせるルールを合意してください。受容されたリスクの一覧が、誰によって、どのようにレビューされるかを話し合います。
3. 修理のためにどれだけの能力を確保すべきか、何がその割合を変えるか。 台帳の傾向と、現在の負債への能力の割合を示してください。それを上げるために、チームが何を諦めてもよいか、何の証拠があれば下げられるかを問います。数字、理由、見直す日付を記録してください。
4. 私たちの回避策は本物か、新しい担当者はそれに従えるか。 回避策を無作為に一つ選び、それを書かなかった人に従ってもらいます。最も影響の大きいエラーをカバーする回避策のためのテストの手順を合意してください。
5. 何が直ったことになり、記録を閉じる前にどれだけ見守るのか。 運用、デリバリー、プロダクトオーナーが使う、閉じるルールを比べてください。サービスに合う再発の窓と、閉じた項目が再び開いたときにチームが何をするかを話し合います。一つの定義を合意し、メトリクス台帳に書いてください。
6. 私たちの負債の数字は、どこで心地よい物語を語っているかもしれないか。 それぞれの数字が良く見せられうる方法を挙げてもらってください。登録されていない負債、簡単な項目を先に直すこと、修正しないとして閉じられた項目。リンクのないインシデントの割合と、受容されたリスクの一覧を見ます。今四半期に加える防護柵を一つ選び、誰がそれを確かめるかを名指ししてください。
四つの視点
プロダクトチームとデリバリーチーム
デリバリーチームは、たいていコードを変更している間に、最初に負債を見ます。彼らは、加えやすい台帳と、能力の保護された割合から利益を得ます。そうすれば、修理の作業は、毎回の計画の会話での議論に勝つことに依存しません。近道を取るときに登録し、弱点が引き起こした作業にタグを付け、負債を、やりたくない作業のラベルとして使うことは避けるべきです(負債のリードタイムへの影響は、トピック2.2「リードタイム、サイクルタイム、フロー効率」を参照)。
サービスチームと運用チーム
運用チームは利息を見ます。繰り返されるインシデント、手作業の手順、壊れやすい回避策、その後に続くオンコールの負荷です。彼らは既知のエラーの記録と回避策のドキュメントを所有し、利息に値付けするインシデントのデータを持っています。すべてのインシデントをその既知のエラーに結びつけ、回避策をテストし、不満の一覧ではなく、順位付けされた証拠を計画の会話に持ち込むべきです(トピック5.7「トイルとオンコールのメトリクス」を参照)。
リーダーシップとガバナンス
リーダーは、修理の作業がどれだけの能力を受け取るかを決め、彼らが設定するインセンティブが、台帳が誠実なままかどうかを決めます。単一の負債のスコアではなく、経過時間の分布、利息の数字、受容されたリスクの一覧を求めるべきです。台帳をチームの格付けとして読むと、登録を罰し、負債を地下に追いやります。ガバナンスの場は、リスクの受容を、オーナーとレビューの日付のある決定として扱うべきです。
顧客とユーザー
顧客は、負債を、繰り返される失敗と、従わなければならない回避策として感じます。回避策がユーザーに影響するところでは、修正がいつ期待されるかの平易な注記とともに公開し、その日付を守るか、変更を説明してください。繰り返されるインシデントの減少と、既知の問題についての誠実な状況は、欠陥ゼロの約束より多くの信頼を築きます(トピック6.1「顧客満足度のメトリクス」を参照)。
実践:アジャイルITILの例
地域の病院のIT部門が、一つのプロダクトチームと運用グループが支える、患者の予約サービスを運用しています。この例の数字はすべて例示です。
運用グループは、ITSMツールに23件の既知のエラーを持っています。プロダクトチームは、ボード上に、41件の負債の項目の別の一覧を持っています。四半期のレビューで、既知のエラーのうち9件と、負債の項目のうち7件が、同じ五つの原因を記述していることが分かります。最も古い既知のエラーは14か月前のもので、既知のエラーの経過時間の中央値は5か月、85パーセンタイルは11か月です。回避策のカバレッジは61パーセントです。開いている既知のエラーに紐づくインシデントは、四半期のインシデントの18パーセントで、22パーセントのインシデントはリンクがないので、実際の割合はもっと高いかもしれません。
チームは二つの一覧を、55件の別個の項目の一つの台帳に統合します。紐づくインシデントが最も多い十件について、帯で修理の労力を、時間で毎月の利息を見積もります。一つの項目が際立ちます。夜間の予約の同期ジョブが、約二週間に一度、黙って失敗し、オンコールの職員の手動の再起動を必要とします。その修理は二週間と見積もられます。その利息は、紐づくインシデントとタグ付けされた作業から、月に約10時間で、失敗のたびに、朝の外来の一覧が遅れます。回収期間はおよそ四か月で、そのとき計画にあったどの機能よりも速いです。
意思決定ログに記録される決定は、プロダクトチームの能力の15パーセントを、労力の単位あたりの利息で順位付けした修理の作業のために確保し、同期ジョブを最初に直すことです。運用の責任者も、既知のエラーがある場合はすべてのインシデントをそれにリンクし、最もよく使われる五つの回避策をテストすることに同意します。
二四半期後、既知のエラーの経過時間の中央値は4か月、85パーセンタイルは9か月です。開いている既知のエラーに紐づくインシデントは、11パーセントに下がります。リンクのない割合は8パーセントに下がり、チームはその数字により自信を持てます。その後、チームはゲーミングのリスクを捉えます。負債の純増減の行は、四半期に12件の項目が解決されたことを示しますが、そのうち6件は修正しないとして閉じられており、そのうち二つは、最も古い利息の高い項目でした。チームの外のレビュアーが記録を読み、閉じるのが経過時間の数字を改善するために行われたと見つけます。項目は再び開かれ、閉じる理由は、名前のある承認者を伴う必須の項目になり、受容されたリスクの項目は、経過時間の分布と同じページに現れるようになります。
業種別の視点
スタートアップ。 負債はたいてい意図的で、多くは正しいです。最初の顧客までの速さが最も大切だからです。ボード上にラベル付きの一覧を一つ保ち、近道を取るときに登録し、「あとで」に意味が生まれるよう、レビューの日付を設定してください。利息がインシデントに現れ始めたら、修理の割合を上げます。
小規模事業者。 一人の管理者または小さなチームが、運用とデリバリーの両方を担うことがよくあり、二つの一覧は自然に一つです。既知のエラーとその回避策を共有のドキュメントに記録し、各項目がどの供給者や契約に依存しているかを書き留めてください。供給者が所有する欠陥は、自分では直せない既知のエラーなので、供給者が約束した日付と自分たちの回避策を追います。
大企業。 多くのチーム、多くのサービス、多くの供給者は、いくつもの競合する一覧と、「完了」のいくつもの定義を生みます。台帳の構造、閉じるルール、順位付けの方法を一つに決め、チームが、述べられた対応づけとともに、ローカルの項目を加えられるようにしてください。
政府・公共部門。 レガシーシステム、長い調達のサイクル、固定の予算は、返済に費用のかかる負債と、遅い置き換えの判断を生みます。修正を妨げる法的、保存、監査の制約を記録してください。それらが先送りを説明するからです。台帳をリスクの報告の一部として示し、修理を、計画外のコストとして扱うのではなく、予算のサイクルの中で計画します(トピック8.5「規制対応・行政向け報告」を参照)。
ビジネスケース:動機、ROI、TCO
動機は、見えない利息を払うのをやめることです。繰り返されるインシデント、手作業の回避策、遅くて危険な変更は、目に見えるコストで、通常は別々の予算の中の別々の問題として記録されます。統合された台帳は、それらを、修理のコストと負債を抱えるコストとの一つの比較に変えます。
この実践のコストは、三つの部分から成ります。一つ目は準備です。台帳、ITSMツールとトラッカーの間のリンク、タグ付けの規約。二つ目は運用の労力です。インシデントにリンクを張る数秒、作業項目にタグを付ける数秒、サービスごとの一、二時間の月次のレビュー。三つ目は修理の能力そのもので、これが最大の項目であり、間接費ではなく、意図的な投資です。
見返りは、自分で測れるパターンから来ます。既知のエラーに紐づくインシデントを、その修正の前後で比べ、影響を受けた変更のタグ付けされた作業の時間を前後で比べ、避けられたオンコールの割り込みを見てください。組織がすでに見積もっているなら、ダウンタイムのコストを加えます。負債のコストについて、業界の数字を借りないでください。この主題の研究文献は本物ですが、数字は文脈に依存し、自分のインシデントと時間のデータのほうが、より良い証拠です。Accelerateの研究は、デリバリーの成果を組織の成果に結びつけますが(トピック2.8「DORAメトリクス」を参照)、あなたの台帳に値段をつけるものではありません。コストと見返りのより広い扱いは、トピック7.7「投資対効果とビジネスケース」を参照してください。
アンチパターンと落とし穴
- 決して出会わない二つの一覧。 運用とデリバリーが、異なる証拠で同じ能力を主張します。一覧を統合するか、共有するすべての原因にリンクを張ってください。
- 組織の単一の負債スコア。 コストがどこにあるかを隠し、チームの順位付けを招きます。台帳を、経過時間、利息、オーナーシップとともに、サービスごとに報告してください。
- 唯一の修理としての大きな書き直し。 大きな掃除は停滞し、それが進む間に台帳は満ちます。項目を、回収期間で順位付けして、小さな段階で退役させてください。
- 目標としての負債ゼロ。 それを追うと、些細な閉じ方に報い、誠実な登録を妨げます。最も古い利息の高い項目が動いている台帳を目指してください。
- 「マージ済み」で既知のエラーを閉じる。 修正はまだユーザーに届いておらず、インシデントは戻ります。リリースで閉じ、定めた窓にわたって再発を見守ってください。
- 「修正しない」に先送りを隠す。 経過時間の数字は改善し、リスクは残ります。受容されたリスクを、オーナーとレビューの日付とともに、別に数えてください。
- 静的解析を真実として扱う。 スコアは、コストではなく、コードの形を反映します。候補を見つけるために使い、インシデントのリンクと変更の履歴で確かめてください。
- 負債を作者に帰する。 人々に、近道を隠し、難しいコンポーネントを避けるよう教えます。すべての尺度を、サービスとチームの水準に保ってください(トピック1.2「グッドハートの法則とメトリクスの心理学」を参照)。
成熟度モデル
| 次元 | 1 開始 | 2 発展 | 3 標準化 | 4 管理 | 5 最適化 |
|---|---|---|---|---|---|
| 台帳と定義 | 既知のエラーと負債が、人々の頭の中か、散らばったメモにある | 運用とデリバリーがそれぞれ一覧を持ち、ルールが異なる | すべての項目に、文書化された定義、オーナー、閉じるルールを持つ一つの台帳がある | 経過時間、受容されたリスク、純増減を、文書化された定義に照らしてレビューする | 定義が判断に役立たなくなったとき、供給者と顧客とともに改訂される |
| 利息の測定 | インシデントと原因の間にリンクがない | 一部のインシデントが、手作業で既知のエラーに結びつけられる | 原因が分かっているところでインシデントのリンクが必須で、作業がチームの水準でタグ付けされる | 上位の項目の利息と回収期間が見積もられ、傾向として追われる | 利息がサービスの成果に結びつけられ、チームと供給者の間で共有される |
| 能力と優先順位付け | 修理は危機の中で起きる | 一部のチームが非公式に時間を確保する | 合意した能力の割合と、共通の順位付けの方法 | 割合が台帳の傾向で調整され、計画された作業として資金が出る | 修理の能力が、共有のプラットフォームと供給者を横断して調整される |
| 回避策と閉じること | 回避策が文書化されていないか、一人が持っている | 一部のエラーで文書化されているが、テストされていない | 回避策がナレッジベースにあり、リリース時に閉じるルールがある | 回避策の使用、失敗、閉じたあとの再発が測られる | 修正がリリースされるにつれて、ユーザーからのフィードバックとともに、回避策が自動的に退役する |
チェックリスト
- 既知のエラーと負債の項目が、一つの台帳にあるか、項目ごとにリンクされている。
- すべての項目に、オーナー、大きさの帯、サービス、レビューの日付がある。
- 意図的な近道が、取られたときに理由とともに登録されている。
- 原因が分かっているところでインシデントが既知のエラーにリンクされ、リンクのない割合が報告されている。
- 弱点が引き起こした作業が、チームの水準でタグ付けされ、タグ付けが標本で監査されている。
- 上位の項目のそれぞれに、修理の労力の帯と、毎月の利息の見積もりがある。
- 修理の作業のための能力の割合が、合意され、報告され、毎四半期レビューされている。
- 既知のエラーが、定めた再発の窓とともに、修正のリリースで閉じられている。
- 受容されたリスクによる閉じ方が、承認者とレビューの日付とともに、別に列挙されている。
- 最も影響の大きいエラーの回避策が、スケジュールに沿ってテストされている。
- 経過時間の分布とサービスごとの内訳が、合計とともに示されている。
- どの負債の尺度も、個人を比較したり順位付けしたりするために使われていない。
AI プロンプト
二つの一覧を一つの台帳に統合する。
I have two lists of deferred repairs. List A comes from [operations tool or
source] and holds [number] known errors. List B comes from [delivery tracker or
source] and holds [number] technical debt items. Here are the entries:
[paste entries with title, service, date registered, and a one-line description].
Group entries that appear to describe the same cause, propose a single ledger
entry for each group, and flag entries that need a human to confirm the match.
Do not invent causes, services, or dates. List your assumptions and the questions
I should answer before merging.
上位の項目の労力の帯と毎月の利息を見積もる。
For the ledger item [item title] on [service], I have this evidence: linked
incidents [list with dates and durations], tagged work [hours or item counts],
and a repair estimate from the team of [estimate]. Help me write coarse effort
and monthly interest bands, a simple payback time, and the confidence level for
each figure. Show your arithmetic. Do not invent costs, benchmark values, or
industry figures. If a figure is missing, ask me for it. List your assumptions.
閉じ方とゲーミングのリスクをレビューする。
Here are the definitions and the last quarter's data for our known error and debt
ledger: [definitions of age, workaround coverage, debt net change, and the closure
rule] and [summary of items closed, with closure reasons]. Identify the ways
these measures could be flattered, the evidence in the data that suggests it has
happened, and a guardrail for each. Treat this as a review of the instrument, not
a review of people. Do not accuse anyone, and do not invent data. List your
assumptions.
プロダクトオーナーとの優先順位付けの会話を準備する。
I need to propose how to split capacity between features and repair work for
[team] next quarter. The ledger shows [summary of ledger: counts, age
distribution, top items with effort and interest bands]. The feature plan
contains [summary of planned features and their expected value, as supplied by
the product owner]. Draft a one-page proposal that compares options for the
repair share, states the cost of delay of the main repair items, and names the
trade-offs. Do not invent value estimates or benchmark shares. List your
assumptions and the decisions the product owner must make.
AI スキル
- Agile ITIL Metrics スキル:再発や変更失敗のような、関連するメトリクスを定義するトピックと、その隣に置くべき防護柵を見つけるために使います。
- Agile ITIL Metrics メンテナースキル:編集されたメトリクスが、時計、ゲーミングの手口、防護柵を名指ししているかを確かめるために使います。
重要なポイント
- 既知のエラーと技術的負債は、先送りされた修理の一つの台帳の二つの見方なので、一緒に保つか、リンクしてください。
- 各項目が毎月、インシデント、回避策、遅くなった変更でかけるコストである利息を測り、回収期間で修理を順位付けしてください。
- すべての先送りを、オーナー、理由、レビューの日付のある判断にし、受容されたリスクは別に報告してください。
- 修理の作業のために合意した能力の割合を確保し、計画された作業の隣に報告してください。
- 既知のエラーは、修正のリリースで閉じ、結果を信頼する前に再発を見守ってください。
- すべての尺度をサービスとチームの水準に保ち、より良い数字がより良いシステムを意味するよう、防護柵を使ってください。
参考文献とさらなる読み物
- Cunningham, W., "The WyCash Portfolio Management System," OOPSLA '92 Experience Report, ACM, 1992.
- Fowler, M., "Technical Debt Quadrant," 2009, https://martinfowler.com/bliki/TechnicalDebtQuadrant.html
- Fowler, M., Refactoring: Improving the Design of Existing Code, 2nd edition, Addison-Wesley, 2018.
- Kruchten, P., Nord, R., and Ozkaya, I., Managing Technical Debt: Reducing Friction in Software Development, Addison-Wesley, 2019.
- Sculley, D., and others, "Hidden Technical Debt in Machine Learning Systems," Advances in Neural Information Processing Systems 28, 2015, https://papers.nips.cc/paper_files/paper/2015/hash/86df7dcfd896fcaf2674f757a2463eba-Abstract.html
- Reinertsen, D. G., The Principles of Product Development Flow: Second Generation Lean Product Development, Celeritas Publishing, 2009.
- Forsgren, N., Humble, J., and Kim, G., Accelerate: The Science of Lean Software and DevOps, IT Revolution, 2018.
- Beyer, B., Jones, C., Petoff, J., and Murphy, N. R. (eds.), Site Reliability Engineering: How Google Runs Production Systems, O'Reilly Media, 2016, https://sre.google/sre-book/table-of-contents/
- Goodhart, C. A. E., "Problems of Monetary Management: The U.K. Experience," in Papers in Monetary Economics, Reserve Bank of Australia, 1975.
- Wikipedia, ITIL.
- Wikipedia, Technical debt.
- Wikipedia, Ward Cunningham.
- Wikipedia, Root cause analysis.
- Wikipedia, Code refactoring.
- Wikipedia, Code smell.
- Wikipedia, Opportunity cost.
- Wikipedia, Cost of delay.
- Wikipedia, Software bug.
- Wikipedia, Static program analysis.