引継ぎ資料を新しく作らない。導入時の記録を、AIが読める形で残す

引継ぎ資料は、導入の終わりに急いで作られ、決定の経緯が抜けます。この記事では、導入時の記録をそのまま残し、保守で使う方法を書きます。

この記事の要点

  1. 引継ぎ資料は、導入の終わりに急いで作られます。要約する間に、「なぜこの設計にしたか」という経緯が抜けます。
  2. 引継ぎ資料を新しく作る代わりに、設計書・テストの記録・会議の決定を、AIが読める形でそのまま残します。
  3. 保守では、AIが記録を検索して、回答の下書きを作ります。改修で直す資料の一覧も作ります。判断と対応は、保守の担当者が行います。

稼働から1年後、業務の担当者から問い合わせが来ました。「この得意先だけ、請求書の締め日が違うのはなぜですか」。保守の担当者は、引継ぎ資料を読みましたが、理由は書かれていませんでした。

理由は、導入時の会議の記録に書かれていました。しかし、その記録は引継ぎの対象ではありませんでした。保守の担当者は、導入時の担当者を探して質問し、回答までに1週間かかりました。

原因は、引継ぎ資料を作るときに、決定の経緯を省いたことです。この記事では、導入時の記録を残す形と、保守での使い方を書きます。

01引継ぎ資料は、要約する間に経緯が抜ける

引継ぎ資料は、導入の最後の1か月で作られます。担当者は、稼働の準備と並行して、設計書や会議の記録を要約します。時間が足りないので、要約に残るのは「何を作ったか」だけです。

図 1導入時の記録を引継ぎ資料に要約すると、決定の経緯が残らない

導入時の記録

設計書何を作ったか
テストの記録どう確認したか
会議の決定なぜ、そう決めたか
検討して採用しなかった案何を、なぜやめたか

引継ぎ資料

機能の一覧何を作ったか
運用の手順どう操作するか

「なぜ、そう決めたか」と「何を、なぜやめたか」は、書かれていない

朱の枠の2つが、要約する間に省かれる記録です。保守で質問が多いのは、この2つです。

保守の担当者が知りたいのは、「何を作ったか」ではありません。「なぜ、そう作ったか」です。

「何を作ったか」は、システムを調べれば分かります。「なぜ」は、記録にしか残っていません。

02経緯が分からないと、保守の調査は導入時の担当者に頼ることになる

経緯が分からない場合、保守の担当者は2つの方法しか選べません。1つ目は、導入時の担当者に質問することです。担当者が別のプロジェクトに移っていると、回答に日数がかかります。退職している場合は、質問できません。

2つ目は、理由が分からないまま改修することです。この方法では、導入時に検討して採用しなかった案を、もう一度作ることがあります。採用しなかった理由が、記録に残っていないからです。

03記録は、AIが読める3つの条件を満たす形で残す

引継ぎ資料を新しく作る必要はありません。導入時の記録を、そのまま残します。ただし、残すだけでは、保守の担当者は目的の記載を見つけられません。AIが検索できるように、次の3つの条件を満たします。

図 2AIが読める記録の条件は3つ。文字で読める、番号で結び付いている、保存する場所が決まっている
1

文字として読める

図や表が画像として貼られていない。会議は、録音だけでなく文字の記録がある。

画像の中の文字は、検索できない
2

番号で結び付いている

設計書・テストの記録・会議の決定に、同じ要件の番号や手順の番号が書かれている。

番号が無いと、関係する記録を集められない
3

保存する場所が決まっている

種類ごとに、保存するフォルダと、ファイルの名前のルールが決まっている。

個人のパソコンにある記録は、残らない

3つの条件は、稼働の直前に満たそうとしても間に合いません。設計が始まる前に決めます。

2つ目の条件は、要件定義の間に番号を付けていれば満たせます。番号の付け方は、業務フローの手順に番号を付ける記事に書きました。この記事では、残した記録の使い方を書きます。

04残す記録は、設計書・テストの記録・会議の決定・手順の一覧表の4種類

