引き継ぎは初日から始まる

引き継ぎはプロジェクト末期の儀式として想像されがちです。数回の会議、急いで書かれた100ページの文書、リポジトリのアーカイブ。そして次のチームは、文書がもう存在しないシステムを記述していること、CI が4か月間赤いままなこと、火曜日に期限切れになる証明書の在り処を誰も知らないことを発見します。

成功する引き継ぎはイベントではなく、初日から維持されるプロジェクトの性質です。導きの問いはシンプルです。もし明日チームが入れ替わるなら、今日何が書かれているべきか? 以下のすべてはこの問いから導かれます。

実際に引き継がれるもの

ソフトウェアはソースコードに還元されません。引き継がれるのはそれを運用する能力であり、それは五つの棚卸しに収まります。

ランブック。デプロイ、リストア、既知の障害の診断の方法を、正確なコマンドとともに。
アクセスの地図。環境、サードパーティサービス、DNS、証明書、関連するシークレット。人の記憶ではなく保管庫に。
意思決定。コードが語れない「なぜ」を説明する、短く日付の付いたアーキテクチャ決定の記録。
認めた負債。脆いもの、回避したもの、暫定のものの正直なリスト。高くつくのは隠れた負債だからです。
カレンダー。証明書とドメインの期限、メジャーバージョンのサポート終了、ライセンスの更新。

これらの棚卸しのどれかが存在しなければ、引き継ぎは最悪のタイミングでそれを発見します。

再現可能な環境が土台

世界中のどんなドキュメントも、一つのコマンドで再構築できる環境の代わりにはなりません。コードで記述されたインフラ、コミットされた lock ファイルで固定されたバージョン、生成または匿名化された開発データ、そして緑であり続ける CI。緑の CI こそ本当の引き継ぎ契約であり、システムが記述どおりであることの実行可能な証明です。

最も正直なテストは半日で済みます。プロジェクトに触れたことのない人に、README だけを頼りにインストールしてもらう。出てくる質問の一つひとつが引き継ぎの穴であり、埋めた穴はその場で現行チームの利益になります。

保守はリズムであって、反応ではない

保守は、反応としてしか存在しないとき失敗します。報道された脆弱性、障害、強制されたアップグレード。リズムを持つとき成功し、そのリズムは三つの水準に収まります。

自動化ツール(Renovate、Dependabot)が提案を開き、CI が判定し、チームが裁定します。半年待たされたマイナー更新は事実上のメジャー更新になります。頻繁に上る小さな段は、強いられる大きな段に常に勝ちます。

二つのルールがリズムを持続可能にします。第一に予算。スケジュールに確保された、交渉の余地のない定期的な窓。「余った時間」に依存する保守は存在しないからです。第二に明示的なバージョンポリシー。どの部品が最新版を追い、どれが長期サポートを追うのか、いつまでか。

Semver は約束ではなく慣習

セマンティックバージョニングは作者の意図を表明するもので、あなたのシステムの現実ではありません。マイナーバージョンが、知らずに依存していた挙動を壊すことがあります。信頼は別の場所から来ます。プロジェクトの実際の使い方を覆うテスト、アップグレード前に読む changelog、そして小さく分離され、簡単に戻せるロットでの更新。月次のまとめ窓が機能するのもそのためです。妥当な量のロットを、まとめてテストし、まとめて戻せる。

活動ではなく健全性を測る

引き継がれるソフトウェアは、自らの計器を携えるべきです。人に警報を出す少数の可用性・エラー指標、サポート終了間近の依存関係のリスト、更新遅延の平均年齢。指標は少なく、しかし見られていること。誰も開かないダッシュボードは会議の小道具であって、計器ではありません。

最後のテスト:鍵を渡す予行演習

引き継ぎの最良の検証は、必要になる前に行われます。プロジェクト外の人が、文書化されたものだけを使い、模擬インシデントを診断から修正のデプロイまで担う演習です。演習のコストは1日で、唯一重要な情報が得られます。このシステムは作者の離脱を生き延びられるか?

私たちが適用するチェックリスト

運用可能なランブック。デプロイ、リストア、診断、コマンド付き。
アクセスとシークレットは保管庫に棚卸し。頭の中に置かない。
アーキテクチャ決定の記録は仕事の流れの中で。
負債と回避策は容赦なく文書化。
一つのコマンドで再構築できる環境。緑の CI は必須。
リズム:セキュリティは数日、マイナーは月次、メジャーは計画的に。
更新提案は自動化し、裁定は人間が。
期限のカレンダー:証明書、ドメイン、サポート終了。
年に一度、引き継ぎの予行演習。

よく引き継がれたソフトウェアは完璧なソフトウェアではありません。次のチームが一週間後にこう言えるソフトウェアです。「自分たちが何の上に立っているか、分かっている」。