【重要】SysDock は 2026年12月31日(木)をもってサービスを終了します

GenbaCompassの他サービスに開発・運用のリソースを集中するため、提供を終了することといたしました。新規登録の受け付けは終了しました。登録済みのデータはサービス終了後に削除されます。これまでのご利用、誠にありがとうございました。

中身がわからないシステムの解消法3選|仕様書なしでも対処可能

仕様書がない、開発者は退職済み、コードが読めない——そんな「中身が見えない」システムを解消する3つの手法を比較し、自社の状況に合った選択肢を提示する。

目次

「このシステム、誰も中身がわからない」。情シス部門でこの言葉が出たとき、問題はすでに深刻な段階に入っている。仕様書は存在しない。開発を担当したエンジニアはとうに退職した。ソースコードを開いても、何をしているのか読み取れない。

経済産業省が2025年5月に公表した「レガシーシステムモダン化委員会総括レポート」によると、調査対象のユーザー企業の61%にレガシーシステムが残存している(出典:経済産業省「レガシーシステムモダン化委員会総括レポート」2025年5月)。そして、刷新を阻む主要因のひとつが「ブラックボックス化」だ。

本記事では、ブラックボックス化したシステムを解消するための3つの手法を比較し、自社の状況に応じた選択指針を提示する。

レガシーシステムがブラックボックス化する3つの原因

解消策を検討する前に、なぜブラックボックス化が起こるのかを整理しておきたい。原因を正しく把握しないと、対策がずれる。

原因1:仕様書が存在しない、または実態と乖離している

設計書や仕様書が最初から作られなかった。あるいは、改修を重ねるうちに更新されなくなった。どちらのケースでも、結果は同じだ。ドキュメントだけでは現行システムの動作を正確に把握できない。

IPAの「DX動向2024」でも、レガシーシステム刷新の障壁として「十分な要員を割けない」(39.9%)が最多であり、ドキュメント整備まで手が回っていない実態が浮かび上がる(出典:IPA「DX動向2024」)。

原因2:開発担当者の退職・異動

特定のエンジニアだけがシステムの仕組みを理解している「属人化」の状態が続き、その人が退職した瞬間に知識が消失する。引き継ぎが行われたとしても、口頭での説明だけでは暗黙知の大半が伝わらない。

原因3:長年の改修による複雑化

10年、20年と改修を繰り返すうちに、コードは「継ぎ接ぎ」状態になる。元の設計思想が崩れ、条件分岐が入り組み、どの処理がどの業務に対応するのかが見えなくなる。COBOL、VB6、古いPHPなど、技術者の確保自体が難しい言語で書かれているケースも多い。

これら3つの原因は、多くの場合複合的に発生する。仕様書がなく、作った人もおらず、コードも読めない。この三重苦が「ブラックボックス」の正体だ。

ブラックボックス化が経営にもたらすリスク

ブラックボックスの問題は技術的な課題にとどまらない。経営に直結するリスクを4つ挙げる。

リスク1:改修コストの膨張

影響範囲が読めないため、小さな改修にも過大な工数がかかる。「念のため」全体をテストする必要が生じ、見積もりが膨らむ。ベンダーから提示される金額に妥当性を判断する術もない。

リスク2:障害対応の長期化

障害が発生しても、原因の切り分けに時間がかかる。処理の流れが把握できていないため、ログを追うにも勘に頼るしかない。復旧までの時間が長引き、業務停止のリスクが増大する。

リスク3:システム刷新の停滞

新システムへの移行を計画しても、現行の業務ロジックが正確にわからない。要件定義が進まず、プロジェクトが頓挫する。経済産業省のDXレポートが警鐘を鳴らした「2025年の崖」の核心は、このブラックボックス問題にある(出典:経済産業省「DXレポート」2018年9月)。

リスク4:セキュリティ脆弱性の放置

中身がわからないシステムでは、脆弱性の有無すら確認できない。古いライブラリやフレームワークが放置され、サイバー攻撃の標的になりかねない。


