AI研究
Helper CTO シリーズ 22|AIプロトタイプから本番製品へ:足すべきは機能ではなく保守性
AIツールで作ったプロトタイプは動いてデモもできるが、本番公開の段階で多くの人が機能を急いで足そうとし、足すほど誰も手を出せなくなる。本記事は保守性を「理解できる・変更できる・異常に気づける・作り直せる」の4つで定義し、どれから補うべきかの順番を示す。
「Cursorで作ったので、コードは自分のパソコンにあります。エンジニアに引き継ぐなら、何を準備すればいいですか。」AIツールで製品を作ったオーナーが、引き継ぎ先を探すときに最初に聞くのがこの質問です。準備せずに渡してしまうと、引き継ぐ側は時間の半分を「見ること」ではなく「探すこと」に使うことになり、その時間の費用は結局あなたが払うことになります。技術に詳しくないから引き継ぎが下手なのではなく、何を棚卸しすべきか誰も教えてくれなかっただけです。以下の4つを準備してから渡してください。
Cursor、Claude Code、Lovableを使って作る過程はスムーズなので、途中でどれだけのものが増えているか、あまり意識しないものです。
最初のステップはコードを送ることではなく、まず自分で一度棚卸しすることです。棚卸しして初めて、そもそも自分名義になっていないものがあると気づく人が多いです。
棚卸しすべきはこの4つで、どれも自分でできる内容です。
| 引き継ぐもの | 自分でまず何をするか | 準備しない場合の結果 |
|---|---|---|
| ソースコード | 会社名義のリポジトリに入れる | 引き継ぐ人はあなたのパソコンしか見られない |
| 起動方法 | 自分の言葉でどう動かすかを書き出す | 初日から起動できずに詰まる |
| 外部サービス | サービス名、アカウント、費用、APIキーを一覧にする | カードが期限切れになり、機能が静かに止まる |
| 機能一覧 | 使っている・不明・使っていないに分類する | 誰も使わない機能まで保守し続けることになる |
最後の一つだけはあなたにしかできません。最初の3つはエンジニアが補えますが、補うのにかかった時間の費用はあなたが払うことになります。
コードは製品そのものです。まず「他人に見せられる場所」にあることを確認してください。
次に、どう動かすかを書き出します。技術文書として書く必要はありません。
専門的に書けなくても構いません。本当に説明できない——毎回AIに頼んで起動している——場合は、そのやり取りの記録ごと渡してください。
AIで作った製品はほぼ必ず外部サービスを使っていて、それぞれにアカウント、費用、APIキーがあります。この表は一番見落とされやすく、一番早くトラブルになる部分です。
4つ目だけはあなたにしかできません。AIの特性は「一言指示すると、三つのことをする」ことです。引き継ぐ人にはどれが本当に必要な機能で、どれがついでに追加されたものか区別がつかず、すべてを保守対象として扱うしかなくなります。製品を開いて1ページずつクリックし、使っている・不明・使っていないの3つに分類してください。プロトタイプから本番製品への記事で触れた通り、誰も使わないものを取り除くのは、この一覧があってこそです。
4つの準備が整ったら、次は誰に渡すかです。まず、多くの人が心配していることをはっきりさせておきます。
順序はまず見せる、レポートを受け取る、そのうえで協力するかどうかを決める、です。Vibe Codingと本物のシステム設計のギャップの記事はプロトタイプとシステムの違いを扱っていて、健診はまさにあなたの製品でそのギャップを測るものです。デモができることと本番公開できることは違うの記事で挙げた5つの項目のうち、いくつかの根っこはこの2つの表にあります。
引き継ぎがうまくいくかどうかを決めるのは、プログラムの出来の良し悪しではなく、ものが見つかるかどうかです。
AIで作った製品を渡す前にこの4つを準備しておけば、引き継ぐ人は時間を「探すこと」ではなく「理解すること」に使えます。Nerdtechnic(恩梯科技)は Helper CTO として、こうしたプロジェクトを引き継ぎ保守します——社内の技術責任者のような存在ですが、御社の正社員ではありません。最初のステップは60分のシステム健診です。コードさえ見せていただければよく、本番環境のアカウントやパスワードは不要で、3~5営業日以内に読んで分かる1ページのレポートをお渡しします。手元のものがまだ棚卸しできていなくても問題ありません。最初の棚卸しは私たちが一緒にお手伝いします。Helper CTO:システム保守プラン
お困りですか?
LINEで直接ご相談ください