Helper CTO シリーズ 13｜他人のコードを引き継いだ最初の1か月で私たちがすること

「あなたがたが引き継いだあと、最初の1か月で何をするんですか？お金を払ったのに何も見えないのが怖いんです。」この心配はもっともです。他人が書いたシステムを引き継ぐとき、いちばん高くつくやり方は、着手してすぐに手を入れ始めることです。3日目になってようやく「なぜ元の担当者がこう書いたのか」に気づき、1つ直したら2つ壊れる――そんなことが起こります。あなたが新しいチームを信用していないわけではなく、最初の1か月を丁寧に見せてくれた人が、これまでいなかっただけです。以下の4つの段階が、私たちの最初の1か月の全体の流れです。

引き継ぎは「すぐに手を入れる」ことではありません

他人が書いたコードの中で、不思議に見える箇所にはたいてい理由があります。ある顧客の特殊な要望だったり、当時の何らかの制約を回避するためだったり、あるいは本当に単純なミスだったりします。よく理解しないまま手を入れると、よくある結果は次の3つです。

• 1つ直すと2つ壊れる：一見無関係に見える2つの機能が、実は同じコードを共有しています。
• 直してから「変えられない」と気づく：その奇妙な書き方は外部サービスに合わせるためのもので、外すと帳尻が合わなくなります。
• チームを間違えたのではと疑い始める：最初の1か月がすべて火消しに費やされ、前進している実感がまったく得られません。

だからこそ、私たちが引き継ぐときのルールはただ1つです。最初の2週間は機能に手を入れません。これは遅いのではなく、「自分が何を知らないかも分からない」段階をきちんと通り抜けるためです。健康診断レポートはすでに方向性を示しています（健康診断は何を見ているのかの記事で4つの観点を解説しています）。最初の1か月は、そのレポートを実際に手を動かせる順番に変える期間です。

最初の1か月をタイムラインで見る

まず全体像をお見せします。どの週に何をして、どの週にあえて何をしないかを、次の表にまとめました。

いちばん見落とされやすく、いちばんトラブルにつながりやすいのが「あえてしないこと」の列です。引き継ぎの最初の1か月は、スピードより我慢のほうが価値があります。

第1週：見る、聞く、触れない

第1週にやることは3つで、すべて本番環境には触れません。

• コードを最初から最後まで読む：直すためではなく、地図を描くためです。どこが主要な流れで、どこが長らく誰も触れていない領域なのかを把握します。
• 取り戻すべきものをリスト化する：ソースコードは誰のアカウントにあるか、サーバーとドメインは誰の名義か、決済やSMS、メール送信のアカウントはどこにあるか——エンジニアが辞めたときに先に取り戻すべき12のものと同じリストです。
• あなたに質問する：どの機能を毎日使っているか、どの機能をまったく使っていないか、いちばん壊れてほしくないのはどこか、過去にどんなトラブルがあったか。

最後の項目がいちばん重要です。この答えが後の3週間の順番を決めますが、それはコードを読むだけでは分かりません。

第2週：まず安全網を整える

第2週もまだ機能は変えませんが、手を動かし始めます。動かすのは、この先のすべての変更を安全にする3つのものです。

1. バックアップ：データベースとアップロードされたファイルが毎日バックアップされ、サーバー以外の場所に保存され、実際に復元できることを確認します。
2. 監視：システムが落ちたとき、エラーが出たとき、サーバーの容量が逼迫したときに、顧客からの電話より先に誰かが気づける状態にします。
3. やり直せるデプロイ：「コードをどうやって本番環境に上げるか」を誰か1人の頭の中から、書き起こした手順に移します。壊れたら前のバージョンに戻せるようにします。

この3つが揃えば、システムにシートベルトが付いた状態になります。ここから手を入れる分については、ミスのコストがコントロールできるものになります。

第3・4週：最優先の3項目だけに絞る

健康診断レポートと第1週の地図には、たいてい長い問題リストが並びます。私たちはそのすべてには手を出さず、3項目だけを選びます。基準は「放置すると損失や事故につながるかどうか」です。

• セキュリティ上いちばん明らかに開いたままの扉。たとえばパスワードがコードに直接書かれている、管理画面に権限の区分がない、といったものです。
• いちばんよく壊れ、いちばん顧客からクレームが来る処理。まずこれを安定させます。
• この先のあらゆるアップデートを止めている古いバージョンのパッケージ。先に上げておくことで、以降のセキュリティ更新が可能になります。

3項目だけに絞る理由は、最初の1か月の目標がシステムを完璧にすることではなく、「誰も怖くて触れない」状態から「誰かが見ていて、安全に変更できる」状態に変えることだからです。残りは以降の毎月の保守に組み込み、1件ずつ処理していきます。引き継ぎの過程で気をつけるべき詳細は、システム運用引き継ぎガイドの記事に完全なチェックリストがあります。

Nerdtechnicが最初の1か月でお渡しするもの

• 現状マップ：システムにどんな部分があり、それぞれどんな状態で、どのアカウントがすでにあなたの名義に戻っているか。
• 稼働している安全網：バックアップ、監視、やり直せるデプロイ——すべて記録として確認できます。
• 対応済みの3つの問題と、優先順位を付けた対応リスト。以降は毎月これに沿って進めます。
• 読んで分かる月次レポート：今月何をしたか、来月何をする予定か、あなたの言葉で書かれています。

さらに重要なのは、状態そのものが変わることです。システムは「動いてはいるが誰も責任を持っていない」状態から、「誰かが責任を持ち、次に何をすべきか分かっている」状態に変わります。

他人が作ったシステムを引き継ぐとき、スピードより順番のほうが大切です。Nerdtechnic（恩梯科技）はHelper CTOとしてあなたのシステムを引き継ぎ、第1週から以降の毎月の保守まで同じチームが担当し、引き継ぎだけして去ることはありません。最初のステップは60分のシステム健康診断です。私たちが見るのはコードだけで、本番環境のアカウントやパスワードは必要ありません。3～5 営業日以内に、そのまま引き継げるか、整理してから引き継ぐべきか、それとも作り直したほうが安く済むかを1枚で分かるレポートにしてお渡しします。あなたのシステムが、まず見てから動く人を待っているなら、最初の1か月を私たちに任せてください：Helper CTO：システム保守プラン。