AIで作った社内システムを別のAIに引き継ぐとき、
何を残すべきか
AIを使って社内システムを作ると、完成までの速さに比べて、判断の記録が不足しがちです。しかし、次のAIや担当者が必要とするのは、コードの説明だけではありません。「誰が何を入力するのか」「なぜこの確認を残したのか」「どこまで変更してよいのか」を、実際に動かして確認できる形で引き継ぐことが重要です。
先に結論
この記事で押さえたいこと
●最初に、稼働中のコード、データ、利用サービス、未対応事項を特定します
●業務上の判断は、結論だけでなく理由、影響範囲、見直す条件まで記録します
●引き継ぎ完了は、別の担当者が資料を使って再現・確認できるかで判断します
この記事の目次
最初に「いま動いている状態」を固定する
引き継ぎ資料を書く前に、どのコードと設定が現在使われているのかを確定します。開発途中のファイルや古いバックアップが混在していると、別のAIへ正しい資料を渡しても、違う版を前提に修正されるおそれがあります。
現場で確認すること
本番で使っているコードの保存場所と版
本番環境とテスト環境の区別
データベースや外部サービスの構成
最終バックアップ日時と復元手順
未完成の機能、不具合、暫定対応
認証情報やAPIキーの値は引き継ぎ文書へ直接書かず、保管場所、管理者、更新方法だけを示します。まず「何が現行版か」を一つに定めることが出発点です。
システムの目的と業務範囲を言葉にする
次に、システムがどの業務を支え、どこから先は人が判断するのかを整理します。機能一覧だけではなく、利用者、入力の開始点、最終的な出力、対象外の業務まで書いておくと、不要な機能追加や誤った自動化を防ぎやすくなります。
現場で確認すること
利用する職種・担当者と、それぞれの役割
入力する情報と、確認・承認する人
帳票や集計結果を何に利用するか
システム外で確認する業務
変更を最終判断する社内責任者
業務判断は「理由」と「見直す条件」まで残す
AIが生成したコードから、業務上の意図を正確に読み取れるとは限りません。判断記録には結論だけでなく、なぜ採用したのか、変更すると誰に影響するのか、どのような場合に見直すのかを残します。AIの提案と、社内で承認した判断も分けて記録します。
現場で確認すること
検討した課題と採用した結論
その判断に使った社内ルールや資料
採用しなかった案と、その理由
影響する画面、帳票、計算、担当者
判断日、確認者、再検討する条件
日付順の長いチャット履歴だけでは、確定事項を探しにくくなります。チャットは補足資料とし、承認済みの判断を一覧へ抜き出す運用が適しています。
入力者、確定者、修正履歴をデータごとに決める
同じ項目でも、入力した人と最終確定する人が異なる場合があります。項目名だけでなく、情報の出どころ、編集できる人、確定のタイミング、修正時に残す履歴を定義します。
現場で確認すること
各項目の意味、単位、必須・任意
最初に入力する担当者
確認・確定・修正できる権限
重複や差異が出た場合の扱い
削除せず残す履歴と、その確認方法
出面管理の例では、職人入力と経理入力を独立させ、差額を可視化するために二重確認を残しています。この仕組みを単なる重複と判断して統合すると、確認の目的まで失われます。二重入力を残す理由と、差額を誰が確認するかをセットで記録する必要があります。
計算条件と例外処理をコードの外にも残す
手当、締め処理、集計などは、計算式だけを見ても業務上の根拠が分からないことがあります。通常時の条件に加えて、例外、修正、再計算の扱いまで文章にします。
現場で確認すること
計算に使う元データと基準日
締めのタイミングと対象範囲
端数や未入力データの扱い
例外となる条件と確認担当者
確定後に修正した場合の再計算範囲
仕様と実装が一致しているかは、代表的な通常ケース、例外ケース、未入力ケースを用意して確認します。結果だけでなく、「何を正しい結果とするか」も残しておくことが重要です。
別の環境で再現できる資料を一式にする
引き継ぎ資料は、説明書を読めることではなく、別の担当者がテスト環境を動かせることを基準にします。特定のAIとの会話がなければ再現できない状態を避け、必要な情報を一か所からたどれるようにします。
現場で確認すること
使用する言語、ツール、外部サービスの版
初期設定、環境変数名、起動・停止手順
データ移行とバックアップからの復元手順
個人を特定しないテスト用データ
確認すべきテスト項目と期待結果
更新、公開、切り戻しの手順
AIへ伝える制約事項と変更禁止箇所
すべてを一つの文書へ詰め込む必要はありません。最初に読む案内を用意し、業務判断、データ定義、操作手順、テスト、変更履歴へ順番にたどれる構成にします。
AIへの引き継ぎ項目を整理したい方へ
自社で何を文書化するか迷ったときは、現場交差点の無料ルームで、AI活用や社内ツールの運用について情報交換できます。
権限、個人情報、障害時の連絡先を確認する
動かし方だけでなく、誰がどの情報へアクセスできるかも引き継ぎ対象です。退職者や外部担当者のアカウント、共有アカウント、不要になった連携先が残っていないかを確認します。AIへ資料を渡す場合も、不要な個人情報や認証情報を含めないようにします。
現場で確認すること
管理者、一般利用者、外部担当者の権限
アカウント追加・停止・変更の手順
認証情報の保管場所と更新担当者
ログ、バックアップ、障害通知の確認方法
不具合発生時の停止判断と社内連絡先
判断する前の注意
個人情報、勤怠、賃金・手当に関するデータの保存方法や閲覧権限は、自社の契約、社内規程、利用サービスの条件を確認してください。判断が難しい場合は、専門家や関係機関へ確認することが必要です。
引き継ぎ完了は、資料を使った再現テストで判断する
資料を渡しただけでは、引き継ぎ完了とはいえません。作成者以外の担当者が別のAIを使い、資料だけを手掛かりにテスト環境を動かします。質問が集中した箇所は、口頭で補うのではなく文書へ戻して更新します。
現場で確認すること
システムの目的と重要な判断を説明できる
テスト環境を起動し、停止できる
通常ケースと例外ケースを確認できる
修正時に影響する機能やデータを特定できる
変更履歴、確認者、公開日を記録できる
運用開始後も、入力方法、計算条件、権限、外部サービスを変えたときは、コードと同時に引き継ぎ資料を更新します。業務判断の記録まで保守対象にすることで、次のAIや担当者が同じ確認を繰り返す負担を減らせます。
読み終えたら、今日やること
自社の現状を一つだけ確認する
「AIで作った社内システムを別のAIに引き継ぐとき、何を残すべきか」について、自社ではどうなっているかを書き出してください。決まっていない点や判断できない点が見つかったら、同業者や専門家へ確認する材料になります。
本記事は、現場での経験や公開時点で確認できた情報をもとに整理しています。契約・法令・制度・金額などは会社や時期によって条件が異なるため、実際に判断するときは公式情報や専門家へご自身で確認してください。
