引継ぎ資料を新しく作らない。導入時の記録を、AIが読める形で残す
引継ぎ資料は、導入の終わりに急いで作られ、決定の経緯が抜けます。この記事では、導入時の記録をそのまま残し、保守で使う方法を書きます。
この記事の要点
- 引継ぎ資料は、導入の終わりに急いで作られます。要約する間に、「なぜこの設計にしたか」という経緯が抜けます。
- 引継ぎ資料を新しく作る代わりに、設計書・テストの記録・会議の決定を、AIが読める形でそのまま残します。
- 保守では、AIが記録を検索して、回答の下書きを作ります。改修で直す資料の一覧も作ります。判断と対応は、保守の担当者が行います。
稼働から1年後、業務の担当者から問い合わせが来ました。「この得意先だけ、請求書の締め日が違うのはなぜですか」。保守の担当者は、引継ぎ資料を読みましたが、理由は書かれていませんでした。
理由は、導入時の会議の記録に書かれていました。しかし、その記録は引継ぎの対象ではありませんでした。保守の担当者は、導入時の担当者を探して質問し、回答までに1週間かかりました。
原因は、引継ぎ資料を作るときに、決定の経緯を省いたことです。この記事では、導入時の記録を残す形と、保守での使い方を書きます。
01引継ぎ資料は、要約する間に経緯が抜ける
引継ぎ資料は、導入の最後の1か月で作られます。担当者は、稼働の準備と並行して、設計書や会議の記録を要約します。時間が足りないので、要約に残るのは「何を作ったか」だけです。
導入時の記録
引継ぎ資料
「なぜ、そう決めたか」と「何を、なぜやめたか」は、書かれていない
朱の枠の2つが、要約する間に省かれる記録です。保守で質問が多いのは、この2つです。
保守の担当者が知りたいのは、「何を作ったか」ではありません。「なぜ、そう作ったか」です。
「何を作ったか」は、システムを調べれば分かります。「なぜ」は、記録にしか残っていません。02経緯が分からないと、保守の調査は導入時の担当者に頼ることになる
経緯が分からない場合、保守の担当者は2つの方法しか選べません。1つ目は、導入時の担当者に質問することです。担当者が別のプロジェクトに移っていると、回答に日数がかかります。退職している場合は、質問できません。
2つ目は、理由が分からないまま改修することです。この方法では、導入時に検討して採用しなかった案を、もう一度作ることがあります。採用しなかった理由が、記録に残っていないからです。
03記録は、AIが読める3つの条件を満たす形で残す
引継ぎ資料を新しく作る必要はありません。導入時の記録を、そのまま残します。ただし、残すだけでは、保守の担当者は目的の記載を見つけられません。AIが検索できるように、次の3つの条件を満たします。
文字として読める
図や表が画像として貼られていない。会議は、録音だけでなく文字の記録がある。
画像の中の文字は、検索できない番号で結び付いている
設計書・テストの記録・会議の決定に、同じ要件の番号や手順の番号が書かれている。
番号が無いと、関係する記録を集められない保存する場所が決まっている
種類ごとに、保存するフォルダと、ファイルの名前のルールが決まっている。
個人のパソコンにある記録は、残らない3つの条件は、稼働の直前に満たそうとしても間に合いません。設計が始まる前に決めます。
2つ目の条件は、要件定義の間に番号を付けていれば満たせます。番号の付け方は、業務フローの手順に番号を付ける記事に書きました。この記事では、残した記録の使い方を書きます。
04残す記録は、設計書・テストの記録・会議の決定・手順の一覧表の4種類
| 記録 | 書かれていること | 保守での使い道 |
|---|---|---|
| 設計書 | 機能が、何をどう処理するか | 改修で直す箇所を特定する |
| テストの記録 | どの条件で、どの結果になったか | 改修のあとに、同じ条件で確認する |
| 会議の決定 | なぜ、その設計にしたか | 問い合わせに、理由を付けて回答する |
| 業務フローと手順の一覧表 | どの業務の手順で、どの機能を使うか | 業務の変更が、どの機能に影響するかを調べる |
4種類のうち、残されないことが多いのは会議の決定です。会議の記録は、導入の間は連絡のために使われます。システムが稼働すると、会議の記録を管理する担当者がいなくなります。会議の決定には、決めた日・決めた人・関係する要件の番号を付けます。決定は、設計書と同じ場所に保存します。
すべての資料を残そうとすると、古い版と新しい版が混ざります。AIは、古い版の記載を根拠にして回答することがあります。残すのは、最後に承認された版だけにしてください。古い版は別のフォルダに移し、AIが読む対象から外します。
05記録があれば、問い合わせへの回答と改修の調査を、記録の検索から始められる
「この得意先だけ、請求書の締め日が違うのはなぜですか」業務の担当者
回答の下書き
契約で締め日を月末以外に決めている得意先があり、得意先マスタの設定で分けています。
保守の担当者が、根拠の記録を読んでから回答する
番号と日付は説明のための例です。AIは、回答の下書きに、根拠にした記録を必ず添えます。
- 保守の担当者が、問い合わせの内容を AI に伝える業務の担当者の質問を、そのまま入力します。
- AIが、関係する記録を検索するAIは、設計書・会議の決定・テストの記録から、質問に関係する記載を集めます。
- AIが、回答の下書きと根拠を作るAIは、下書きに、根拠にした記録の名前と該当する箇所を添えます。
- 保守の担当者が、根拠を読んで回答する担当者は、根拠の記載が質問に合っているかを確認します。合っていない場合は、下書きを使いません。
改修の調査でも、問い合わせへの回答と同じ手順を使います。保守の担当者が変更したい内容を伝えると、AIは、直す設計書・プログラム・テストの一覧を作ります。担当者は、一覧を読んで、改修の範囲を決めます。
記録は、判断の材料です。判断と対応は、保守の担当者が行います。
記録があっても、保守に必要な人数が減るとは限りません。減るのは、資料を探す時間と、導入時の担当者を待つ時間です。06稼働後の問い合わせと改修も、同じ場所に記録する
導入時の記録は、稼働した日から古くなります。稼働後の改修で、設計が変わるからです。保守の担当者は、問い合わせの回答と、改修の内容を、導入時の記録と同じ場所に追加します。
導入時
設計書・テストの記録・会議の決定稼働後 半年
設計書・テストの記録・会議の決定問い合わせと回答稼働後 1年
設計書・テストの記録・会議の決定問い合わせと回答改修の内容と理由朱の部分が、稼働後に追加する記録です。追加しないと、AIは改修の前の設計書を根拠にして回答します。
改修したのに設計書を直さないと、記録とシステムの動作が食い違います。AIの下書きも誤ります。改修の完了の条件に、設計書の更新を含めてください。設計書を直す担当と、直したことを確認する担当を、保守の体制の中で決めます。
07明日は、過去の問い合わせ3件で、記録を探せるかを試す
- 過去の問い合わせから、「なぜ、こうなっているのか」と質問された3件を選ぶ。
- 3件それぞれについて、理由が書かれた記録を探す。探すのにかかった時間を記録する。
- 記録が見つからなかった問い合わせについて、理由を知っている人が、いま誰かを書き出す。
3件のうち2件以上で記録が見つからなかった場合、経緯は人の記憶にしか残っていません。その人が担当を離れる前に、会議の決定を集めて保存してください。
導入の途中のプロジェクトでは、PM が、設計が始まる前に記録の残し方を決めます。決める内容は、図2の3つの条件です。稼働の直前に引継ぎ資料を作る作業が、不要になります。