Reversa: A Reverse Documentation Engineering Framework for Converting Legacy Software into Operational Specifications for AI Agents

あなたが、何千冊もの手書きの書籍で満たされた古びた埃っぽい図書館を持っていると想像してください。これらの書籍には銀行を運営するための規則が記載されていますが、それらはもはや誰も話さない言語（COBOL など）で書かれており、インクは褪せ、目次や索引も存在しません。元の著者たちはすでに長らく去っており、これらを読み解けるのは、引退間際のごく少数の高齢の司書だけです。

さて、銀行を新しいコンピュータ上で稼働させるために、これらの規則を現代的な言語（Go など）に書き換えるよう、超賢く高速なロボットチーム（AI エージェント）を雇用したいと想像してください。問題は何でしょうか？単にロボットに「これを直せ」と指示するだけでは、彼らが誤って推測する可能性があります。ある規則が実際には別の意味を持つにもかかわらず、彼らがそれを一つの意味だと誤解すれば、銀行はクラッシュするかもしれません。

この論文は、まさにこの問題を解決するために設計された新しいフレームワーク「Reversa」を紹介しています。Reversa をコードを瞬時に翻訳する魔法の杖ではなく、専門的な「逆方向ドキュメント化」工場として考えてください。

以下に、簡単な比喩を用いてその仕組みを説明します。

1. 問題：「沈黙する」レガシーシステム

古いソフトウェアシステムは、20 年前に所有者が去った家のようなものです。電気は点き、冷蔵庫は唸りを上げていますが、なぜキッチンの電気が玄関のドアに配線されているのか、あるいは洗濯機が稼働中にオーブンをオンにするとどうなるのか、誰も知りません。規則は壁の中（コード）に隠されています。これらの隠された規則を知らずに改装を試みれば、誤って地域全体の電力を遮断してしまうかもしれません。

2. 解決策：専門的なロボット探偵チーム

一つのロボットに家全体を読み、規則を推測させるのではなく、Reversa は特定の役割を持つ専門のエージェントチームを、生産ラインのように投入します。

• スカウト（偵察員）： まず家の中を歩き回ります。「はい、部屋が 5 つ、地下室があり、キッチンに奇妙な扉がありますね。」（プロジェクトの表面をマッピング）
• 考古学者： 壁を掘り起こします。「ここに青図が見つかりました。この配管があのバルブに接続されていると書かれています。」（モジュールを分析）
• 探偵： 手がかりを探します。「なぜ電気がドアに配線されているのでしょう？ああ、メモにはセキュリティ機能だと書かれていますね。」（隠されたビジネスルールを抽出）
• 建築家： 発見されたものに基づいて新しい地図を描きます。「つまり、キッチンは家の心臓部であり、地下室は水を保持しています。」（アーキテクチャを統合）
• ライター： 規則を明確に書き留めます。「規則 #1：ドアが開くと、電気が点灯する。」（仕様書を作成）
• レビューア： 最も重要な役割です。ライターの作業をチェックします。「待ってください、電気の件に関するメモは見つかりましたか？いいえ？では確実には言えません。これを**『おそらく』、あるいは『人間が確認する必要がある』**とマークしましょう。」（信頼性とギャップを検証）

3. 秘密の武器：「信頼性」と「ギャップ」

ほとんどの AI ツールは、推測している場合でも 100% 確実であるかのように振る舞おうとします。Reversa は異なります。見つけたすべての規則に対して信号機システムを使用します。

• 🟢 緑（確認済み）： コード内でこれが見つかりました。事実です。
• 🟡 黄（推測）： 直接的なメモは見つかりませんでしたが、パターンからこれが示唆されます。賢い推測ですが、注意してください。
• 🔴 赤（ギャップ）： 見当もつきません。コードにこの情報が欠落しています。停止！ 人間がここに来て、何をすべきか教えてくれる必要があります。

これは極めて重要です。これにより、ロボットが自信を持って誤りを犯すのを防ぎます。人間に対して、「規則の 97% は把握していますが、残りの 3% ではあなたの助けが必要です」と伝えるのです。

4. 結果：ロボットのための「契約」

出力は、人間が読むための退屈なマニュアルではありません。それは AI エージェントのための運用契約です。以下を伝えます。

• 「システムが何を行うか」
• 「証拠（古いコードのどのファイルで見つけたか）」
• 「まだわからないこと」

これにより、AI エージェントは明確な地図を持ち、「戦場の霧」がどこにあるかを正確に知っているため、古いシステム（COBOL から Go への移行）を安全に書き換えることができます。

5. 実世界でのテスト：ATM 機械

著者らは、この手法を実際の（しかし単純な）プロジェクトでテストしました。COBOL で書かれた古い ATM 機械を Go で再構築する必要があるものです。

• プロセス： Reversa パイプラインを実行しました。
• 出力： システムは 517 の「主張（規則）」を生成しました。そのうち 490 を事実、24 を推測としてマークし、3 つの欠落部分（ギャップ）を発見しました。
• 人間の役割： 人間が欠落部分と「推測」を解決するために介入しました。
• 結果： ATM の再構築計画を作成し、53 のテストシナリオ（例：「20 ドルを入金すれば、20 ドルが返ってくるはずだ」など）を記述しました。再構築を正常に開始し、11 の主要タスクのうち 9 つを完了しました。

この論文が主張していないこと

この論文が何と言っていないかを知ることが重要です。

• これは完璧であり、世界中のあらゆる古いシステムに即座に機能すると主張していません。
• ロボットが人間なしで全作業を完了できると主張していません。人間は依然として「赤」のギャップを修正するために必要です。
• 現時点では、従来の方法よりも速く、安価であると主張していません。彼らが証明したのは、それが可能であり、より安全で組織化されたプロセスを生み出すという点だけです。

まとめ

Reversa は、古いソフトウェアを犯罪現場のように扱うフレームワークです。AI 探偵チームを用いて、システムが何を行うかを慎重にマッピングし、何が確実で何が推測かを明示的にマークします。これにより、ロボットが古いシステムを壊すことなく更新または書き換えられる安全な「取扱説明書」が作成され、ロボットでは解決できない謎を解くために人間をループ内に留めることができます。