23
// 概要
Reversa は、専門的な AI エージェントを連携させてレガシーコードベースを分析し、包括的で追跡可能な技術仕様書を生成するフレームワークです。既存のシステムと最新のコーディングエージェントの橋渡し役として機能し、安全で情報に基づいた開発を保証する運用コントラクトを作成します。本ツールは厳格な不変性保証のもとで動作し、分析プロセス中に既存のプロジェクトファイルが変更または削除されることは一切ありません。
// 技術解説
Reversa は、レガシーコードベースを AI エージェント向けの構造化された実行可能な仕様へと変換するために設計された、仕様リバースエンジニアリングフレームワークです。5 つのフェーズからなるパイプラインを通じて専門エージェントチームを編成し、ドキュメント化されていないコード内に埋もれている暗黙のビジネスルール、アーキテクチャ上の決定事項、および技術的な契約を抽出します。このアプローチは、AI エージェントにレガシーシステムを安全に進化させるために必要な運用コンテキストを提供することで、「vibe coding」の問題を解決し、既存のロジックを破壊するリスクを回避します。
// 主要ハイライト
01
Scout、Archaeologist、Architect などの役割を含むマルチエージェントパイプラインを編成し、包括的なコード分析を実行します。
02
C4 diagrams、ERDs、state machines、API specifications を含む、多岐にわたる技術ドキュメントを生成します。
03
AI が生成したすべての出力を専用フォルダーに制限することでプロジェクトの不変性を確保し、元のレガシーソースコードには一切手を加えません。
04
Confirmed、Inferred、Gap という信頼性スケールを実装し、検証済みのコードロジックと人間の確認が必要な領域をユーザーが区別できるようにします。
05
Claude Code、Cursor、Aider、GitHub Copilot を含む幅広い AI エンジンやコーディングアシスタントをサポートしており、外部の API keys は不要です。
06
永続的な状態管理を提供し、分析セッションを中断しても進行状況を失うことなく再開できます。
// ユースケース
01
レガシーコードを AI エージェント向けの実行可能な仕様書へリバースエンジニアリング
02
ビジネスルール、アーキテクチャ上の決定事項、データ構造の自動抽出
03
C4 ダイアグラム、ERD、API コントラクトを含む追跡可能なドキュメントの生成
// クイックスタート
開始するには、レガシープロジェクトのルートで 'npx reversa install' を実行し、AI 環境を検出して必要なエージェントスキルをセットアップします。インストールが完了したら、好みの AI エージェントでプロジェクトを開き、'/reversa' または 'reversa' と入力して分析をトリガーします。フレームワークが探索計画を作成し、'_reversa_sdd/' ディレクトリ内にドキュメントの生成を開始します。