
この記事の要約
仕様書がないAI開発のシステムでも、止まると困る一つの業務から、引き継ぎの準備を始められます。実装・画面・業務の三つの根拠で今の動きを確かめます。確かめた内容は「確認した動き」「業務の正解」「差異・未確認」に分け、一業務一枚の仕様メモに残します。
AIに指示しながら作った業務システムに仕様書がなくても、引き継ぎの準備は始められます。全部の機能を一度に書こうとはしません。止まると困る一つの業務を選び、実装・画面・業務の三つの根拠から今の動きを確かめます。確かめた内容は「確認した動き」「業務の正解」「差異・未確認」に分けて、一業務一枚の仕様メモに残します。引き継ぐか、直すか、作り直すかは、そのメモを材料に比べて決めます。
AIの説明は「仮説」として扱う
ここでいう仕様とは、システムが何を受け取り、どう処理し、何を出すかの決まりです。仕様書がないシステムにも、今実際に動いている決まりはあります。この記事では、その決まりを確かめて書き出すことを目指します。
AIによる説明は下書きに使えます。ただし、読ませたコードの範囲が違ったり、後の修正や設定が反映されていなかったりすると、今の動きとずれます。資料をAIや外部へ渡す前に共有範囲と方法を確認し、パスワード・鍵・個人情報はそのまま貼り付けないでください。
GitHub Docsも、AI生成コードを人がテストし、要件や目的と照らし合わせることを説明しています。ここからの仕様メモは、その考え方を参考にした記事独自の整理です。AIの説明を出発点として、実際の根拠を集めます。
止まると困る一つの業務から確かめる

最初から全機能を対象にすると、確認が終わらず、途中で止まりがちです。まずは次のような業務から選びます。止まると日々の業務が回らないもの。お金や在庫の数字に関わるもの。やり方を知っている人が一人しかいないもの。
選んだら、その業務の始まりと終わりを決めます。ここからは、架空の会社の受注管理を例にします。この会社では、注文を受けてから出荷指示を出すまでを、一つの業務として扱うことにしました。入力は注文の内容、処理は受注金額の計算、結果は受注金額と出荷指示です。送料の免除のような例外も、この流れの中で拾います。
今回は対象から外した業務も、一覧に名前を残しておきます。外したことが分かるようにしておけば、確かめていない業務まで確認済みだと思い込むのを防げます。
実装・画面・業務の三つの根拠を見る
今の動きを確かめる手がかりは、主に三つあります。どれか一つだけでは見落としが出やすいので、分担して集めます。
実装:プログラムとデータの流れを追う
実装とは、実際に書かれたプログラムと設定のことです。コードのほか、データをためておくデータベースや、外部のサービスとのつながりも含みます。どの画面の操作がどのデータを書き換えるかを追うと、画面からは見えない計算や条件が分かります。社内にコードを読める人がいなければ、ここは専門家に頼んでかまいません。AIにコードを読ませた結果も、仮説として扱います。
画面:実際に操作して観察する
画面では、入力できる値、表示される内容、エラーが出る条件を確かめます。データを書き換える操作は、本番では行いません。権限と試す範囲を関係者で合意した別の環境で、テスト用のデータを使って行います。別の環境がない場合は、書き換える操作は試さず、見るだけの確認と聞き取りにとどめます。別の環境を用意するかどうかは、技術担当や専門家と決めます。確認のために本番の設定やデータを勝手に変えないことが前提です。見るだけの確認でも、誰のアカウントで、どの版を見たかを記録します。権限によって、見える画面が変わるからです。
業務:担当者の手順を聞き取る
担当者が実際にしている手順を聞き取ります。システムの外での手作業、Excelとの併用、例外のときの扱いは、実装や画面だけでは分かりません。「いつもこうしている」という話と「本来はこうするはず」という話は、分けて書き留めます。
確かめた内容を三つに分けて書く