「うちのシステム、中身が誰にもわからない」。その状態を放置するリスクは大きい。

SysDockは、AIマルチエージェントがソースコードからシステム構造を自動解析し、Word・PPT・React Flowフロー図の3点セットで1週間納品する。ソースコード非送信・完全後払いで、安心して依頼できる。

まずは無料ヒアリングで現状を把握


ブラックボックスを解消する3つの手法

ブラックボックス化したシステムの中身を「見える化」する手法は、大きく3つに分けられる。それぞれの特徴、適用条件、メリット・デメリットを整理する。

手法1:手動リバースエンジニアリング

エンジニアが実際にソースコードを読み、処理の流れを追いかけながら仕様を復元する方法だ。最も古典的なアプローチである。

具体的な進め方は以下のとおりだ。

  1. ソースコードの主要なエントリーポイントを特定する
  2. 処理フローを手作業でトレースする
  3. データベースのテーブル定義と結合関係を調査する
  4. 復元した仕様を設計書として文書化する

メリット: 正確性が高い。業務知識を持つ担当者と連携すれば、コードの意図まで復元できる。ツール導入の初期費用が不要。

デメリット: 膨大な時間と工数がかかる。対象言語を読めるエンジニアの確保が必要。COBOLやVB6など、読める人材自体が減少している言語では実施が困難。

適するケース: 対象システムの規模が小さい場合。対象言語に精通したエンジニアが社内にいる場合。

手法2:AI解析による自動可視化

生成AIや静的解析技術を活用し、ソースコードからシステム構造を自動的に抽出・可視化する方法だ。近年、急速に実用化が進んでいる。

AIによる解析の主な機能は以下の通りである。

  • モジュール間の依存関係を自動マッピングする
  • データフローを可視化する
  • 処理ロジックを自然言語で要約する
  • フローチャートやアーキテクチャ図を自動生成する

メリット: 人手と比較して圧倒的に高速。数万行規模のコードベースでも、数日で構造の全体像を把握できる。対象言語の専門家がいなくても実施可能。非エンジニアにも理解しやすいアウトプットを生成できる。

デメリット: AIの解析精度は100%ではない。業務上の「なぜそうなっているか」という背景までは読み取れない場合がある。ツールやサービスの選定が必要。

適するケース: コード量が多く手動では現実的でない場合。対象言語のエンジニアが確保できない場合。短期間で全体像を把握したい場合。

株式会社SHIFTが提供する「Re:structure AI」など、ブラックボックス化したシステムをAIで解析し構造化・ドキュメント化するソリューションも登場している(出典:SHIFT「AIモダナイ解析ツールで挑む"ブラックボックス"解体」)。

手法3:段階的ドキュメント化

一度にすべてを解明しようとせず、業務上の優先度が高い部分から順にドキュメント化していく方法だ。「全部わからない」状態から「重要な部分は把握できている」状態への移行を目指す。

段階的ドキュメント化の進め方は以下のとおりだ。

  1. 対象範囲の優先順位付け: 改修頻度の高い機能、障害リスクの大きい機能を特定する
  2. 動作確認ベースの仕様復元: 実際にシステムを動かしながら入出力を記録し、振る舞いから仕様を逆算する
  3. 業務担当者へのヒアリング: 現場のユーザーが「何をしているか」を知っている場合がある
  4. ドキュメントの段階的蓄積: 改修のたびにドキュメントを追加・更新するルールを設ける

メリット: 初期投資が小さい。業務知識とシステム知識を同時に蓄積できる。改修業務と並行して進められる。

デメリット: 完了までに長期間を要する。優先度の低い部分は放置されがちになる。ドキュメント更新の運用が定着しないと、再びブラックボックス化する。

適するケース: 予算が限られている場合。全面刷新ではなく部分的な改修が中心の場合。時間的な余裕がある場合。

3手法の比較表|自社に合ったレガシーシステムのブラックボックス解消法を選ぶ

3つの手法を一覧で比較する。

