目次
「仕様書はどこにありますか?」。システムリニューアルや保守の引き継ぎで、この質問に答えられない企業は少なくない。IPAの調査では、レガシーシステム刷新の障壁として「ドキュメントの不備」が上位に挙がり続けている(出典:IPA「DX動向2024」)。
仕様書がなければ、改修の影響範囲がわからない。ベンダーに見積もりを依頼しても、正確な回答は返ってこない。結果として、塩漬けのまま放置される。この悪循環を断ち切る手段として注目されているのが「AIリバースドキュメンテーション」だ。本記事では、ソースコードから仕様書を自動復元する手法と、従来の手作業との違いを整理する。
リバースドキュメンテーションとは何か
リバースドキュメンテーションとは、既存のソースコードを解析して仕様書や設計書を逆引きで作成する手法だ。通常のシステム開発では「仕様書 → 設計書 → コード」の順に成果物が作られる。リバースドキュメンテーションはこの流れを逆転させ、「コード → 設計書 → 仕様書」の順に復元する。
従来、この作業はエンジニアがソースコードを一行ずつ読み解く手作業で行われていた。数万行のコードベースであれば、数人月の工数がかかることも珍しくない。ブラックボックス化したシステムの解消方法でも触れたとおり、担当者が退職済みの場合、コードの意図を推測するところから始めなければならない。
従来の手作業による仕様書復元の限界
手作業によるリバースドキュメンテーションには、3つの構造的な問題がある。
工数と費用が読めない
ソースコードの規模や複雑度によって、必要な工数は大きく変動する。10万行のコードであれば、経験豊富なエンジニアでも数か月単位の作業になる。しかも、着手前に正確な見積もりを出すこと自体が困難だ。コードを読み始めてから「想定以上に複雑だった」と判明するケースが多い。
属人性が高い
コードの意図を読み取るには、使用言語・フレームワーク・業務知識のすべてに精通したエンジニアが必要だ。該当するスキルを持つ人材は限られており、外注先の確保も容易ではない。
成果物の粒度がばらつく
担当者によって、復元される仕様書の記述レベルが異なる。ある箇所は詳細に記載され、別の箇所は概要だけ。結果として、ドキュメント全体の品質にムラが生じる。
AIリバースドキュメンテーションの仕組み
AIを活用したリバースドキュメンテーションでは、大規模言語モデル(LLM)がソースコードを構文解析し、処理内容を自然言語で要約する。2026年3月時点で、複数のAIエージェントを連携させるマルチエージェント構成が主流になりつつある。
具体的な処理フローは以下のとおりだ。
| ステップ | 処理内容 | 出力 |
|---|---|---|
| 1. 静的解析 | ファイル構造・依存関係・呼び出し関係を機械的に抽出 | モジュール依存グラフ |
| 2. コード要約 | 各関数・クラスの処理内容をLLMが自然言語で記述 | 機能一覧・処理概要 |
| 3. フロー生成 | データの流れや画面遷移をフローチャートとして再構成 | 処理フロー図 |
| 4. 仕様復元 | 業務ロジックを推定し、入出力仕様・条件分岐を文書化 | 仕様書ドラフト |
このプロセスの利点は、コードベース全体を均一な粒度で処理できる点にある。手作業のように「担当者が詳しい箇所だけ充実する」という偏りが生じにくい。
手作業とAI解析の工数比較
仕様書が存在しない中規模システム(コード行数5万〜10万行)を対象に、手作業とAI解析の工数を比較する。
| 項目 | 手作業 | AI解析 |
|---|---|---|
| 所要期間 | 2〜6か月 | 1〜2週間 |
| 必要人員 | シニアエンジニア2〜3名 | AI+レビュー担当1名 |
| 概算費用 | 300万〜1,000万円 | 30万〜80万円 |
| 成果物の均一性 | 担当者に依存 | 一定の粒度を維持 |
| 業務知識の反映 | 高い(人間の判断) | 補完が必要な場合あり |
AI解析は速度とコストで圧倒的な優位性がある。一方、業務固有のドメイン知識(例:特定業界の商慣習や規制要件)はコードだけからは読み取れない場合がある。AI解析の結果を叩き台にして、業務担当者がレビュー・補完する運用が現実的だ。
1週間でレポート納品。SysDockの詳細を見る。 SysDockはAIマルチエージェントがソースコードを構造解析し、Word・PowerPoint・React Flowフロー図の3点セットで納品する。ソースコード非送信・完全後払い。仕様書がないシステムの現状把握に活用できる。
SysDockの詳細はこちら → genbacompass.com/products/sysdock
SysDockの解析レポートがリバースドキュメンテーションの代替となる理由
SysDockが納品する解析レポートは、リバースドキュメンテーションの成果物として直接活用できる。その理由は3つある。
非エンジニアが読める形式で出力される
従来のリバースエンジニアリングで作成される設計書は、エンジニア向けの技術文書だ。情シス担当者や経営層が読んでも、判断材料にならないことが多い。SysDockのレポートは、非エンジニア向けの活用ガイドにあるとおり、PowerPointによるサマリーとWordによる詳細説明の二層構成で、読者のITリテラシーに応じた使い分けが可能だ。
フロー図でシステム構造を視覚化できる
React Flowによるインタラクティブなフロー図は、モジュール間の依存関係や処理の流れを視覚的に把握できる。紙の仕様書では表現しにくい「全体像と詳細の行き来」が、クリック操作で実現する。
ソースコードを外部に送信しない
セキュリティ上の理由からソースコードを社外に出せない企業は多い。SysDockはローカル環境で解析を実行するため、ソースコードがクラウドや外部サーバーに送信されることがない。この点は、外注ベンダーにコードを共有して手作業で仕様書を作成してもらうアプローチと比較した場合の大きな差別化要因だ。
リバースドキュメンテーションの活用シーン
仕様書の自動復元が特に有効な場面を整理する。
システムリニューアルの事前調査。刷新対象のシステムの現状を正確に把握しないまま要件定義に入ると、後工程で手戻りが発生する。解析レポートをベンダーへの提案依頼書(RFP)に添付すれば、見積もり精度が向上する。
保守担当者の引き継ぎ。前任者が退職し、ドキュメントもない状態での引き継ぎは困難を極める。解析レポートがあれば、後任者がシステムの全体像を短期間で把握できる。
IT監査・内部統制への対応。上場準備やIT全般統制(ITGC)の整備では、システムの仕様が文書化されていることが求められる。解析レポートを起点に、監査対応用のドキュメントを整備する運用が可能だ。
まとめ
仕様書がないシステムは、放置するほどリスクが蓄積する。AIリバースドキュメンテーションは、従来数か月かかっていた仕様書復元を数週間以内に圧縮する手段だ。完璧な仕様書を一発で完成させるものではないが、判断の土台となるドキュメントを短期間で手に入れられる価値は大きい。
まずは現状のシステムがどの程度ブラックボックス化しているかを把握することが第一歩だ。SysDockの解析レポートは、その第一歩を低コスト・短期間で実現する選択肢となる。
1週間でレポート納品。SysDockの詳細を見る。 仕様書がないシステムの構造を、AIマルチエージェントが1週間で可視化。ライト:30万円/スタンダード:50万円/プレミアム:80万円。ソースコード非送信・完全後払い。
SysDockの詳細はこちら → genbacompass.com/products/sysdock
現場改善に役立つ関連アプリ
| ツール名 | 概要 | こんな課題に |
|---|---|---|
| SysDock | AIマルチエージェントによるレガシーシステム構造解析。Word・PPT・フロー図で納品 | 仕様書がないシステムの現状を短期間で把握したい |
| 技術伝承AI | ベテランの暗黙知をAIで形式知化し、ナレッジとして蓄積・共有 | 退職者のシステム知識を組織に残したい |
| WhyTrace | 5Why分析をAIが支援し、問題の根本原因を体系的に究明 | システム障害の原因を仕様書なしで特定したい |
| IdeaLoop | 現場からの改善提案を収集・管理し、実行までを一元化 | システム改善の要望を情シス部門で一元管理したい |
参考文献・出典
- IPA「DX動向2024」 https://www.ipa.go.jp/digital/chousa/dx-trend/dx-trend-2024.html
- 経済産業省「レガシーシステムモダン化委員会総括レポート」(2025年5月) https://www.ipa.go.jp/disc/committee/begoj90000002xuk-att/legacy-system-modernization-committee-20250528-report-presentation.pdf
- SHIFT「AIドキュメントリバースサービス」 https://service.shiftinc.jp/service/ai-reverse-engineering/
- Jitera「ソースコードから設計書を自動生成」 https://prtimes.jp/main/html/rd/p/000000020.000110428.html
関連記事(姉妹サービス)