記録書かれていること保守での使い道
設計書機能が、何をどう処理するか改修で直す箇所を特定する
テストの記録どの条件で、どの結果になったか改修のあとに、同じ条件で確認する
会議の決定なぜ、その設計にしたか問い合わせに、理由を付けて回答する
業務フローと手順の一覧表どの業務の手順で、どの機能を使うか業務の変更が、どの機能に影響するかを調べる

4種類のうち、残されないことが多いのは会議の決定です。会議の記録は、導入の間は連絡のために使われます。システムが稼働すると、会議の記録を管理する担当者がいなくなります。会議の決定には、決めた日・決めた人・関係する要件の番号を付けます。決定は、設計書と同じ場所に保存します。

落とし穴

すべての資料を残そうとすると、古い版と新しい版が混ざります。AIは、古い版の記載を根拠にして回答することがあります。残すのは、最後に承認された版だけにしてください。古い版は別のフォルダに移し、AIが読む対象から外します。

05記録があれば、問い合わせへの回答と改修の調査を、記録の検索から始められる

図 3AIが記録を検索して回答の下書きを作り、保守の担当者が確認して回答する

「この得意先だけ、請求書の締め日が違うのはなぜですか」業務の担当者

AI要件の番号で、設計書・会議の決定・テストの記録を検索する

回答の下書き

契約で締め日を月末以外に決めている得意先があり、得意先マスタの設定で分けています。

会議の決定 9月24日設計書 D-063テスト T-176

保守の担当者が、根拠の記録を読んでから回答する

番号と日付は説明のための例です。AIは、回答の下書きに、根拠にした記録を必ず添えます。

  1. 保守の担当者が、問い合わせの内容を AI に伝える業務の担当者の質問を、そのまま入力します。
  2. AIが、関係する記録を検索するAIは、設計書・会議の決定・テストの記録から、質問に関係する記載を集めます。
  3. AIが、回答の下書きと根拠を作るAIは、下書きに、根拠にした記録の名前と該当する箇所を添えます。
  4. 保守の担当者が、根拠を読んで回答する担当者は、根拠の記載が質問に合っているかを確認します。合っていない場合は、下書きを使いません。

改修の調査でも、問い合わせへの回答と同じ手順を使います。保守の担当者が変更したい内容を伝えると、AIは、直す設計書・プログラム・テストの一覧を作ります。担当者は、一覧を読んで、改修の範囲を決めます。

記録は、判断の材料です。判断と対応は、保守の担当者が行います。

記録があっても、保守に必要な人数が減るとは限りません。減るのは、資料を探す時間と、導入時の担当者を待つ時間です。

06稼働後の問い合わせと改修も、同じ場所に記録する

導入時の記録は、稼働した日から古くなります。稼働後の改修で、設計が変わるからです。保守の担当者は、問い合わせの回答と、改修の内容を、導入時の記録と同じ場所に追加します。

図 4記録は、稼働後も増え続ける。同じ質問には、前回の回答を使える

導入時

設計書・テストの記録・会議の決定

稼働後 半年

設計書・テストの記録・会議の決定問い合わせと回答

稼働後 1年

設計書・テストの記録・会議の決定問い合わせと回答改修の内容と理由

朱の部分が、稼働後に追加する記録です。追加しないと、AIは改修の前の設計書を根拠にして回答します。

落とし穴

改修したのに設計書を直さないと、記録とシステムの動作が食い違います。AIの下書きも誤ります。改修の完了の条件に、設計書の更新を含めてください。設計書を直す担当と、直したことを確認する担当を、保守の体制の中で決めます。

07明日は、過去の問い合わせ3件で、記録を探せるかを試す

半日でできる、3つの確認
  1. 過去の問い合わせから、「なぜ、こうなっているのか」と質問された3件を選ぶ。
  2. 3件それぞれについて、理由が書かれた記録を探す。探すのにかかった時間を記録する。
  3. 記録が見つからなかった問い合わせについて、理由を知っている人が、いま誰かを書き出す。

3件のうち2件以上で記録が見つからなかった場合、経緯は人の記憶にしか残っていません。その人が担当を離れる前に、会議の決定を集めて保存してください。

導入の途中のプロジェクトでは、PM が、設計が始まる前に記録の残し方を決めます。決める内容は、図2の3つの条件です。稼働の直前に引継ぎ資料を作る作業が、不要になります。