sandeco/reversa

何を解決するか

Reversaは、レガシーソフトウェアシステムにおける「閉じ込められた知識」の問題を解決します。既存のコードを実行可能で追跡可能な仕様（運用契約）に変換することで、AIコーディングエージェントが重要な未文書化のビジネスルールやアーキテクチャ的決定を破壊することを防ぎます。エージェントは安全にシステムを進化させることができます。

仕組み

Reversaはレガシープロジェクト内にフレームワークとしてインストールされます。専門的なAIエージェントチームを調整し、コードベースを分析して仕様を生成します。このプロセスは複数の明確なパイプラインに従います：

• 発見パイプライン： 5段階のシーケンス（偵察、発掘、解釈、生成、レビュー）で、システムのマッピング、モジュールの分析、ビジネスルールの抽出、アーキテクチャの合成、仕様の作成を行います。
• フォワードサイクル： これらの仕様をもとに、要件定義、計画、監査の順序でシステムを実行可能なコードへ進化させるブリッジです。
• 移行パイプライン： レガシー仕様を現代的なテクノロジースタック用の再構築計画に変換します。
• グリーンフィールドパイプライン： 新規プロジェクト向けに、単なるアイデアから完全なソフトウェア設計書（SDD）仕様へ移行します。

すべてのエージェントは厳格な不変性ルールに従います：既存のプロジェクトファイルを変更または削除せず、出力は特定のフォルダ（.reversa/ および _reversa_sdd/）にのみ書き込まれます。

対象ユーザー

未文書化のロジックのリグレッションをリスクとして抱えながら、AIエージェントを使ってレガシーシステムの保守、進化、移行を進めたいソフトウェアエンジニアおよびアーキテクト向けです。

特徴

• 破壊的でない分析： 原本のソースコードが絶対に変更されないことが保証されます。
• マルチエージェントのオーケストレーション： 発見、アイデア出し、バグ追跡、移行に特化したチームを活用します。
• 因果的トレーサビリティ： デフォルトや変更が元の仕様にどのように関連しているかを追跡できます。
• 運用契約： 人間向けのドキュメントではなく、AIエージェント専用に設計された仕様を生成します。
• 静的ドキュメントサイト： 抽出された知識を3Dアーキテクチャマップや定量的メトリクスを含む自己完結型のHTMLミニサイトにレンダリングできます。