項目手動リバースエンジニアリングAI解析段階的ドキュメント化
所要期間数ヶ月〜半年以上1〜2週間半年〜数年
必要な人材対象言語の熟練エンジニアツール導入・運用担当業務知識を持つ担当者
初期コスト人件費(高額になりがち)ツール費用15〜50万円程度低い
正確性高い中〜高(要レビュー)中(対象範囲に依存)
対応可能な規模小〜中規模大規模にも対応可能小〜中規模
非エンジニアへのわかりやすさ低い(技術文書になりがち)高い(図表を自動生成)中(作成者による)
再現性属人的自動化により高い運用定着が前提

実務では、これらの手法を単独で使うよりも組み合わせる方が効果的だ。まずAI解析で全体像を短期間で把握し、重要な部分は手動で深掘りする。その後、段階的ドキュメント化の運用ルールを整備して、知識の蓄積を継続する。この「三段構え」が現実的な進め方である。

ブラックボックス解消の実務ステップ

ここでは、実際にブラックボックス解消プロジェクトを進める際の手順を整理する。

ステップ1:現状の棚卸し

まず、自社のシステム資産を洗い出す。対象は以下の項目だ。

  • 稼働中のシステム一覧と利用部門
  • ソースコードの所在と管理状況
  • 設計書・仕様書の有無と最終更新日
  • 担当者の在籍状況(退職済みかどうか)
  • 利用言語・フレームワーク・ミドルウェア

この棚卸しだけでも、リスクの高い「盲点」が浮かび上がることが多い。

システム資産の棚卸しについては、エンジニア不足時代のシステム管理術の記事で詳しく解説している。

ステップ2:優先度の判定

すべてのシステムを同時に解明する必要はない。以下の基準で優先順位を付ける。

  • 事業への影響度: そのシステムが停止した場合の損害額
  • 改修の頻度: 近い将来、機能追加や改修が予定されているか
  • 技術的リスク: 利用言語やインフラのサポート期限が迫っていないか
  • 人的リスク: 唯一の理解者が退職間近ではないか

これらを掛け合わせて、対応の緊急度を判定する。

ステップ3:手法の選択と実行

ステップ2の結果をもとに、3つの手法から最適なものを選択する。

状況推奨する手法
大規模かつ短期間で全体像を把握したいAI解析
対象が小規模で社内にエンジニアがいる手動リバースエンジニアリング
予算が限られ、長期的に取り組める段階的ドキュメント化
大規模だが精度も必要AI解析+手動の組み合わせ

ステップ4:成果物の活用と維持

解析結果を「作って終わり」にしてはならない。成果物は以下の場面で活用する。

  • 改修時の影響範囲分析: どこを変えると何に影響するかを事前に把握する
  • ベンダーへの発注時の要件定義: 正確な現状把握に基づく見積もり依頼
  • 経営層への報告: フロー図を用いたわかりやすい説明資料
  • 新メンバーのオンボーディング: システム理解の効率化

さらに重要なのは、ドキュメントを「生きた文書」として維持する運用ルールの策定である。改修のたびに更新する。レビューの工程に組み込む。こうした仕組みがなければ、数年後に再びブラックボックスに逆戻りする。

まとめ

ブラックボックス化したレガシーシステムは、放置するほどリスクが膨らむ。本記事のポイントを整理する。

  1. ブラックボックスの原因は「仕様書の不在」「担当者の退職」「コードの複雑化」の三重苦。 これらが複合的に発生することで、誰もシステムの全体像を把握できなくなる。
  1. 経営リスクは深刻だ。 改修コストの膨張、障害対応の長期化、刷新プロジェクトの停滞、セキュリティ脆弱性の放置。いずれもビジネスに直結する問題である。
  1. 解消手法は3つ。 手動リバースエンジニアリング、AI解析、段階的ドキュメント化。自社の規模・予算・期間に応じて選択し、組み合わせて活用するのが現実的だ。
  1. AI解析は時間とコストのバランスが優れている。 大規模システムでも短期間で全体像を把握でき、非エンジニアにもわかりやすいアウトプットを生成できる。
  1. 「作って終わり」にしないこと。 ドキュメントの維持運用まで設計しなければ、再度ブラックボックス化する。