集めた内容は、次の三つに分けて書きます。
一つ目は「確認した動き」です。実装を読んだ結果、画面で観察した結果、担当者から聞いた内容を、出所が分かる形で残します。条件・対象の版・証拠も添え、聞き取りは担当者の説明として区別します。根拠の数だけで正しさを決めず、裏付けが十分か、業務として正しいかを別に判断します。
二つ目は「業務の正解」です。会社として既に決まっている業務のルールを書きます。決めるのは業務の責任者です。「今後こうしたい」という追加の要望は、ここに混ぜず、別の一覧に分けます。混ぜてしまうと、今のシステムが守るべき決まりと、これから足したいことの区別がつかなくなります。
三つ目は「差異・未確認」です。ここには、根拠どうしが食い違うもの、まだ確かめられていないもの、業務の正解と違って見えるものを書きます。違って見えても、すぐに不具合と決めつけません。業務側の理解が古い場合もあれば、ルールがまだ決まっていない場合もあります。分からないものは、分からないまま「未確認」として残します。
よく出てくるずれには、次のようなものがあります。画面にはあるが、業務では使っていない機能。業務では必要なのにシステムになく、手作業で補っている処理。コードにはあるが、画面からは使えない処理。仕様の確認に修正作業を混ぜず、まず業務への影響と一緒に記録します。漏えいやデータ消失など重大な異常は、メモの完成を待たず、責任者と技術担当へ連絡します。
仕様メモは一業務一枚で残す

仕様メモは、一つの業務につき一枚にまとめます。項目は、業務名、範囲、入力、処理と判断のルール、出力と保存先、使う人、例外、外部とのつながりです。各行には、三つの区分のどれに当たるか、根拠(実装・画面・業務)、確認日、確認した人を書き添えます。
先ほどの架空の会社では、受注金額の計算について、次のようなメモになりました。画面で確かめたところ、受注金額には送料が加算されていました。これが「確認した動き」です。一方、受注の担当者からは、条件によって送料を免除することがあると聞きました。ただ、どんな条件で免除するのかはまだはっきりしません。そのため、業務の正解の欄は「担当者に確認」としました。担当者から免除の条件を聞き取ったうえで、業務の責任者がルールとして決めます。免除の条件は「差異・未確認」として残し、根拠の欄には確認したシステムの版と日時を書きます。
この段階では、送料の加算が誤りだとはまだ言えません。免除の条件が決まって初めて、システムと業務のどちらを合わせるかを考えられます。こうした「まだ言えないこと」を見える形で残すのが、メモの役目です。
変更のたびにメモを直し、次の判断に使う

メモの置き場所と、更新する人を決めておきます。システムを変えたときや、未確認だった点を確かめたときは、そのたびにメモも直します。未確認のまま残す項目には、誰が次に何を確かめるかも書いておきます。古いままのメモには今の動きと違うことが書かれたまま残り、かえって誤解を生むからです。
分担の目安は次のとおりです。業務の責任者は、対象の業務を選び、業務の正解を決めます。社内の開発担当は、画面での確認、聞き取りの記録、AIを使った下調べを受け持ちます。専門家には、実装とデータベースの読み取りや、差異が業務に与える影響の見立てを頼めます。
メモがそろってきたら、保守を引き継ぐか、直すか、作り直すかを比べます。仕様書がないから作り直す、と一律に決める必要はありません。今の姿が分かってから比べたほうが、残せる部分と手を入れる部分を分けやすくなります。なお、メモがあっても、保守を引き受けてもらえるかどうかは、相手が中身を確かめてから決まります。どこまでのメモが必要かは、相談先と決めます。
まとめ
仕様書がないときは、優先する業務から始めます。三つの根拠で確かめ、三つの区分で一枚ずつ残します。メモが途中でも、未確認が多くても、相談は始められます。Ouverの自社開発・AI駆動開発システムの保守運用では、仕様の整理、コード・データベースの点検、ログインと権限の確認、社内開発と保守の分担について相談できます。対応できるかどうかや範囲は、実際の構成を調べてから判断します。下の関連記事では、相談前に整理しておくこと、AIとの修正が終わらないときの立て直し方、保守を引き継ぐときの確認項目を扱っています。
参考資料・確認日
GitHub Docs「Review AI-generated code」(確認日:2026年11月18日)
Ouver「自社開発・AI駆動開発システムの保守運用」(確認日:2026年11月18日)













