sandeco/reversa

何を解決するか

Reversaは、レガシーソフトウェアシステムにおける「閉じ込められた知識」の問題を解決します。生産環境で長年にわたり非文書化されたビジネスルールやアーキテクチャ的決定が蓄積されると、AIコーディングエージェントはシステムの実際の振る舞いを正確に把握できないため、安全に進化させることができません。Reversaは、既存のコードを操作仕様に逆引きすることで、AIエージェントが既存の論理を壊すことなくシステムを進化させるための契約として利用できるようにします。

動作方法

Reversaはレガシープロジェクト内にフレームワークとしてインストールされます。複数段階の「発見（Discovery）」パイプライン（偵察、発掘、解釈、生成、レビュー）を通じて、専門的なAIエージェントチーム（スカウト、アーカイビスト、ディテクティブなど）を調整します。これらのエージェントはコードベースを分析し、ビジネスルールやモジュール契約を抽出し、専用の出力フォルダにトレーサブルな仕様（SDD仕様）を生成します。

これらの仕様が生成されると、フレームワークは異なる目的向けの専用ワークフローを提供します：

• 進化：/reversa-forward パイプラインを通じて仕様から新しいコードへ移行。
• 移行：/reversa-migrate を使って現代的なスタック上で再構築を計画。
• ドキュメント化：/reversa-docs で抽出された知識をHTMLミニサイトとしてレンダリング。
• グリーンフィールド：/reversa-new を使って未完成のアイデアから新しいプロジェクトを開始。

対象ユーザー

ドキュメントが不足している状態でレガシーシステムを維持・進化・移行したいソフトウェアエンジニアやアーキテクト。

特徴

• 破壊的でない分析：フレームワークは既存のプロジェクトファイルを一切変更・削除せず、すべての書き込みは特定の .reversa/ および _reversa_sdd/ フォルダに制限されます。
• エージェントオーケストレーション：ソフトウェアライフサイクルの異なる段階を処理する10種類の専門エージェントチーム（発見、アイデア創出、移行など）を活用。
• 運用契約：人間向けドキュメントではなく、AIエージェント向けに設計された仕様を生成。
• エージェント非依存：APIキーを保存しない。ユーザー環境に既存のAIエージェント（例：Claude Code、Cursor、Codex）の知能を委任。
• 因果トレーサビリティ：バグエージェントを専用に設け、仕様に直接リンクして欠陥を追跡・修正。