ブラックボックスの解消は、DX推進の出発点でもある。まずは現行システムの「見える化」から始めることで、その先の刷新計画や投資判断の精度が格段に向上する。


レガシーシステムのブラックボックス、まず「見える化」から始めないか。

SysDockは、AIマルチエージェントがソースコードからモジュール構成・依存関係・外部連携を自動解析する。Word・PPT・React Flowフロー図の3点セットで、1週間で納品。30万円から依頼でき、ソースコード非送信・完全後払いだから安心して試せる。

まずは無料ヒアリングで現状を把握


よくある質問(FAQ)

Q. ブラックボックス化したシステムの解析にはどのくらいの期間がかかりますか?

A. 手法と規模による。AI解析であれば1〜2週間で全体像を把握できる。手動リバースエンジニアリングでは、数万行規模のシステムで数ヶ月が目安だ。段階的ドキュメント化は継続的な取り組みになるため、半年〜数年単位で考える必要がある。

Q. 仕様書がまったくない場合でも解析は可能ですか?

A. 可能だ。ソースコードが残っていれば、そこから構造や処理の流れを復元できる。AI解析ツールはソースコードを入力とするため、仕様書の有無に依存しない。ただし、業務上の意図や背景を完全に復元するには、現場担当者へのヒアリングも併用すべきだ。

Q. COBOL・VB6など古い言語のシステムでも対応できますか?

A. 対応可能な手法を選べばよい。AI解析は多くの言語に対応している。手動リバースエンジニアリングの場合は、対象言語を読めるエンジニアの確保が課題になる。COBOLエンジニアの高齢化は進んでおり、早めの着手が望ましい。

Q. 解析結果のドキュメントが再び陳腐化しないようにするには?

A. 運用ルールの策定が不可欠だ。改修時にドキュメント更新を必須工程に組み込む、定期的なレビューを実施する、ドキュメント管理ツールでバージョン管理する。この3点を仕組みとして定着させることが再ブラックボックス化の防止につながる。

現場改善に役立つ関連ツール

GenbaCompassでは、SysDock以外にも現場のDXを支援するツールを提供している。

ツール名概要こんな課題に
技術伝承AIベテランの暗黙知をAIで形式知化し、ナレッジとして蓄積・共有する退職・異動による技術ノウハウの喪失を防ぎたい
WhyTrace5Why分析をAIが支援し、問題の根本原因を体系的に究明するトラブルの再発防止策を確実に導きたい
AnzenAI安全書類の作成をAIで効率化し、現場の安全管理を支援する安全書類の作成工数を削減したい
PlantEar設備の異音をAIが検知し、故障の予兆を早期に発見する設備の突発故障を未然に防ぎたい
IdeaLoop現場からの改善提案を収集・管理し、実行までを一元化する改善提案制度を活性化させたい

関連記事(姉妹サービス)

システム老朽化セルフ診断

6つの質問に答えるだけ。自社システムのリスクを30秒で把握できます。

0 / 6 回答済み
Q1

今のシステムは、いつ頃から使っていますか?

導入時期がわからない場合は「覚えていない」を選んでください

Q2

システムの設計書や仕様書は、今でも使える状態ですか?

紙の資料・Excel・PDFなども含めて

Q3

このシステムの中身を説明できる人は、社内に何人いますか?

ベンダーではなく、自社の社員で

Q4

保守を頼んでいるベンダー(外部業者)との関係はどうですか?

保守契約の有無・担当者の対応なども含めて

Q5

過去1年で、システムに関する困りごとはありましたか?

停止・エラー・使いにくいなど、何でも

Q6

保守・運用にかかる費用は、年々増えていますか?

ライセンス料・保守費・改修費の合計で